ドキュメント

AppsFlyerインテグレーション検証

ユーザー Acquisition (ユーザー獲得) ダッシュボードで AppsFlyer のインテグレーションルールとインテグレーション設定の警告の解決方法を確認します。
読み終わるまでの所要時間 7 分最終更新 3日前

ユーザー獲得キャンペーンをAppsFlyerに統合すると、Unity Dashboardでインテグレーション設定の検証が行われ、正しく設定されているかどうかが確認されます。これらのインテグレーションエラーを解決しないと、新規キャンペーンや一時停止キャンペーンを開始できず、稼働中のキャンペーンでパフォーマンスとアトリビューションに関する重大な問題が発生する可能性があります。

必須インテグレーション規則

キャンペーンを稼働させるには、以下のルールに従う必要があります。 これらの問題の解決方法については、「 必要な解決策 」セクションを参照してください。 以下のインテグレーションは、キャンペーンを稼働させるために必須ではありません。ただし、以下の推奨ルールを満たさない場合は、キャンペーンのパフォーマンスとアトリビューションに悪影響を及ぼす可能性があります。
  • オーガニックなど、すべてのソースからのユーザーのインストールイベントポストバックを送信します。
  • インストール後イベントのポストバックを、オーガニックを含むすべてのソースのユーザーに送信します。これには以下のポストバック タイプが含まれます。
    • オーガニックを含め、すべてのソースのユーザーに対してアプリ内課金イベントポストバックを送信します。
    • オーガニックを含むすべてのソースのユーザーに対して広告収益イベントポストバックを送信します。
    • オーガニックを含むすべてのソースのユーザーにセッションイベントポストバックを送信します。
    • レベル完了イベントポストバックをオーガニックを含むすべてのソースのユーザーに送信します。
これらの問題の解決方法については、「 推奨解決策 」セクションを参照してください。

必要な解像度

必要なインテグレーション規則を満たすには、以下のセクションを参照してください。

ゲーム ID は一致する必要があります

この検証ルールを満たすには、AppsFlyer ダッシュボードに入力するゲーム ID が、Unity の ユーザー Acquisition (ユーザー獲得) ダッシュボードのゲーム ID と正確に一致していることを確認します。Unity Dashboard の Apps ページからゲーム ID を取得するには、次の手順に従います。
  1. ダッシュボードの左側ナビゲーションメニューから Apps (アプリ) に移動します。表示されるテーブルには、組織の各アプリがリストされています。各アプリ名の後に、ダッシュボードでアプリのプラットフォームとゲーム ID が表示されます。
  2. ID の横にある Copy (コピー) アイコンを選択してクリップボードにコピーします。
ゲーム ID は、ダッシュボードの「Campaigns(キャンペーン)」、「**Campaign details(**キャンペーン詳細)」、および「**Creative packs(**クリエイティブパック)」ページから取得することもできます。詳細については、ゲーム ID のドキュメントを参照してください。

ポストバックWindowsは生存期間に設定する必要があります

AppsFlyerでこの検証ルールを満たすには、アプリケーション内イベントのポストバックウィンドウを
lifetime
に設定します。このウィンドウを設定するには、次の手順を実行します。
  1. インテグレーション タブの In-app event postbacks セクションに移動します。
  2. In-app event postbacks トグルをアクティブ化します。
  3. In-app event postback windowlifetime に設定します。
    AppsFlyer インテグレーション設定で lifetime に設定した in-app event postback window

    Lifetime postback window

Click-through lookback Windowsは2日以上必要

この検証ルールを満たすには、クリックスルー ルックバック ウィンドウを
2
daysに設定します。このウィンドウを設定するには、次の手順を実行します。
  1. インテグレーション タブの Install attribution セクションに移動します。
  2. Install engaged click-through lookback ウィンドウ セクションで、Days を選択します。
  3. スライダーを使用して、ウィンドウを 2 Days に設定します。
    AppsFlyer インテグレーション設定のインストール連動型クリックスルールックバックウィンドウ設定

    2-day click-through lookback window

ビュースルー Lookback Windows は少なくとも 7 日間

