Offerwall 移行ガイド
移行の手順説明に従って、アプリに実装された既存の ironSource Offerwall を Tapjoy Offerwall に移行します。
読み終わるまでの所要時間 2 分最終更新 1日前
- まず、ironSource Tapjoy アダプターを統合する必要があります。これは以下のように podfile に加えることができます。
アダプターの最新バージョンは こちら で確認できます。pod 'IronSourceTapjoyAdapter','4.1.23.1'
- このアダプターには Offerwall SDK のコピーが付属しているため、Offerwall SDK 関数を直接呼び出しできます。これは、Tapjoy Offerwall を表示するのに必要な作業です。最初に、以下を実行して Tapjoy をクラスにインポートする必要があります。
#import <Tapjoy/TJPlacement.h>
- その後、Offerwall SDK を初期化する必要があります。これが成功 (または失敗) したときにコールバックを受け取り、成功コールバックを受け取るまで Offerwall SDK を呼び出す必要はありません。
[Tapjoy connect:@"TJ_SDK_KEY"]; - (void)tjcConnectSuccess:(NSNotification *)notifyObj { NSLog(@"Tapjoy connect succeeded");}- (void)tjcConnectFail:(NSNotification *)notifyObj { NSLog(@"Tapjoy connect failed");}
- 次にプレースメントオブジェクトを作成します。プレースメントは Tapjoy ダッシュボードで設定するもので、Offerwall コンテンツカードが含まれます。この例では、プレースメントに ‘Offerwall’ という名前を付けていることを前提としています。実際には任意の名前を付けることができますが、ここでコードで使用する名前はダッシュボードと一致している必要があります。
TJPlacement *placement = [TJPlacement placementWithName:@"Offerwall" delegate:self];
- これで、プレースメントをリクエストする準備ができました。この呼び出しにより、表示することを選択したときに準備ができているように、プレースメントをロードします。Offerwall のプレースメントは迅速にロードされますが、この Offerwall を表示することを考えているときは、事前に呼び出しておくことをお勧めします。
[p requestContent];
- 実装できる幅広いコールバックを用意しています。
これらの中には、すでに実装済みの ironSource のコールバックに置き換わるものもあります。以下の表は、対応するコールバックを示しています。これにより、カスタムロジックを適切な Tapjoy コールバックに簡単に変えることができます。- (void)requestDidSucceed:(TJPlacement*)placement{}- (void)requestDidFail:(TJPlacement*)placement error:(NSError*)error{}- (void)contentIsReady:(TJPlacement*)placement{}- (void)contentDidAppear:(TJPlacement*)placement{} - (void)contentDidDisappear:(TJPlacement*)placement{}
ironSource コールバック | Tapjoy コールバック |
|---|---|
| offerwallDidShow | contentDidAppear |
| offerwallDidClose | contentDidDisappear |
| offerwallHasChangedAvailability | contentIsReady |
requestDidSuceedcontentIsReady- Offerwall のプレースメントを表示するには、以下のようにコンテンツの準備ができていることを確認し、showContent を呼び出します。
これは既存の ironSource の呼び出しに置き換わるものです。if (placement.isContentReady) { [placement showContentWithViewController:nil];}
[IronSource showOfferwallWithViewController:UIViewController];
showContent-
ユーザーが Offerwall を却下した場合、コンテンツを再度リクエストする必要があります。プレースメントを複数回表示することはできません。コールバックでプレースメントをリクエストし、ユーザーが次回表示することををリクエストしたときにすぐに表示できるようにしておくことをお勧めします。
contentDidDisappear - これで、残りの ironSource Offerwall コードを削除できます。例を次に示します。
同等の Tapjoy バージョンに変換しなかったコールバックも同様です。LevelPlay SDK の初期化時に[IronSource setOfferwallDelegate:yourOfferwallDelegate];
@[IS_OFFERWALL]プライバシー
Unity LevelPlay を使用している場合は、LevelPlay API を使用して、以下のプライバシーフラグを Tapjoy と共有できます。- GDPR についての同意。
- 米国の州プライバシー法に基づく個人情報の販売または共有のオプトアウト。
- 特定のエンドユーザーにお子様のフラグを付けること。アプリが主に COPPA で定めるお子様を対象としている場合は、すべてのエンドユーザーにお子様のフラグを付ける必要があります。