ドキュメント

サポート

Offerwall

収益化の開始

ユーザー獲得の開始

Unity SDK の統合

Offerwall

Offerwall 移行ガイド

既存の ironSource コールバックを同等の Tapjoy の onContentReady や onContentDismiss などにマッピングすることで、Offerwall ロジックを移行します
読み終わるまでの所要時間 2 分最終更新 10日前
  1. ironSource Tapjoy アダプターを統合します。これは以下の例のように Gradle ファイルに追加できます。
maven { url "https://sdk.tapjoy.com/"}implementation 'com.ironsource.adapters:tapjoyadapter:4.1.23'implementation 'com.tapjoy:tapjoy-android-sdk:12.11.1'
アダプターの最新バージョンは こちら で確認できます。
  1. アダプターと同様に、Offerwall SDK を追加して、Offerwall SDK 関数を直接呼び出しできるようにします。これは、Tapjoy Offerwall を表示するのに必要な作業です。最初に、以下を実行して Tapjoy をクラスにインポートする必要があります。
import com.tapjoy.Tapjoy;
  1. Offerwall SDK を初期化します。これが成功 (または失敗) するとコールバックを受け取ります。成功コールバックを受け取るまで Offerwall SDK 呼び出しを行わないでください。
Hashtable<String, Object> connectFlags = new Hashtable<String, Object>();Tapjoy.connect(getApplicationContext(), "TJ_SDK_KEY", connectFlags, new TJConnectListener() {  @Override  public void onConnectSuccess() {  }         @Override  public void onConnectFailure() {  }});
  1. 2 つの新しいクラス変数を定義します。
private TJPlacementListener placementListener = this;private TJPlacement placement;
  1. プレースメントオブジェクトを設定します。プレースメントは Tapjoy ダッシュボードで設定するもので、Offerwall コンテンツカードが含まれます。この例では、プレースメントに ‘Offerwall’ という名前を付けていることを前提としています。実際には任意の名前を付けることができますが、ここでコードで使用する名前はダッシュボードと一致している必要があります。
placement = Tapjoy.getPlacement("Offerwall", placementListener);
  1. これで、プレースメントをリクエストする準備ができました。この呼び出しにより、表示することを選択したときに準備ができているように、プレースメントをロードします。Offerwall のプレースメントは迅速にロードされますが、この Offerwall を表示することを考えているときは、事前に呼び出しておくことをお勧めします。
placement.requestContent();
  1. 実装できる幅広いコールバックを用意しています。
public void onRequestSuccess(TJPlacement placement); public void onRequestFailure(TJPlacement placement, TJError error);public void onContentReady(TJPlacement placement); public void onContentShow(TJPlacement placement);public void onContentDismiss(TJPlacement placement);public void onPurchaseRequest(TJPlacement placement, TJActionRequest request, String productId);public void onRewardRequest(TJPlacement placement, TJActionRequest request, String itemId, int quantity);public void onClick(TJPlacement placement);
これらの中には、すでに実装済みの ironSource コールバック (
OfferwallListener
を使用して利用可能) に置き換わるものもあります。以下の表は、対応するコールバックを示しています。これにより、カスタムロジックを適切な Tapjoy コールバックに簡単に変えることができます。

ironSource コールバック

Tapjoy コールバック

onOfferwallOpenedonContentShow
onOfferwallClosedonContentDismiss
onOfferwallAvailableonContentReady
onRequestSuccess
は、Tapjoy のサーバーからコンテンツリクエストが返されたときに呼び出されます。
onContentReady
は、コンテンツ (Offerwall) を表示する準備ができたときに呼び出されます。この時点で、Offerwall を表示するか、フラグを設定して、必要なときに表示できる状態にすることができます。
  1. Offerwall のプレースメントを表示するには、以下のようにコンテンツの準備ができていることを確認し、
    showContent
    を呼び出します。
if(placement.isContentReady()) {  placement.showContent();}
これは既存の ironSource の呼び出しに置き換わるものです。 
IronSource.showOfferwall();
  1. ユーザーが Offerwall を却下した場合、コンテンツを再度リクエストする必要があります。プレースメントを複数回表示することはできません。
    onContentDismiss
    コールバックでプレースメントをリクエストし、ユーザーが次回表示することををリクエストしたときにすぐに表示できるようにしておくことをお勧めします。
  2. これで、残りの ironSource Offerwall コードを削除できます。例えば、ironSource Offerwall リスナーを設定する必要がなくなり、クラスが "OfferwallListener" を実装している場合は、この参照を削除します。

プライバシー

Unity LevelPlay を使用している場合は、LevelPlay API を使用して、以下のプライバシーフラグを Tapjoy と共有できます。
  1. GDPR についての同意。
  2. 米国の州プライバシー法に基づく個人情報の販売または共有のオプトアウト。
  3. 特定のエンドユーザーにお子様のフラグを付けること。アプリが主に COPPA で定めるお子様を対象としている場合は、すべてのエンドユーザーにお子様のフラグを付ける必要があります。
また、アプリが Google Play の Designed for Families プログラムに参加している場合、または Google Play の "ファミリー" セクションに表示されている場合は、アプリのすべてのユーザーに子供のフラグを付け、Offerwall SDK の この API を使用して、ユーザーの GAID が収集されないように設定してください。 Unity LevelPlay を使用していない場合や、Offerwall SDK を個別に設定する場合は、こちらのガイドライン に従って、関連するプライバシーフラグを Tapjoy と共有します。