この検証ルールを満たすには、ビュースルー ルックバック ウィンドウを
7
日に設定します。このウィンドウを設定するには、次の手順を実行します。
  1. インテグレーション タブの Install attribution セクションに移動します。
  2. Install engaged view-through lookback ウィンドウ セクションで、Days を選択します。
  3. スライダーを使用して、ウィンドウを 7 Days に設定します。
  4. Install view-through attribution トグルをアクティブ化します。
    AppsFlyer インテグレーション設定のインストール連動ビュースルールックバックウィンドウ設定

    7-day view-through lookback window

ビューアトリビューションを有効にする必要があります

この検証ルールを満たすには、AppsFlyer のインテグレーション設定でビューアトリビューションを有効にしてください。ビューアトリビューションを有効にするには、以下の手順に従います。
  1. インテグレーション タブの Install attribution セクションに移動します。
  2. Install engaged view-through lookback window」セクションに従って、「Install view-through attribution」トグルをアクティベートします。
    AppsFlyer インテグレーション設定のインストールビュースルーアトリビューショントグル

    View-through attribution enabled

レベル完了イベントのポストバックには値を含める必要がある

この検証ルールを満たすには、AppsFlyerインテグレーション設定でレベル完了イベントをマップするときに、「Values & revenue(値と収益)」を選択するようにしてください。このデータ共有設定を行うには、次の手順を実行します。
  1. インテグレーション タブの In-app event postbacks セクションに移動します。
  2. In-app event postbacks トグルをアクティブ化します。
  3. マッピング テーブルの [include] カラムで、[Values & revenue] を選択します。
以下の正しいマッピングの例を参照してください。
AppsFlyer event (AppsFlyer イベント) Mapped to partner event (パートナーイベントにマップ) for users from (以下のユーザーの場合) including (追加)
af_level_achieved
level_complete
All media sources, including organic (オーガニックを含むすべてのメディアソース)Values & revenue (値、収益)
AppsFlyer イベントマッピング表の値と収益の選択

Share Level Complete event values and revenue

購入イベントポストバックには値を含める必要がある

この検証ルールを満たすには、AppsFlyerインテグレーション設定で購入イベントをマップするときに、「Values & revenue(値と収益)」を選択するようにしてください。このデータ共有設定を行うには、次の手順を実行します。
  1. インテグレーション タブの In-app event postbacks セクションに移動します。
  2. In-app event postbacks トグルをアクティブ化します。
  3. マッピング テーブルの [include] カラムで、[Values & revenue] を選択します。
以下の正しいマッピングの例を参照してください。
AppsFlyer event (AppsFlyer イベント) Mapped to partner event (パートナーイベントにマップ) for users from (以下のユーザーの場合) including (追加)
af_purchase
purchase
All media sources, including organic (オーガニックを含むすべてのメディアソース)Values & revenue (値、収益)
AppsFlyer イベントマッピング表の値と収益の選択

Share Purchase event values and revenue

Revenueイベント ポストバックには値を含める必要があります

重要
AppsFlyerで広告収益イベントをマップするには、最初に広告収益の共有を有効にする必要があります。詳細や手順については、AppsFlyer の広告収益アトリビューション に関するドキュメントを参照してください。
この検証ルールを満たすには、AppsFlyerのインテグレーション設定で広告収益イベントをマップするときに、「Values & revenue(値と収益)」を選択するようにしてください。このデータ共有設定を構成するには、AppsFlyerのインテグレーション設定のインテグレーションタブで以下の手順に従います。
  1. インテグレーション タブの In-app event postbacks セクションに移動します。
  2. In-app event postbacks トグルをアクティブ化します。
  3. マッピング テーブルの [include] カラムで、[Values & revenue] を選択します。
以下の正しいマッピングの例を参照してください。
AppsFlyer event (AppsFlyer イベント) Mapped to partner event (パートナーイベントにマップ) for users from (以下のユーザーの場合) including (追加)
af_ad_revenue
ad_revenue
All media sources, including organic (オーガニックを含むすべてのメディアソース)Values & revenue (値、収益)
AppsFlyer イベントマッピング表の値と収益の選択

Share Ad Revenue event values and revenue

