# インテグレーションのベストプラクティス

> 必要なデータがキャンペーンと共有されるように、統合を正しく設定してください。

ご希望のモバイル計測パートナー (MMP) を Unity ユーザー獲得キャンペーンと統合する際は、インテグレーションの設定を正しく行ってください。キャンペーンで必要なデータを受け取れるように、これらのベストプラクティスに従う必要があります。正しいデータを送信しないと、キャンペーンのパフォーマンスに悪影響を及ぼす可能性があります。

統合の設定を完了する際は、以下のベストプラクティスを参考にして、データ共有設定を正しく行ってください。

## すべてのソースからのインストールデータを共有する##share-install-data-from-all-sources

Unity とインストールデータを共有する際は、アトリビュート、非アトリビュート、オーガニックインストールを含むユーザーベース全体からのデータを必ず加えてください。各アトリビューションの種類の定義については、アトリビューションの[概要](/user-acquisition/data-sharing/attribution/campaign-attribution-fundamentals.md#attribution-types) を参照してください。

この設定には 各 MMP 固有の用語が使用されています。サポートされている MMP ダッシュボードですべてのソースからのデータを共有する方法を示す、以下の例を参照してください。

1. **Adjust**

   ### Adjust ですべてのソースからのデータを共有する

   Adjust のダッシュボードですべてのソースからのデータを共有する手順は以下のとおりです。

   1. **Campaign Lab** タブ > **Partners** ページに移動します。
   2. **What sources of data do you want to share** のオプションから **Data from all attribution sources** を選択します。

2. **AppsFlyer**

   ### AppsFlyer ですべてのソースからのデータを共有する

   AppsFlyer のダッシュボードですべてのソースからのデータを共有する手順は以下のとおりです。

   1. **Integration** タブ > **Default postbacks** セクションに移動します。
   2. **for users from** ドロップダウンから **All media sources, including organic** を選択します。

3. **Singular**

   ### Singular ですべてのソースからのデータを共有する

   Singular のダッシュボードですべてのソースからのデータを共有する手順は以下のとおです。

   1. **Attribution Postbacks & Settings** タブ > **Attribution Postbacks** テーブルに移動します。
   2. **Send All** チェックボックスをオンにします。

4. **Tenjin**

   ### Tenjin ですべてのソースからのデータを共有する

   Tenjin のダッシュボードですべてのソースからのデータを共有する手順は以下のとおりです。

   1. アプリの **Callbacks** タブに移動します。
   2. **User filter** ドロップダウンから **all users** を選択します。

## インストール後イベントを正しくマップする##map-post-install-events-correctly

[インストール後イベントデータ](/user-acquisition/data-sharing/post-install-event-data-sharing.md) をキャンペーンと共有する際は、インストール後イベントを正しくマップしてください。正しいマッピングとは、Unity のイベント名と MMP のイベント名を適切に対応させることを指します。

> **Warning:**
>
> Singular 以外の MMP を使用している場合、広告収益イベントとアプリ内課金 (IAP) イベントを組み合わせないでください。
>
> MMP アカウントで広告収益データの共有がサポートされている場合、このデータを専用の広告収益イベントとして送信してください。広告収益を別のイベントの種類として送信すると、キャンペーンの最適化が停止する可能性があります。
>
> 詳細なマッピング手順については、パートナーごとの [統合ガイド](./integration-guides.md) を参照してください。

以下の正しくマップされたイベント名の例を参照してください。

1. **Adjust**

   ### Adjust イベントマッピング

   Adjust 統合の **Map events to share with Unity Ads** セクションで、インストール後イベントを以下のようにマップします。

   > **Important:**
   >
   > Adjust アカウントで広告収益データの共有がサポートされている場合、このデータを専用の `ad_revenue` イベントとして送信してください。
   >
   > そうでない場合は、広告収益イベントを送信しないでください。広告収益イベントを他のイベントの種類 (`purchase` など) としてマッピングすると、キャンペーンの最適化が停止する可能性があります。

   | アプリ内課金 (IAP)   | `purchase`       | `purchase`               |
   | -------------- | ---------------- | ------------------------ |
   | マイルストーン達成      | `level_complete` | `{milestone_event_name}` |
   | セッション /Session | `session`        | `session`                |

2. **AppsFlyer**

   ### AppsFlyer イベントマッピング

   AppsFlyer 統合設定の **In-app event postbacks** テーブルで、インストール後イベントを以下のようにマップします。

   > **Important:**
   >
   > AppsFlyer アカウントで広告収益データの共有がサポートされている場合、**Ad revenue** タブの **Get ad revenue data** トグルでこのデータを送信してください。
   >
   > そうでない場合は、広告収益イベントを送信しないでください。広告収益イベントを他のイベントの種類 (`af_purchase` など) としてマッピングすると、キャンペーンの最適化が停止する可能性があります。

   | アプリ内課金 (IAP)   | `purchase`       | `af_purchase`            |
   | -------------- | ---------------- | ------------------------ |
   | マイルストーン達成      | `level_complete` | `{milestone_event_name}` |
   | セッション /Session | `session`        | `af_session`             |

3. **Singular**

   ### Singular イベントマッピング

   Singular 統合設定の **Revenue Events Postbacks** および **Events Postbacks** テーブルで、インストール後イベントを以下のようにマップします。

   > **Important:**
   >
   > Singular は、広告収益イベントとアプリ内課金 (IAP) イベントを同時に送信できる唯一の MMP です。Singular で広告収益イベントを送信するには、**Revenue Events Postbacks** ドロップダウンから **Send all ad monetization events** を選択し、**SDK Event Name** ドロップダウンから **`__REVENUE__*`** を選択します。

   | アプリ内課金 (IAP)   | `purchase`       | * `_iap_`
   * `{custom_purchase_event_name}` |
   | -------------- | ---------------- | ------------------------------------------ |
   | 広告収益           | `ad_revenue`     | `__REVENUE__*`                             |
   | マイルストーン達成      | `level_complete` | `{milestone_event_name}`                   |
   | セッション /Session | `session`        | `_SESSION_`                                |

4. **Tenjin**

   ### Tenjin イベントマッピング

   Tenjin 統合設定の **Channel Callbacks** ページで、インストール後イベントを以下のようにアクティブ化します。

   > **Important:**
   >
   > Tenjin アカウントで広告収益データの共有がサポートされている場合、このデータを専用の **Ad Revenue Impression** イベントとして送信してください。
   >
   > そうでない場合は、広告収益イベントを送信しないでください。広告収益を他のイベントの種類 (**In-app Purchase** (アプリ内課金) など) としてマッピングすると、キャンペーンの最適化が停止する可能性があります。

   | アプリ内課金 (IAP)   | `purchase`   | `In-app Purchase`       |
   | -------------- | ------------ | ----------------------- |
   | 広告収益           | `ad_revenue` | `Ad Revenue Impression` |
   | セッション /Session | `session`    | `Unity ads app open`    |

## 購入イベントと収益イベントでは、値と収益の両方を共有します。##share-both-values-and-revenue-for-purchase-and-revenue-events

購入または広告収益イベントのデータを Unity と共有する際は、イベントごとに値と収益の両方を必ず共有してください。この完全なデータを共有することで、Unity のユーザー獲得モデルが改善され、キャンペーンのパフォーマンス向上につながります。

これらの設定の用語は MMP によって異なる場合があります。以下の例を参照してください。

1. **AppsFlyer**

   ### AppsFlyer で値と収益を共有する

   インストール後イベントで値と収益の両方を共有するには、AppsFlyer のダッシュボードで以下の手順を実行します。

   1. **Integration** タブ > **In-app event postbacks** セクションに移動します。
   2. 各イベントの **including** ドロップダウンから **Values & revenue** を選択します。

2. **Singular**

   ### Singular で値と収益を共有する

   インストール後イベントで値と収益の両方を共有するには、Singular のダッシュボードで以下の手順を実行します。

   1. 統合設定の **In app Events Postback** タブに移動します。
   2. 各行の **Include Revenue** チェックボックスをオンにします。

## ポストバックウィンドウを生存期間 (lifetime) に設定する##set-postback-windows-to-lifetime

MMP で生存期間ポストバックウィンドウがサポートされている場合は、必ずウィンドウを生存期間に設定してください。それ以外の場合は、ポストバックウィンドウを最大の長さに設定します。ポストバックウィンドウを生存期間に設定することで、キャンペーンはアプリのインストール履歴全体から学習でき、パフォーマンス向上につながります。

ポストバックウィンドウ設定の用語は MMP によって異なる場合があります。以下の例を参照してください。

1. **AppsFlyer**

   ### AppsFlyer で生存期間ポストバックウィンドウを設定する

   AppsFlyer で生存期間ポストバックウィンドウを使用するには、統合設定の **In-app event settings** セクションで **In-app event postback window** を **lifetime** に設定してください。

2. **Singular**

   ### Singular で生存期間ポストバックウィンドウを設定する

   Singular で生存期間ポストバックウィンドウを設定するには、以下の手順を実行します。

   1. 統合設定の **In app Events Postback** タブに移動します。
   2. **Postback Window Starting Point** 列で、各イベントに対して **Unlimited** を選択します。
   3. Singular の [Enterprise](https://support.singular.net/hc/en-us/articles/115000483946-Partner-Configuration-and-Postbacks-FAQ-and-Troubleshooting#in_app_event_postbacks) アカウントがある場合は、**Postback Window (days)** を **Unlimited** に設定します。それ以外の場合は、ウィンドウを `30` 日間に設定します。