TikTokアプリイベントSDKの統合方法

始める前に

AndroidおよびiOS用のTikTokアプリイベントSDKを使用するには、TikTok広告アカウントとTikTokアプリIDが必要です。既存のアプリがあればそれを使用するか、新しいアプリを作成することもできます。

注：TikTokアプリイベントSDKは、同一広告アカウント内のMMPとの二重設定のサポートを開始しました。SDKを統合するには、新しいTikTok広告アカウントを作成するか、既存のMMPアカウントを使用できます。

TikTokアプリイベントSDKの統合方法

ステップ1：アプリを作成するか既存のアプリを使用し、TikTokアプリIDとアプリシークレットを生成します

オプション1：MMPに連携済みのアプリにSDKを追加する（二重設定）

1. TikTok広告マネージャーにログインします。

2. 「ツール」タブをクリックし、「イベントマネージャー」を選択します。

3. 「データソース」を選択し、SDK連携を行いたいアプリを選択します。

   
   
   

4. 「設定」タブへ移動し、TikTokアプリイベントSDKから「パートナーを選択」をクリックします。

   
   
   

5. 手順に従い、アカウントにSDKを追加します。TikTokアプリIDおよびアプリシークレットを生成します。

   

オプション2：新規作成したアプリにSDKを追加する

1. TikTok広告マネージャーにログインします。

2. 「ツール」タブをクリックし、「イベントマネージャー」を選択します。

3. 左上のナビゲーションで「データソースを連携」を選択し、「アプリ」を選択します。

   
   
   

4. 「TikTok SDK」を選択してアプリを連携します。

   
   
   

5. アプリの詳細を入力し、アプリを作成します。手順に従い、TikTokアプリIDおよびアプリシークレットを生成します。

   
   
   

ステップ2：TikTok Developer Centerガイドに従って、TikTokアプリイベントSDKを統合します

1. SDKを開始するには、ステップ1のアプリID、TikTokアプリID、アプリシークレットが必要です。

   1. アプリIDとTikTokアプリIDのデモ：

      
      
      

   2. アプリシークレットのデモ：

      
      
      

2. GitHubでSDKをダウンロードします。現時点ではNative iOS SDK、Native Android SDK、Unity SDKがサポート対象です。

ステップ3：SDKを通したイベントポストバック

1. ログを残せる標準アプリイベントと自動ログイベントの一覧については、標準イベントを参照してください。

2. 自動ログイベントの一覧は以下のとおりです。注：自動ログイベントはオフにすることができます。詳細については、AppイベントSDK開発者向けドキュメントを確認してください。

   1. アプリ起動：アプリの起動時。

   2. アプリインストール：アプリの初回起動時。

   3. 2Dリテンション：初回起動時の翌日に再びアプリをアプリを開いた時。

   4. 購入：消耗品 / 非消耗品 / 購買の購入が完了した時。

      1. 自動ログ購入ポストバックを有効化する前に、それがビジネス要件に合致しているかを確認してください。iOS自動ログ購入イベントと、Android自動ログ購入イベントについて確認してください。

自動ログ購入イベントについてのご案内：SDKは、StoreKit（iOS）またはGoogle Play Billing（Android）を経由して行われた取引も自動取得できます。より多くのプロパティやパラメータを渡す場合、またはAppleやGoogleのネイティブ支払いゲートウェイを使用していない場合は、手動購入ポストバックの使用をおすすめします。

ステップ4：【iOS】SKANイベントを計測します

SKAdNetwork（SKAN）環境では、コンバージョン値を報告するSDKを1つのみにすることをおすすめします。MMPまたは他のSDKを使用してSKAdNetworkへのコンバージョン値を更新している場合、更新の競合を避けるため、設定にdisableSKAdNetworkSupport()を追加してください。

TikTok SDK SKAN計測を有効化する必要があるかどうかを確認します。

MMPがある場合：

• MMP SDKがコンバージョン値（CV）を更新し、MMPのSKANスキーマを使用する場合：TikTok SDKでSKAdNetworkサポートを無効化し、TikTokイベントマネージャーにスキーマをアップロードしないでください。 （MMPが、CV更新とスキーマに関する信頼できる唯一の情報源であり続けます。）

MMPがない場合：

アプリ内でSKANコンバージョン値を更新するSDKは1つだけであることを確認してください。

• 別の非MMP SDKがCVを更新している場合：TikTok SDKのSKAdNetworkサポートを無効化し、TikTokイベントマネージャーにスキーマをアップロードしてください。 （TikTokはスキーマを使用しますが、不要なCV更新を行いません。）

• TikTok SDKがCVを更新している場合：TikTok SDKのSKAdNetworkサポートを有効化し、TikTokイベントマネージャーにスキーマをアップロードしてください。 （TikTokがSKAN CV更新の主要な処理担当となります。）

詳しくは、アプリイベントSDK開発者向けドキュメントを確認してください。

ステップ5：デバッグモードでリアルタイムにポストバックを認証します

SDKバージョン1.5.0以降、リリース前にSDKの統合を検証する方法は次の2通りあります。

• （推奨）トークンベースのテストイベントモード。これはTikTokイベントマネージャーのみで実施され、コードの変更は不要です。

• 手動のデバッグモード。変更が必要となります。手動のデバッグを使用する際は、アプリリリース前にデバッグモードをオフにしてください。これらのツールのいずれかを使用する際に生成されるイベントはテストパイプラインを経由するため、レポート作成には使用できません。

  • デバッグモード：オン

    

    デバッグモード：オフ

    

ステップ6：TikTok SDKを使用した新しいアプリバージョンを、App Store（iOS）/ Play Store（Android）にリリースします

TikTokがSDKからリアルタイムシグナルを受信し始めると、SDKイベントがイベントマネージャーの「レポート」タブに表示されるようになります。テストモードのシグナルはここには表示されません。

ステップ7：TikTok SDKを使用してキャンペーンを実行します

アプリイベントSDKの統合に関する問題やトラブルについては、カスタマーサポートまでチケットを送信してください。問題のカテゴリーを、「測定」、「アプリイベントSDK」の順に選択してください。