딥 링크

딥 링크를 구현하여 웹 오퍼월을 웹사이트나 모바일 앱에 연동합니다.

읽는 시간 4분

최근 업데이트: 8시간 전

직접 링크를 사용하면 웹사이트를 오퍼월에 아주 간단하게 연결할 수 있습니다. 오퍼월을 표시하려는 곳에서 다음 URL을 링크로 제공합니다.


https://rewards.unity.com/owp/web/link/<SDK_KEY>/u/<USER_ID>

필수 파라미터

SDK_KEY - 탭조이에서 제공하는 SDK 키입니다.
USER_ID - 사용자에게 적절한 보상을 제공하려면 직접 사용자 ID를 제공해야 합니다. 자세한 내용은 자체 관리형 재화를 참고하십시오.

참고

이는 URL의 일부로 적용되므로 USER_ID는 URL에 적용해도 안전하거나 URL에서 사용하도록 인코딩되어야 합니다.

파라미터(선택 사항)

사용자 개인정보 보호

사용자 개인정보 보호는 URL에 쿼리 파라미터를 추가하여 구현할 수 있습니다. 각 플래그에 관한 자세한 내용은 사용자 개인정보 보호를 참고하십시오.


https://rewards.unity.com/owp/web/link/<SDK_KEY>/u/<USER_ID>?gdpr=1&cgdpr=1&...

옵션	쿼리 파라미터 이름	기본값	설명
사용자가 GDPR의 적용 대상인지 여부	`gdpr`	`0`	사용자가 GDPR 적용 대상이면 값은 `1` 이어야 합니다.
GDPR 동의	`cgdpr`	`0`	`0` 은 사용자가 동의하지 않는다는 의미이며, `1` 은 사용자가 동의한다는 의미입니다.
동의 연령 미만	`below_consent_age`	`0`	`1` 과 `0` 값은 각각 사용자가 동의 연령 미만인지 여부를 나타냅니다.
미국 개인정보 보호	`us_privacy`	`1---`	값 설명은 사용자 개인정보 보호를 참고하십시오.

이벤트 이름

event_name

파라미터는 웹사이트 또는 모바일 앱에서 어떤 플레이스먼트를 로드할지 선택합니다. 탭조이는 플레이스먼트를 로딩하면 해당 플레이스먼트와 연결된 콘텐츠 카드를 렌더링합니다.

event_name

를 생략하면 탭조이는 기본적으로 표준 오퍼월을 로딩합니다.

중요

event_name

파라미터를 생략하는 경우, URL을 사용하기 전에 탭조이 대시보드에서

#WebOfferwall

플레이스먼트 항목을 생성하고 이를 콘텐츠 카드에 연결해야 합니다. 자세한 내용은 플레이스먼트 기술 자료의 플레이스먼트 생성 섹션과 오퍼월 카드 기술 자료의 오퍼월 생성 섹션을 참고하십시오.

event_name을 사용하여 플레이스먼트를 지정하려면 다음 딥 링크 형식을 사용하십시오.


https://rewards.unity.com/owp/web/link/<SDK_KEY>/u/<USER_ID>?event_name=<PLACEMENT_NAME>

사용자 태그

웹 오퍼월은 사용자 태그가 있는 세그먼트 타게팅을 지원합니다.

user_tags[]=

를 사용하여 여러 사용자 태그를 전달할 수 있습니다.


https://rewards.unity.com/owp/web/link/<SDK_KEY>/u/<USER_ID>?user_tags[]=<TAG1>&user_tags[]=<TAG2>

커스텀 파라미터

cp

를 사용하여 클릭과 전환에 대한 특정 세부 정보를 추적할 수 있도록 사용자 정의 값을 전달할 수 있습니다.


https://rewards.unity.com/owp/web/link/<SDK_KEY>/u/<USER_ID>?cp=xxx

iframe 포함

