ドキュメント

ディープリンク

ディープリンクを実装して、Web Offerwall をウェブサイトまたはモバイルアプリに統合します。
読み終わるまでの所要時間 8 分最終更新 1ヶ月前

ダイレクトリンクは、ウェブサイトを 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 のサイズがデバイスの画面ビューポートを超えないようにする必要があります。そうしないと、指示の CTA ボタンが可視ビューポートの外側に表示されるため、ユーザーはボタンにアクセスするために下までスクロールする必要があります。
iframeに埋め込まれたウェブ オファーウォールの例。特大のiframeで、指示CTAボタンを可視ビューポートの外側に押す方法を示しています。
これらのガイドラインに従うことで、開発者は Web Offerwall 製品のユーザビリティとユーザーエンゲージメントを最大化し、重要な UI 要素に簡単にアクセスできるようにします。

モバイルアプリからの Web Offerwall

Web Offerwall は、リンクを WebView にロードすることでモバイルアプリでも使用できます。

例

Android

Web Offerwall ではまだ Android の戻るボタンが完全にはハンドルされないため、Android の戻るボタンをオーバーライドし、WebView を閉じる独自の UI を実装することをお勧めします。これにより、ユーザーが 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();}