# 統合の基本

> MMP と Unity Ads User Acquisition の統合の基本について説明します。

モバイル計測パートナー (MMP) とは何か、Unity Ads ユーザー獲得キャンペーンでどのようなデータを共有できるかなど、重要なパートナー統合の概念を確認します。

## モバイル計測パートナー##mobile-measurement-partners

MMP はアトリビューションパートナーとも呼ばれ、アプリ内のユーザーインタラクションを追跡してアトリビュートするサードパーティのプラットフォームです。MMP は以下のような重要な User Acquisition タスクを可能にします。

* インストールを [アトリビュートする](./attribution/attribution-links.md)。
* 広告メトリクスやインストール後イベントなどの主要な [アプリデータ](./app-data/app-data.md) を渡す。
* [広告費回収率](../campaigns/roas/return-on-ad-spend-campaigns) (ROAS) や [イベント](../campaigns/event/event-campaigns)など、最適化されたキャンペーン目標を使用します。

### サポートされているパートナー##supported-partners

Unity は以下の MMP との統合をサポートしています。

| Adjust     | [Unity Ads の設定](https://help.adjust.com/en/partner-setup/unity-ads) (Adjust ヘルプセンター)                                                      |
| ---------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
| AirBridge  | [Unity Ads](https://help.airbridge.io/en/guides/unityads) (Airbridge ヘルプセンター)                                                             |
| AppsFlyer  | [Unity Ads キャンペーン設定](https://support.appsflyer.com/hc/en-us/articles/208005086-Unity-Ads-campaign-configuration) (AppsFlyer ヘルプセンター)      |
| Branch     | [Unity Ads](https://help.branch.io/partners-portal/docs/unity-ads) (Branch ヘルプセンター)                                                       |
| ByteBrew   | [Unity Ads アトリビューション](https://docs.bytebrew.io/attribution-setup/attribution-unityads) (ByteBrew Developer Hub)                           |
| Kochava    | [Unity – SDK 統合](https://support.kochava.com/articles/sdk-integration/21253-unity-sdk-integration/) (Kochava サポート)                        |
| Singular   | [Unity Ads アトリビューション統合](https://support.singular.net/hc/en-us/articles/360028964651-Unity-Ads-Attribution-Integration) (Singular ヘルプセンター) |
| Tenjin     | [Unity Ads](https://docs.tenjin.com/docs/unity-ads) (Tenjin ヘルプセンター)                                                                      |
| Yandex Ads | [Yandex Mobile Ads SDK for Unity](https://ads.yandex.com/helpcenter/en/dev/unity) (Yandex ヘルプセンター)                                        |

## アトリビューション##attribution

ユーザーがアプリをインストールすると、MMP はインストールを 3 つのカテゴリのどれかにアトリビュートします。

* アトリビュート: ユーザーはアプリをインストールする前に Unity Ads 経由で広告を視聴しました。
* 非アトリビュート: ユーザーはアプリをインストールする前に他の広告ネットワーク経由で広告を視聴しました。
* オーガニック: ユーザーは広告を視聴せずにアプリをインストールしました。

> **Important:**
>
> 希望する MMP と統合する際は、すべてのアトリビューションソースからのインストールデータを共有するようにしてください。これにより、キャンペーンはユーザーベース全体から学習でき、パフォーマンス向上につながります。

## アプリデータ##app-data

MMP はアプリデータを Unity に渡し、ユーザー獲得キャンペーンに情報を提供します。Unity Ads ユーザー獲得キャンペーンには 2 種類のデータが必要です。

| 広告メトリクス         | ユーザーが広告にどのように反応したかを示します。          | * 広告の開始 (インプレッション)
* 広告の完了 (視聴数)
* クリック数
* インストール |
| --------------- | --------------------------------- | ------------------------------------------------- |
| インストール後のイベントデータ | ユーザーがアプリのインストール後にどのように行動したかを示します。 | - セッション
- 購入
- 広告収益
- レベル完了                       |

各データの種類の詳細については、以下のタブを確認してください。

1. **Ad metrics**

   ### 広告メトリクス

   広告メトリクスは、Unity に重要な広告キャンペーンデータを提供します。これらのメトリクスは、ユーザーによる広告への具体的なインタラクションを表します。

   MMP がすべてのキャンペーンで以下の広告メトリクスを Unity に送信できるようにしてください。

   | 開始     | 広告の視聴を開始した。      | 開始はインプレッションとも呼ばれます。                                                                                                                                      |
   | ------ | ---------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
   | クリック   | 広告の CTA をクリックした。 |                                                                                                                                                          |
   | インストール | アプリをインストールした。    | アトリビュート、非アトリビュート、オーガニックのインストールデータを Unity と共有するようにしてください。詳細については、[アトリビューションの概要](/grow/acquire/partner-integration/attribution/introduction.md) を参照してください。 |

   > **Note:**
   >
   > 広告メトリクスをキャンペーンで共有するための推奨されるベストプラクティスは、MMP を使用することです。カスタムのサーバー間統合は、エラーが発生しやすくサポートも限られるため避けてください。

   パートナーごとの詳細な設定手順については、このドキュメントの [統合ガイド](./partner-integration-guides.md) を参照してください。

2. **Post-install event data**

   ### インストール後のイベントデータ

   インストール後のイベントデータは、ユーザーがアプリインストール後にどのようにアプリを操作したかを表します。このデータはキャンペーン目標の最適化を可能にします。

   MMP が以下の種類のインストール後イベントデータを渡せるようにしてください。

   | セッション /Session | インストール後もアプリを継続して利用した。 | 最適化されたキャンペーンには必ずセッションイベントを加えてください。セッションイベントデータによりデータモデルが改善され、キャンペーンのパフォーマンス向上につながります。                                                                                                                                                                    |
   | -------------- | --------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
   | 課金             | 購入を行った。               | 購入イベントを共有する際は、価値と収益の両方を加えます。購入イベントを正しく [マップ](./integration-best-practices.md#map-post-install-events-correctly) してください。名前のマッピングが誤っているイベントはキャンペーンで無視されます。                                                                                                 |
   | 広告収益           | 広告の視聴を開始した。           | 購入イベントを共有する際は、価値と収益の両方を加えます。Singular 以外の MMP を使用している場合、広告収益イベントをアプリ内課金 (IAP) イベントとしてマップしないでください。MMP で広告収益データの共有がサポートされている場合、このデータを専用の広告収益イベントとして送信してください。MMP で広告収益データの共有がサポートされていない場合は、広告収益を異なるイベントの種類として送信しないでください。イベントの不一致が原因でキャンペーンの最適化が停止する可能性があります。 |

## 最適化されたキャンペーン目標##optimized-campaign-goals

最適化されたキャンペーン目標には [広告費回収率 (ROAS)](../campaigns/roas/return-on-ad-spend-campaigns) や [イベント](../campaigns/event/event-campaigns) などがあり、それぞれ特定のイベントデータが必要です。このデータを Unity に渡さない場合、これらのキャンペーンは User Acquisition (ユーザー獲得) ダッシュボードで利用できません。最適化されたキャンペーンへのアクセスの詳細については、[ROAS キャンペーンの概要](../campaigns/roas/intro-to-roas-campaigns) を参照してください。

最適化された各キャンペーン目標の有効化に必要なインストール後イベントデータについては、以下の表を参照してください。

| セッション /Session | インストール後もアプリを継続して利用した。 | [リテンション](/grow/acquire/campaigns/retention/retention-campaigns.md)                                                                                                                                                                  |
| -------------- | --------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 課金             | 購入を行った。               | * [アプリ内課金 (IAP) 広告費回収率 (ROAS)](/grow/acquire/campaigns/roas/purchase/in-app-purchase.md)
* [ハイブリッド ROAS](/grow/acquire/campaigns/roas/hybrid/hybrid.md)
* [課金ユーザー](/grow/acquire/campaigns/event/intro-to-event-campaigns.md#payer) |
| 広告収益           | 広告の視聴を開始した。           | - [広告収益 ROAS](/grow/acquire/campaigns/roas/ad-revenue/ad-revenue.md)
- [ハイブリッド ROAS](/grow/acquire/campaigns/roas/hybrid/hybrid.md)                                                                                                 |
| 完了マイルストーン      | 特定のレベルやマイルストーンに到達した。  | [レベル完了](/grow/acquire/campaigns/event/intro-to-event-campaigns.md#level-complete)                                                                                                                                                   |

> **Note:**
>
> [イベント最適化](/grow/acquire/campaigns/event/event-campaigns.md.md)キャンペーン(リテンション、課金ユーザー、レベル完了)を実行するには、以下のMMPのいずれかを使用する必要があります。
>
> * Adjust
> * AppsFlyer
> * Singular
