Offerwall 移行ガイド
Offerwall 移行ガイドに従って、ironSource から Tapjoy に移行します。
読み終わるまでの所要時間 2 分最終更新 10日前
- Unity Offerwall アダプターを統合します。これは、ironSource メディエーションマネージャーウィンドウを使用してプロジェクトに追加できます。
- Offerwall Unity プラグインを追加します。これにより、C# コードから Offerwall SDK メソッドにアクセスできるようになります。
TJPluginDependencies<dependencies><androidPackages> <repositories> <repository>https://sdk.tapjoy.com</repository> </repositories> <androidPackage spec="com.tapjoy:tapjoy-android-unitybridge:12.11.1@aar"/> </androidPackages></dependencies>
- Offerwall SDK の関数を直接呼び出します。これは、Tapjoy Offerwall を表示するのに必要な作業です。最初に、以下を実行して Tapjoy をクラスにインポートする必要があります。
import TapjoyUnity
- Offerwall SDK を初期化します。これが成功 (または失敗) したときにコールバックを受け取り、成功コールバックを受け取るまで Offerwall SDK を呼び出す必要はありません。
#if UNITY_ANDROID Tapjoy.Connect("your_android_sdk_key");#elif UNITY_IOS Tapjoy.Connect("your_ios_sdk_key");#endif
- プレースメントオブジェクトとリスナーを作成します (リスナーについてはステップ 5 で詳しく説明します)。プレースメントは Offerwall ダッシュボードで設定するもので、Offerwall コンテンツカードが含まれます。この例では、プレースメントに Offerwall という名前を付けていることを前提としています。実際には任意の名前を付けることができますが、ここでコードで使用する名前はダッシュボードと一致している必要があります。
TJPlacement placement = TJPlacement.CreatePlacement("Offerwall");
- プレースメントをリクエストします。この呼び出しにより、表示することを選択したときに準備ができているように、プレースメントをロードします。Offerwall のプレースメントは迅速にロードされますが、この Offerwall を表示することを考えているときは、事前に呼び出しておくことをお勧めします。
placement.requestContent();
- 実装できる幅広いコールバックを用意しています。
これらの中には、すでに実装済みの ironSource のコールバックに置き換わるものもあります。以下の表は、対応するコールバックを示しています。これにより、カスタムロジックを適切な Tapjoy コールバックに簡単に変えることができます。TJPlacement.OnRequestSuccess += HandlePlacementRequestSuccess;TJPlacement.OnRequestFailure += HandlePlacementRequestFailure;TJPlacement.OnContentReady += HandlePlacementContentReady;TJPlacement.OnContentShow += HandlePlacementContentShow;TJPlacement.OnContentDismiss += HandlePlacementContentDismiss;
ironSource のコールバック | Tapjoy のコールバック |
|---|---|
| onOfferwallClosedEvent | OnContentDismiss |
| onOfferwallOpenedEvent | OnContentShow |
| onOfferwallAvailableEvent | OnContentReady |
OnRequestSuccessOnContentReady- Offerwall のプレースメントを表示するには、以下のようにコンテンツの準備ができていることを確認し、を呼び出します。
showContent
これは既存の ironSource の呼び出しに置き換わるものです。if (placement.IsContentReady()) { placement.ShowContent();}
IronSource.Agent.showOfferwall();
-
ユーザーが Offerwall を却下した場合、コンテンツを再度リクエストする必要があります。プレースメントを複数回表示することはできません。コールバックでプレースメントをリクエストし、ユーザーが次回表示することををリクエストしたときにすぐに表示できるようにしておくことをお勧めします。
OnContentDismiss - これで、残りの ironSource Offerwall コードを削除できます。
プライバシー
Unity LevelPlay を使用している場合は、LevelPlay API を使用して、以下のプライバシーフラグを Tapjoy と共有できます。- GDPR についての同意。
- 米国の州プライバシー法に基づく個人情報の販売または共有のオプトアウト。
- 特定のエンドユーザーにお子様のフラグを付けること。アプリが主に COPPA で定めるお子様を対象としている場合は、すべてのエンドユーザーにお子様のフラグを付ける必要があります。