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

> ユーザー Acquisition (ユーザー獲得) ダッシュボードで AppsFlyer のインテグレーションルールとインテグレーション設定の警告の解決方法を確認します。

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

## 必須インテグレーション規則##required-integration-rules

キャンペーンを稼働させるには、以下のルールに従う必要があります。

* [MMP インテグレーションのゲーム ID は、Unity Dashboard](#the-game-id-must-match) のゲーム ID と一致する必要があります。
* [ポストバックWindowsは生存](#postback-windows-must-be-set-to-lifetime)期間に設定する必要があります。
* [Click-through lookback Windows は少なくとも 2 日間](#click-through-lookback-windows-must-be-at-least-2-days)である必要があります。
* [ビュースルー Lookback](#view-through-lookback-windows-must-be-at-least-7-days) Windows は少なくとも 7 日間である必要があります。
* [ビュースルー属性を](#view-through-attribution-must-be-enabled)有効にする必要があります。
* レベル完了キャンペーンの[レベル完了イベント ポストバック](#level-complete-event-postbacks-must-contain-values)には、 値を含める必要があります。
* 購入キャンペーンの[購入イベントポストバック](#purchase-event-postbacks-must-contain-values)には、 値を含める必要があります。
* 広告収益キャンペーンの[収益イベントポストバック](#revenue-event-postbacks-must-contain-values)には、 値を含める必要があります。
* リテンションキャンペーンの[セッションイベントポストバック](#session-event-postbacks-must-contain-values)には、 値を含める必要があります。
* [課金ユーザーキャンペーン](#purchase-event-postbacks-must-be-mapped-correctly)では、課金イベントが正しくマッピングされている必要があります。
* [AppsFlyer イベントは](#appsflyer-events-must-be-mapped-to-the-correct-unity-event-name)、正しい Unity イベント名にマッピングする必要があります。
* [アプリケーションのローンチから2日以内に、過去90日間に少なくとも1回のインストール ポストバックが必要です。](#app-must-receive-at-least-one-install-postback)
* [キャンペーンでは、ローンチから 7 日以内に、1 つ以上の広告収益イベントポストバックが発生する必要があります。](#campaigns-must-receive-one-or-more-ad-revenue-postbacks)
* [キャンペーンでは、開始から7日以内に、アプリ内課金イベントのポストバックが1回以上発生する必要があります。](#campaigns-must-receive-one-or-more-in-app-purchase-postbacks)

これらの問題の解決方法については、「 [必要な解決](#required-resolutions)策 」セクションを参照してください。

## 推奨されるインテグレーション規則##recommended-integration-rules

以下のインテグレーションは、キャンペーンを稼働させるために必須ではありません。ただし、以下の推奨ルールを満たさない場合は、キャンペーンのパフォーマンスとアトリビューションに悪影響を及ぼす可能性があります。

* [オーガニックなど](#send-install-event-postbacks-for-users-from-all-sources)、すべてのソースからのユーザーのインストールイベントポストバックを送信します。
* [インストール後イベントのポストバックを、オーガニック](#send-post-install-event-postbacks-for-users-from-all-sources)を含むすべてのソースのユーザーに送信します。これには以下のポストバック タイプが含まれます。
  * オーガニックを含め、すべてのソースのユーザーに対してアプリ内課金イベントポストバックを送信します。
  * オーガニックを含むすべてのソースのユーザーに対して広告収益イベントポストバックを送信します。
  * オーガニックを含むすべてのソースのユーザーにセッションイベントポストバックを送信します。
  * レベル完了イベントポストバックをオーガニックを含むすべてのソースのユーザーに送信します。

これらの問題の解決方法については、[「 推奨解決](#recommended-resolutions)策 」セクションを参照してください。

## 必要な解像度##required-resolutions

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

### ゲーム ID は一致する必要があります##the-game-id-must-match

この検証ルールを満たすには、AppsFlyer ダッシュボードに入力するゲーム ID が、Unity Ads の ユーザー Acquisition (ユーザー獲得) ダッシュボードのゲーム ID と正確に一致していることを確認します。Unity Dashboard の **Apps** ページからゲーム ID を取得するには、次の手順に従います。

1. ダッシュボードの左側ナビゲーションメニューから **Apps (アプリ**) に移動します。表示されるテーブルには、組織の各アプリがリストされています。各アプリ名の後に、ダッシュボードでアプリのプラットフォームとゲーム ID が表示されます。
2. ID の横にある **Copy** (コピー) アイコンを選択してクリップボードにコピーします。

ゲーム ID は、ダッシュボードの「**Campaigns(キャンペーン**)」、「\*\*Campaign details(\*\*キャンペーン詳細)」、および「\*\*Creative packs(\*\*クリエイティブパック)」ページから取得することもできます。詳細については、[ゲーム ID](/grow/acquire/get-started/retrieve-your-advertiser-game-id.md) のドキュメントを参照してください。

### ポストバックWindowsは生存期間に設定する必要があります##postback-windows-must-be-set-to-lifetime

AppsFlyerでこの検証ルールを満たすには、アプリケーション内イベントのポストバックウィンドウを`lifetime`に設定します。このウィンドウを設定するには、次の手順を実行します。

1. **インテグレーション** タブの **In-app event postbacks** セクションに移動します。
2. **アプリケーション内イベント ポストバック** トグルをアクティベートします。
3. **In-app event postback ウィンドウ**を **生存期間**に設定します。


   **Lifetime postback window:**
   ![AppsFlyer インテグレーション設定のアプリケーション内イベントポストバックウィンドウ設定](/api/media?file=/grow/media/images/appsflyer-lifetime-postback-window.png)

### Click-through lookback Windowsは2日以上必要##click-through-lookback-windows-must-be-at-least-2-days

この検証ルールを満たすには、クリックスルー ルックバック ウィンドウを`2` daysに設定します。このウィンドウを設定するには、次の手順を実行します。

1. **インテグレーション** タブの **Install attribution** セクションに移動します。
2. **Install engaged click-through lookback ウィンドウ** セクションで、**Days を**選択します。
3. スライダーを使用して、ウィンドウを **2** **Days** に設定します。


   **2-day click-through lookback window:**
   ![AppsFlyer インテグレーション設定のインストール連動型クリックバックウィンドウ設定。](/api/media?file=/grow/media/images/appsflyer-click-through-lookback.png)

### ビュースルー Lookback Windows は少なくとも 7 日間##view-through-lookback-windows-must-be-at-least-7-days

この検証ルールを満たすには、ビュースルー ルックバック ウィンドウを`7`日に設定します。このウィンドウを設定するには、次の手順を実行します。

1. **インテグレーション** タブの **Install attribution** セクションに移動します。
2. **Install engaged view-through lookback ウィンドウ** セクションで、**Days を**選択します。
3. スライダーを使用して、ウィンドウを **7** **Days** に設定します。
4. **Install view-through attribution** トグルをアクティブ化します。


   **7-day view-through lookback window:**
   ![AppsFlyer インテグレーション設定のインストール連動ビュースルールックバックウィンドウ設定](/api/media?file=/grow/media/images/appsflyer-view-through-lookback.png)

### ビューアトリビューションを有効にする必要があります##view-through-attribution-must-be-enabled

この検証ルールを満たすには、AppsFlyer のインテグレーション設定でビューアトリビューションを有効にしてください。ビューアトリビューションを有効にするには、以下の手順に従います。

1. **インテグレーション** タブの **Install attribution** セクションに移動します。
2. 「**Install engaged view-through lookback window**」セクションに従って、「**Install view-through attribution**」トグルをアクティベートします。


   **View-through attribution enabled:**
   ![AppsFlyer インテグレーション設定のインストールビュースルーアトリビューショントグル。](/api/media?file=/grow/media/images/appsflyer-view-through-lookback.png)

### レベル完了イベントのポストバックには値を含める必要がある##level-complete-event-postbacks-must-contain-values

この検証ルールを満たすには、AppsFlyerインテグレーション設定でレベル完了イベントをマップするときに、「**Values & revenue**（値と収益）」を選択するようにしてください。このデータ共有設定を行うには、次の手順を実行します。

1. **インテグレーション** タブの **In-app event postbacks** セクションに移動します。
2. **アプリケーション内イベント ポストバック** トグルをアクティベートします。
3. マッピング テーブルの **［include］** カラムで、**［Values & revenue**］ を選択します。

以下の正しいマッピングの例を参照してください。

| AppsFlyer event     | パートナーイベントにマップ    | for users from                                              | 含める                     |
| ------------------- | ---------------- | ----------------------------------------------------------- | ----------------------- |
| `af_level_achieved` | `level_complete` | All media sources, including organic (オーガニックを含むすべてのメディアソース) | Values & revenue (値、収益) |


**Share Level Complete event values and revenue:**
![AppsFlyer イベントマッピングテーブルの値と収益の選択](/api/media?file=/grow/media/images/appsflyer-values-and-revenue.png)

### 購入イベントポストバックには値を含める必要がある##purchase-event-postbacks-must-contain-values

この検証ルールを満たすには、AppsFlyerインテグレーション設定で購入イベントをマップするときに、「**Values & revenue**（値と収益）」を選択するようにしてください。このデータ共有設定を行うには、次の手順を実行します。

1. **インテグレーション** タブの **In-app event postbacks** セクションに移動します。
2. **アプリケーション内イベント ポストバック** トグルをアクティベートします。
3. マッピング テーブルの **［include］** カラムで、**［Values & revenue**］ を選択します。

以下の正しいマッピングの例を参照してください。

| AppsFlyer event | パートナーイベントにマップ | for users from                                              | 含める                     |
| --------------- | ------------- | ----------------------------------------------------------- | ----------------------- |
| `af_purchase`   | `purchase`    | All media sources, including organic (オーガニックを含むすべてのメディアソース) | Values & revenue (値、収益) |


**Share Purchase event values and revenue:**
![AppsFlyer イベントマッピングテーブルの値と収益の選択](/api/media?file=/grow/media/images/appsflyer-values-and-revenue.png)

### Revenueイベント ポストバックには値を含める必要があります##revenue-event-postbacks-must-contain-values

> **Important:**
>
> AppsFlyerで広告収益イベントをマップするには、最初に[広告収益の共有を有効にする](#campaigns-must-receive-one-or-more-ad-revenue-postbacks)必要があります。詳細や手順については、[AppsFlyer の広告収益アトリビューション](https://support.appsflyer.com/hc/en-us/articles/217490046-ROI360-guide-ad-revenue-attribution#connect-to-ad-revenue-integrated-partners) に関するドキュメントを参照してください。

この検証ルールを満たすには、AppsFlyerのインテグレーション設定で広告収益イベントをマップするときに、「**Values & revenue**（値と収益）」を選択するようにしてください。このデータ共有設定を構成するには、AppsFlyerのインテグレーション設定の**インテグレーション**タブで以下の手順に従います。

1. **インテグレーション** タブの **In-app event postbacks** セクションに移動します。
2. **アプリケーション内イベント ポストバック** トグルをアクティベートします。
3. マッピング テーブルの **［include］** カラムで、**［Values & revenue**］ を選択します。

以下の正しいマッピングの例を参照してください。

| AppsFlyer event | パートナーイベントにマップ | for users from                                              | 含める                     |
| --------------- | ------------- | ----------------------------------------------------------- | ----------------------- |
| `af_ad_revenue` | `ad_revenue`  | All media sources, including organic (オーガニックを含むすべてのメディアソース) | Values & revenue (値、収益) |


**Share Ad Revenue event values and revenue:**
![AppsFlyer イベントマッピングテーブルの値と収益の選択](/api/media?file=/grow/media/images/appsflyer-values-and-revenue.png)

### セッション イベント ポストバックには値を含める必要がある##session-event-postbacks-must-contain-values

この検証ルールを満たすには、AppsFlyerのインテグレーション設定でセッションイベントをマップするときに、「**Values & no revenue**（値と収益なし）」を選択するようにしてください。このデータ共有設定を行うには、次の手順を実行します。

1. **インテグレーション** タブの **In-app event postbacks** セクションに移動します。
2. **アプリケーション内イベント ポストバック** トグルをアクティベートします。
3. マッピング テーブルの **［include］** カラムで、**［Values & no revenue**］ を選択します。

以下の正しいマッピングの例を参照してください。

| AppsFlyer event | パートナーイベントにマップ | for users from                                              | 含める                 |
| --------------- | ------------- | ----------------------------------------------------------- | ------------------- |
| `af_app_opened` | `session`     | All media sources, including organic (オーガニックを含むすべてのメディアソース) | Values & no revenue |


**Share Session event values only:**
![AppsFlyer イベントマッピングテーブルの値と収益の選択なし。](/api/media?file=/grow/media/images/appsflyer-values-no-revenue.png)

### 購入イベントポストバックが正しくマッピングされている必要がある##purchase-event-postbacks-must-be-mapped-correctly

この検証ルールを満たすには、AppsFlyerのインテグレーション設定で購入イベントを正しくマップしてください。購入イベントのポストバックをマップするには、次の手順に従います。

1. **インテグレーション** タブの **In-app event postbacks** セクションに移動します。
2. **アプリケーション内イベント ポストバック** トグルをアクティベートします。
3. 購入イベント行を次のようにマップします。

| AppsFlyer event | パートナーイベントにマップ | for users from                                              | 含める                     |
| --------------- | ------------- | ----------------------------------------------------------- | ----------------------- |
| `af_purchase`   | `purchase`    | All media sources, including organic (オーガニックを含むすべてのメディアソース) | Values & revenue (値、収益) |


**Purchase event mapping for In-app Purchase campaigns:**
![AppsFlyer インテグレーション設定のイベントマッピングテーブル](/api/media?file=/user-acquisition/media/images/appsflyer-purchase-event-mapping.png)

### AppsFlyer イベントは正しい Unity イベント名にマップされる必要がある##appsflyer-events-must-be-mapped-to-the-correct-unity-event-name

この検証ルールを満たすには、すべてのAppsFlyerイベントポストバックが正しくマップされていることを確認します。イベントをマップするには、次の手順を実行します。

1. **インテグレーション** タブの **In-app event postbacks** セクションに移動します。
2. **アプリケーション内イベント ポストバック** トグルをアクティベートします。
3. 次のように、**mapped to partner event**列でインストール後のイベントをUnityイベントにマップします。
   * `session`へのセッションイベント
   * レベル完了イベントを`level_complete`
   * `ad_revenue`に対する広告収益イベント
   * `purchase`へのアプリ内課金イベント

以下の正しいイベントマッピングの例を参照してください。

| AppsFlyer event           | パートナーイベントにマップ    | for users from                                              | 含める                     |
| ------------------------- | ---------------- | ----------------------------------------------------------- | ----------------------- |
| `af_purchase`             | `purchase`       | All media sources, including organic (オーガニックを含むすべてのメディアソース) | Values & revenue (値、収益) |
| `{custom_sdk_event_name}` | `level_complete` | All media sources, including organic                        | Values & revenue        |
| `af_app_opened`           | `session`        | All media sources, including organic                        | Values & no revenue     |
| `af_ad_revenue`           | `ad_revenue`     | All media sources, including organic                        | Values & revenue        |

> **Important:**
>
> AppsFlyerで広告収益イベントをマップするには、最初に[広告収益の共有を有効にする](#campaigns-must-receive-one-or-more-ad-revenue-postbacks)必要があります。詳細や手順については、[AppsFlyer の広告収益アトリビューション](https://support.appsflyer.com/hc/en-us/articles/217490046-ROI360-guide-ad-revenue-attribution#connect-to-ad-revenue-integrated-partners) に関するドキュメントを参照してください。

### アプリケーションは少なくとも1つのインストールポストバックを受け取る必要がある##app-must-receive-at-least-one-install-postback

この検証ルールを満たすには、デフォルトの**ポストバック**設定を正しく設定して、キャンペーンがインストールポストバックを受け取れるようにします。これらのAppsFlyerインテグレーション設定を以下のように設定します。

1. **インテグレーション** タブの **Default postbacks** セクションに移動します。
2. `Install`の行で、**for users from** (以下のユーザーの場合) ドロップダウンで、**All media sources, including organic** を選択します。


   **Share all sources, including organic:**
   ![AppsFlyer インテグレーション設定のデフォルトのポストバックセクション。](/api/media?file=/grow/media/images/appsflyer-default-install-postbacks.png)

### キャンペーンでは、1 つ以上の広告収益ポストバックを受け取る必要があります。##campaigns-must-receive-one-or-more-ad-revenue-postbacks

この検証ルールを満たすには、AppsFlyerインテグレーション設定で広告収益データを有効にしてください。広告収益イベントデータをキャンペーンと共有するには、以下の手順を実行します。

1. AppsFlyer インテグレーション設定の **Ad revenue** (広告収益) タブに移動します。

2. **Get ad revenue data** トグルをアクティブ化します。


   **Get ad revenue toggle:**
   ![AppsFlyer インテグレーション設定の Ad revenue (広告収益) タブと Get ad revenue (広告収益の取得) トグル。](/api/media?file=/grow/media/images/appsflyer-get-ad-revenue.png)

3. AppsFlyer のダッシュボードのサイドメニューから **Settings** (設定) > **Revenue Settings** (収益設定) に進みます。

   > **Important:**
   >
   > **Revenue Settings** メニューにアクセスするには、AppsFlyer ROI360 サブスクリプションが必要です。詳細や手順については、[AppsFlyer の広告収益アトリビューション](https://support.appsflyer.com/hc/en-us/articles/217490046-ROI360-guide-ad-revenue-attribution#connect-to-ad-revenue-integrated-partners) に関するドキュメントを参照してください。

4. **Revenue settings** ページの **Ad revenue** タブで、**New ad revenue integration** を選択します。

5. 収益パートナーのリストから **Unity Ads** を選択します。

6. パートナー設定で、レポートタイプとして **Impression-level (via SDK)** with Device-level (via S2S API) を選択します。


   **AppsFlyer Revenue settings configuration:**
   ![AppsFlyer Ad の収益パートナー設定のデバイスレベルオプションを使用したインプレッションレベル。](/api/media?file=/grow/media/images/appsflyer-ad-revenue-setup.png)

7. API 認証情報を入力します。**アプリケーション キー** フィールドに[ゲーム ID](/grow/acquire/get-started/retrieve-your-advertiser-game-id.md) を入力します。Unity Dashboard から**秘密鍵**を取得するには、以下の手順を参照してください。

**Retrieve your Secret key:**

Unity Dashboard から秘密鍵を取得するには、以下の手順を実行します。

1. 左側のナビゲーションメニューから **API Management** (API 管理) に進みます。

2. **Advertising Management API** (広告管理 API)> **Service account** (サービスアカウント) を選択します。


   **Advertising Management Service account:**
   ![ユーザー獲得ダッシュボードの API 管理ページ。](/api/media?file=/grow/media/images/api-service-account.png)

3. サービスアカウントがない場合は、**+ New (**+ 新規) を選択します。すでにサービスアカウントがある場合は、テーブルから選択します。

4. サービスアカウントページで **Keys (キー**) セクションに進みます。

5. **+ Add キー** (+ キーの追加) を選択して新しいキーを生成します。

6. **秘密鍵**の後にあるコピー用ボタンを選択して ID をコピーします。

### キャンペーンでは、1 つ以上のアプリ内課金ポストバックを受け取る必要があります。##campaigns-must-receive-one-or-more-in-app-purchase-postbacks

この検証ルールを満たすには、AppsFlyerのインテグレーション設定で購入イベントを正しくマップしてください。購入イベントのポストバックをマップするには、次の手順に従います。

1. **インテグレーション** タブの **In-app event postbacks** セクションに移動します。
2. **アプリケーション内イベント ポストバック** トグルをアクティベートします。
3. 購入イベント行を次のようにマップします。

| AppsFlyer event | パートナーイベントにマップ | for users from                                              | 含める                     |
| --------------- | ------------- | ----------------------------------------------------------- | ----------------------- |
| `af_purchase`   | `purchase`    | All media sources, including organic (オーガニックを含むすべてのメディアソース) | Values & revenue (値、収益) |


**Purchase event mapping for In-app Purchase campaigns:**
![AppsFlyer インテグレーション設定のイベントマッピングテーブル](/api/media?file=/user-acquisition/media/images/appsflyer-purchase-event-mapping.png)

## 推奨解像度##recommended-resolutions

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

### すべてのソースからのユーザーに対するインストールイベントポストバックの送信##send-install-event-postbacks-for-users-from-all-sources

この推奨されるインテグレーション規則を満たすには、すべてのメディアソース**のユーザーに**インストールイベントのポストバックを送信するようにしてください。これを行うには、以下のステップに従います。

1. AppsFlyerインテグレーションの**インテグレーション**タブの**デフォルトのポスト**バックセクションに移動します。
2. ドロップダウンから **for users を**使用して、Install イベントに **All media sources, including organic** を選択します。


**Share all install postbacks for users from all media sources, including organic:**
![AppsFlyer インテグレーションタブのデフォルトのポストバックセクション。](/api/media?file=/grow/media/images/appsflyer-default-install-postbacks.png)

### すべてのソースからのユーザーにインストール後イベントポストバックを送信する##send-post-install-event-postbacks-for-users-from-all-sources

インストール後イベントの推奨インテグレーション規則をすべて満たすには、イベントをマップするときに、**すべてのメディアソース**からのユーザーに対するイベントポストバックを共有してください。これを行うには、以下のステップに従います。

1. **インテグレーション** タブの **In-app event postbacks** セクションに移動します。
2. **アプリケーション内イベント ポストバック** トグルをアクティベートします。
3. ［**for users from］** カラムで、以下の各イベント タイプに対して **All media sources， including organic** を選択します。

   * `purchase`
   * `ad_revenue`
   * `level_complete`
   * `session`


   **Share post-install event postbacks for users from all media sources, including organic:**
   ![AppsFlyer イベントマッピングテーブルのオーガニック選択を含む、すべてのメディアソース。](/api/media?file=/grow/media/images/appsflyer-for-users-from-dropdown.png)