深度链接

通过实现深度链接将 Web Offerwall 集成到您的网站或移动应用中。

阅读时间6 分钟

最后更新于 2 天前

直接链接提供了一种将您的网站链接到 Offerwall 的非常简单的方法。在显示 Offerwall 的任何位置都可以链接到以下 URL：


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

必需参数

SDK_KEY - Tapjoy 提供的 SDK 密钥
USER_ID - 您需要提供用户 ID，以便能够为用户正确发放奖励。如需了解更多信息，请参阅自管货币。

注意

因为 USER_ID 是 URL 的一部分，所以必须确保其采用 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

参数用于选择在您的网站或移动应用中加载的广告位。加载广告位后，Tapjoy 会渲染与该广告位关联的内容卡片。

如果省略

event_name

，Tapjoy 默认加载标准 Offerwall。

重要

如果省略

event_name

参数，请先在 Tapjoy 后台中创建

#WebOfferwall

广告位并将其关联到内容卡片，然后再使用 URL。如需相关说明，请参阅“广告位”文档的创建广告位一节以及“Offerwall 卡片”文档的创建 Offerwall 一节。

使用以下深度链接格式通过 event_name 指定广告位。


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

用户标签

Web Offerwall 支持使用用户标签进行细分段定向投放。您可以使用

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 中嵌入 Web Offerwall 时，必须确保 iframe 的大小不超过设备的屏幕视口，这一点至关重要。否则，会导致 Instruction CTA Button（操作说明引导按钮）出现在可见视口之外，用户需要向下滚动到底部才能访问该按钮。

iframe 中嵌入的 Web Offerwall 示例，说明超大 iframe 如何将 Instruction CTA 按钮推到可见视口之外。

通过遵循这些准则，开发者可以最大限度提高 Web Offerwall 产品的实用性和用户参与度，确保随时能访问重要的 UI 元素。

移动应用中的 Web Offerwall

通过将链接加载到 WebView 中，也可在移动应用中使用 Web Offerwall。

示例

Android

由于 Web Offerwall 尚未完全支持 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

工业

文档