セッション イベント ポストバックには値を含める必要がある

この検証ルールを満たすには、AppsFlyerのインテグレーション設定でセッションイベントをマップするときに、「Values & no revenue(値と収益なし)」を選択するようにしてください。このデータ共有設定を行うには、次の手順を実行します。
  1. インテグレーション タブの In-app event postbacks セクションに移動します。
  2. In-app event postbacks トグルをアクティブ化します。
  3. マッピング テーブルの [include] カラムで、[Values & no revenue] を選択します。
以下の正しいマッピングの例を参照してください。
AppsFlyer event (AppsFlyer イベント) Mapped to partner event (パートナーイベントにマップ) for users from (以下のユーザーの場合) including (追加) Values & no revenue
af_app_opened
session
All media sources, including organic (オーガニックを含むすべてのメディアソース)
AppsFlyer イベントマッピング表の値と収益なしの選択

Share Session event values only

購入イベントポストバックが正しくマッピングされている必要がある

この検証ルールを満たすには、AppsFlyerのインテグレーション設定で購入イベントを正しくマップしてください。購入イベントのポストバックをマップするには、次の手順に従います。
  1. インテグレーション タブの In-app event postbacks セクションに移動します。
  2. In-app event postbacks トグルをアクティブ化します。
  3. 購入イベント行を次のようにマップします。
AppsFlyer event (AppsFlyer イベント) Mapped to partner event (パートナーイベントにマップ) for users from (以下のユーザーの場合) including (追加)
af_purchase
purchase
All media sources, including organic (オーガニックを含むすべてのメディアソース)Values & revenue (値、収益)
AppsFlyer インテグレーション設定のイベントマッピングテーブル

Purchase event mapping for In-app Purchase campaigns

AppsFlyer イベントは正しい Unity イベント名にマップされる必要がある

この検証ルールを満たすには、すべてのAppsFlyerイベントポストバックが正しくマップされていることを確認します。イベントをマップするには、次の手順を実行します。
  1. インテグレーション タブの In-app event postbacks セクションに移動します。
  2. In-app event postbacks トグルをアクティブ化します。
  3. 次のように、mapped to partner event列でインストール後のイベントをUnityイベントにマップします。
    • session
      へのセッションイベント
    • レベル完了イベントを
      level_complete
    • ad_revenue
      に対する広告収益イベント
    • purchase
      へのアプリ内課金イベント
以下の正しいイベントマッピングの例を参照してください。
AppsFlyer event (AppsFlyer イベント) Mapped to partner event (パートナーイベントにマップ) for users from (以下のユーザーの場合) including (追加)
af_purchase
purchase
All media sources, including organic (オーガニックを含むすべてのメディアソース)Values & revenue (値、収益)
{custom_sdk_event_name}
level_complete
All media sources, including organicValues & revenue
af_app_opened
session
All media sources, including organicValues & no revenue
af_ad_revenue
ad_revenue
All media sources, including organicValues & revenue
重要
AppsFlyerで広告収益イベントをマップするには、最初に広告収益の共有を有効にする必要があります。詳細や手順については、AppsFlyer の広告収益アトリビューション に関するドキュメントを参照してください。

アプリケーションは少なくとも1つのインストールポストバックを受け取る必要がある

この検証ルールを満たすには、デフォルトのポストバック設定を正しく設定して、キャンペーンがインストールポストバックを受け取れるようにします。これらのAppsFlyerインテグレーション設定を以下のように設定します。
  1. インテグレーション タブの Default postbacks セクションに移動します。
  2. Install
    の行で、for users from (以下のユーザーの場合) ドロップダウンで、All media sources, including organic を選択します。
    AppsFlyer インテグレーション設定の Default postbacks セクション

    Share all sources, including organic

キャンペーンでは、1 つ以上の広告収益ポストバックを受け取る必要があります。

