Tapjoyオファーウォール広告実装方法 - glossom-dev/AdfurikunSDK-Unity GitHub Wiki

アドフリくん管理画面で広告枠を発行

アドフリくん管理画面で広告枠の追加をする際に、バナー種類「オファーウォール」を選択します。 追加した広告枠の設定画面に入り、「オファーウォール利用申請」を選択する事でTapjoyオファーウォールの広告枠が発行されます。

Tapjoyオファーウォール広告を実装

Tapjoy SDKの導入、オファーウォール広告表示の実装を行います。詳細は、Tapjoyのドキュメントを参考にして下さい。 また、サーバ間の成果通知の実装については、こちらを参考にして下さい。 ※ 本ドキュメントの動作確認TapjoySDKバージョン: 14.0.1

Tapjoy SDK導入

  1. Tapjoy Unity SDKをダウンロードします。
  2. Unityプロジェクトを開きます。
  3. UnityでAssets > Import Package > Custom Packageを選択します。
  4. 1でダウンロードしたフォルダ内の「TapjoyUnityPlugin.unitypackage」ファイルを指定します。
  5. インポートファイルの一覧を確認し、競合などの問題がないか確認します。
  6. "Import" ボタンを押してファイルをインポートします。

Tapjoyオファーウォール広告表示の実装

1. Tapjoy Connectを実装

Tapjoy connect をアプリに実装します。 これにより、アプリからTapjoy SDK を"起動"します。 Tapjoy SDK Keyはアドフリくん管理画面で発行された「sdk_key」を使用して下さい。

実装例

using TapjoyUnity;

public class MainScreen : MonoBehaviour
{
    TJPlacement offerwallPlacement;
    
    void Start()
    {
        Tapjoy.OnConnectSuccess += HandleConnectSuccess;
        Tapjoy.OnConnectFailed += HandleConnectFailed;
        Tapjoy.OnConnectWarning += HandleConnectWarning;
        
        Tapjoy.Connect("Tapjoy SDK Key");
    }
    
    void HandleConnectSuccess()
    {
        Debug.Log("Tapjoy connect succeeded");
    }
    
    void HandleConnectFailed(int code, string message)
    {
        Debug.Log($"Tapjoy SDK failed to connect. Code: {code} Message: {message}");
    }

    void HandleConnectWarning(int code, string message)
    {
        Debug.Log($"Tapjoy SDK connect succeeded with warning Code: {code} Message: {message}");
    }

2. プレイスメントをリクエストする実装

Tapjoy.Connectによる初期化が完了後、TJPlacementクラスにプレイスメント名を指定してインスタンスを作成します。 プレイスメント名はアドフリくん管理画面で発行された「placement_id」を使用して下さい。

offerwallPlacement = TJPlacement.CreatePlacement("プレイスメント名");
offerwallPlacement.RequestContent();

3. TJPlacementのコールバックを実装

コールバックを受け取るには、下記の実装を行います。

TJPlacement.OnRequestSuccess += HandlePlacementRequestSuccess;
TJPlacement.OnRequestFailure += HandlePlacementRequestFailure;
TJPlacement.OnContentReady += HandlePlacementContentReady;
TJPlacement.OnContentShow += HandlePlacementContentShow;
TJPlacement.OnContentDismiss += HandlePlacementContentDismiss;
...

void HandlePlacementRequestSuccess(TJPlacement placement)
{
    // プレイスメント送信自体が成功した時にコールされます。表示する広告有無ではありません。
}

void HandlePlacementRequestFailure(TJPlacement placement, string error)
{
}
    
void HandlePlacementContentReady(TJPlacement placement)
{
    //コンテンツが表示可能になって時にコールされます。
}

void HandlePlacementContentShow(TJPlacement placement)
{
}
    
void HandlePlacementContentDismiss(TJPlacement placement)
{
}

4. プレイスメントの表示

コンテンツを表示するには、ShowContent メソッドを呼び出します。

offerwallPlacement.ShowContent();