iframe에 웹 오퍼월을 포함할 때 iframe의 크기가 디바이스 화면 뷰포트를 초과하지 않도록 해야 합니다. 그렇지 않으면 노출되는 뷰포트 범위를 벗어나 명령 CTA 버튼이 나타나고 사용자가 버튼에 액세스하려면 아래로 스크롤해야 합니다.

아이프레임에 내장된 Web Offerwall의 예로, 크기가 너무 큰 iframe이 명령, 명령어 CTA 버튼을 표시되는 뷰포트 밖으로 푸시하는 방법을 보여줍니다.

이 가이드라인을 준수하면 개발자는 웹 오퍼월 제품의 활용성과 사용자 참여를 극대화하여 중요한 UI 요소에 수월하게 액세스하도록 보장할 수 있습니다.

모바일 앱의 웹 오퍼월

WebView에 링크를 로드하여 모바일 앱에서 웹 오퍼월을 사용할 수 있습니다.

예시

Android

웹 오퍼월은 아직 Android 백 버튼을 완전히 처리하지 않으므로 Android 백 버튼을 오버라이드하고 자체 UI를 구현하여 WebView를 닫는 것이 좋습니다. 이렇게 하면 사용자가 의도치 않게 WebView를 닫는 일을 방지하고 대신 OW 내에서 내비게이션 UI를 사용할 수 있습니다.


void showWebOfferwall() {  final WebView webView = new WebView(requireContext());  webView.getSettings().setJavaScriptEnabled(true);  webView.getSettings().setDomStorageEnabled(true);  webView.getSettings().setMediaPlaybackRequiresUserGesture(false);  webView.setBackgroundColor(Color.TRANSPARENT);  webView.loadUrl("https://rewards.unity.com/owp/web/link/sdk_key/u/user_id");  RelativeLayout.LayoutParams paramsWebView = new RelativeLayout.LayoutParams(RelativeLayout.LayoutParams.MATCH_PARENT, RelativeLayout.LayoutParams.MATCH_PARENT);  Dialog dialog = new Dialog(requireContext(), android.R.style.Theme_Black_NoTitleBar_Fullscreen);  dialog.addContentView(webView, paramsWebView);  // Handle backbutton  dialog.setOnKeyListener(new DialogInterface.OnKeyListener() {    @Override    public boolean onKey(DialogInterface dialogInterface, int keyCode, KeyEvent event) {      if (keyCode == KeyEvent.KEYCODE_BACK && event.getAction() == KeyEvent.ACTION_UP) {        if (webView.canGoBack()) {          webView.goBack();        }      }      // return true to prevent closing the WebView      return true;    }  });  dialog.show();}


- (IBAction)showOfferwallAction:(id)sender {  WKWebViewConfiguration* configuration = [[WKWebViewConfiguration alloc] init];  configuration.allowsInlineMediaPlayback = YES;  configuration.allowsAirPlayForMediaPlayback = NO;  WKWebView* webview = [[WKWebView alloc] initWithFrame:self.view.frame configuration:configuration];  [webview setUIDelegate:self];  [webview loadRequest:[NSURLRequest requestWithURL:[NSURL URLWithString:@"https://rewards.unity.com/owp/web/link/sdk_key/u/user_id"]]];  [self.view addSubview:webview];}// Open external browser for window.open() or target = _blank- (WKWebView *)webView:(WKWebView *)webViewcreateWebViewWithConfiguration:(WKWebViewConfiguration *)configuration   forNavigationAction:(WKNavigationAction *)navigationAction        windowFeatures:(WKWindowFeatures *)windowFeatures {  NSURL *url = navigationAction.request.URL;  [[UIApplication sharedApplication] openURL:url options:@{} completionHandler:^(BOOL success) {    if(!success) {      NSLog(@"Failed to open URL: %@", [url absoluteString]);    }  }];  return nil;}

기술 자료

Development

User Acquisition

Monetization

산업 분야