この検証ルールを満たすには、AppsFlyerインテグレーション設定で広告収益データを有効にしてください。広告収益イベントデータをキャンペーンと共有するには、以下の手順を実行します。
  1. AppsFlyer 統合設定の Ad revenue タブに移動します。
  2. Get ad revenue data トグルをアクティブ化します。
    AppsFlyer インテグレーション設定の Ad revenue (広告収益) タブと Get ad revenue (広告収益の取得) トグル

    Get ad revenue toggle

  3. AppsFlyer のダッシュボードのサイドメニューから Settings > Revenue Settings に進みます。
    重要
    Revenue Settings メニューにアクセスするには、AppsFlyer ROI360 サブスクリプションが必要です。詳細や手順については、AppsFlyer の広告収益アトリビューション に関するドキュメントを参照してください。
  4. Revenue settings ページの Ad revenue タブで、New ad revenue integration を選択します。
  5. 収益パートナーのリストから Unity Ads を選択します。
  6. パートナー設定で、レポートタイプとして Impression-level (via SDK) with Device-level (via S2S API) を選択します。
    AppsFlyer Ad の収益パートナー設定のデバイスレベルオプションを使用したインプレッションレベル

    AppsFlyer Revenue settings configuration

  7. API 認証情報を入力します。アプリケーション キー フィールドにゲーム ID を入力します。Unity のダッシュボードから 秘密鍵 を取得するには、以下の手順を参照してください。

Unity Dashboard から秘密鍵を取得するには、以下の手順を実行します。
  1. 左側のナビゲーションメニューから API Management (API 管理) に進みます。
  2. Advertising Management API (広告管理 API) > Service account (サービスアカウント) を選択します。
    ユーザー獲得 (ユーザー獲得) ダッシュボードの API Management (API 管理) ページ

    Advertising Management Service account

  3. サービスアカウントがない場合は、+ New (+ 新規) を選択します。すでにサービスアカウントがある場合は、テーブルから選択します。
  4. サービスアカウントページで Keys (キー) セクションに進みます。
  5. + Add key (+ キーの追加) を選択して新しいキーを生成します。
  6. Secret key (秘密鍵) の後にあるコピー用ボタンを選択して ID をコピーします。

キャンペーンでは、1 つ以上のアプリ内課金ポストバックを受け取る必要があります。

この検証ルールを満たすには、AppsFlyerのインテグレーション設定で購入イベントを正しくマップしてください。購入イベントのポストバックをマップするには、次の手順に従います。
  1. インテグレーション タブの In-app event postbacks セクションに移動します。
  2. In-app event postbacks トグルをアクティブ化します。
  3. 購入イベント行を次のようにマップします。
AppsFlyer event (AppsFlyer イベント) Mapped to partner event (パートナーイベントにマップ) for users from (以下のユーザーの場合) including (追加)
af_purchase
purchase
All media sources, including organic (オーガニックを含むすべてのメディアソース)Values & revenue (値、収益)
AppsFlyer インテグレーション設定のイベントマッピングテーブル

Purchase event mapping for In-app Purchase campaigns

推奨されるインテグレーション規則を満たすには、以下のセクションを参照してください。

すべてのソースからのユーザーに対するインストールイベントポストバックの送信

この推奨されるインテグレーション規則を満たすには、すべてのメディアソースのユーザーにインストールイベントのポストバックを送信するようにしてください。これを行うには、以下のステップに従います。
  1. AppsFlyerインテグレーションのインテグレーションタブのデフォルトのポストバックセクションに移動します。
  2. ドロップダウンから for users を使用して、Install イベントに All media sources, including organic を選択します。
AppsFlyer インテグレーション タブの Default postbacks セクション

Share all install postbacks for users from all media sources, including organic

すべてのソースからのユーザーにインストール後イベントポストバックを送信する

インストール後イベントの推奨インテグレーション規則をすべて満たすには、イベントをマップするときに、すべてのメディアソースからのユーザーに対するイベントポストバックを共有してください。これを行うには、以下のステップに従います。
  1. インテグレーション タブの In-app event postbacks セクションに移動します。
  2. In-app event postbacks トグルをアクティブ化します。
  3. for users from] カラムで、以下の各イベント タイプに対して All media sources, including organic を選択します。
    • purchase
    • ad_revenue
    • level_complete
    • session
    AppsFlyer イベントマッピングテーブルのオーガニックな選択を含む、すべてのメディアソース

    Share post-install event postbacks for users from all media sources, including organic