# Tenjin と Unity の統合

> Tenjin のダッシュボードで Unity Ads 統合をアクティブ化し、完全なデータ共有を有効にします。

> **Important:**
>
> 以下のドキュメントでは、Unity が開発、所有、または運用するものではない製品またはサービス ("サードパーティ製品") を取り上げます。
> その情報は、古かったり、不完全であったりする可能性がありますが、利便性のために提供しています。
> サードパーティ製品を使用する際は、その製品の規約に従うものとします。
> Unity はそれらの製品に関して一切保証を行わず、その使用によって生じた損害や損失 (サードパーティプロバイダーのコンテンツ、広告、製品、資料に関する問題を含む) について責任を負いません。

Unity のユーザー獲得キャンペーン用に、Tenjin をモバイル計測パートナー (MMP) として設定します。統合には以下の設定タスクがあります。

* [Unity Dashboard から認証情報をコピーする](#copy-credentials-from-the-unity-dashboard)。
* [Tenjin のダッシュボードで Unity Ads をアクティブ化する](#activate-unity-ads-in-the-tenjin-dashboard)。
* [データ共有設定を行う](#configure-data-sharing-settings)。

Tenjin との統合の最新情報については、[Tenjin のヘルプセンター](https://docs.tenjin.com/docs/unity-ads) を参照してください。

## 前提条件##prerequisites

設定前に、以下の要件を満たしていることを確認してください。

* [Unity ユーザー獲得ダッシュボード](https://cloud.unity.com/acquire) に少なくとも 1 つのアプリケーションを[追加する](../../getting-started/add-an-app#add-an-app-to-the-dashboard)。
* Unity Dashboard で **Organization Owner** または **Organization Manager** のアクセスを有効にする。詳細については、[ユーザータイプ、ロール、権限](/cloud/organizations/roles-and-permissions.md) を参照してください。
* 最新バージョンの [Tenjin SDK](https://github.com/tenjin/tenjin-unity-sdk) をダウンロードする。

## Tenjin と Unity Ads の統合##integrate-unity-ads-with-tenjin

Tenjin をユーザー獲得キャンペーンに統合するために、以下の手順を実行します。

### Unity Dashboard から認証情報をコピーする##copy-credentials-from-the-unity-dashboard

Tenjin の統合を完了するには、以下の Unity アカウント認証情報が必要です。

1. **Game ID**

   #### ゲーム ID

   **User Acquisition** (ユーザー獲得) ダッシュボードの **Apps** (アプリ) ページから [ゲーム ID](../../getting-started/locate-advertiser-credentials#game-id) を取得するには、以下の手順を実行します。

   1. ダッシュボードの左側ナビゲーションメニューから **Apps** (アプリ) に移動します。表示されるテーブルには、組織の各アプリがリストされています。各アプリ名の後に、ダッシュボードでアプリのプラットフォームとゲーム ID が表示されます。
   2. ID の横にある **Copy** (コピー) アイコンを選択してクリップボードにコピーします。
   3. 必要に応じて、アプリ名にカーソルを合わせて **Campaign Set ID** (キャンペーンセット ID) や **Store ID** (ストア ID) もコピーできます。

   > **Note:**
   >
   > User Acquisition (ユーザー獲得) ダッシュボードに表示されているゲーム ID を正確に入力してください。ゲーム ID が一致しない場合、Unity でイベントを正しく受信できません。

2. **Secret Key and Key ID**

   #### 秘密鍵とキー ID

   > **Note:**
   >
   > **Organization Owner** または **Organization Manager** のみがサービスアカウントと秘密鍵を作成できます。詳細については、[ユーザータイプ、ロール、権限](/cloud/organizations/roles-and-permissions.md) を参照してください。

   **User Acquisition** (ユーザー獲得) ダッシュボードから秘密鍵とキー ID を取得するには、以下の手順を実行します。

   1. 左側のナビゲーションメニューから **API Management** (API 管理) に進みます。
   2. **Advertising Management API** (広告管理 API) > **Service account** (サービスアカウント) を選択します。
      ![ユーザー獲得ダッシュボードの API 管理ページ。](/api/media?file=/user-acquisition/media/images/api-service-account.png)
   3. サービスアカウントがない場合は、**+ New** (+ 新規) を選択します。すでにサービスアカウントがある場合は、テーブルから選択します。
   4. サービスアカウントページで **Keys** (キー) セクションに進みます。
      5.**+ Add key** (+ キーの追加) を選択して両方のキーを生成します。
      6.**Key ID** (キー ID) と **Secret key** (秘密鍵) の後にあるコピー用ボタンを選択して、両方の認証情報をコピーします。

3. **Organization core ID**

   #### 組織コア ID

   User Acquisition (ユーザー獲得) ダッシュボードの **Settings** (設定) ページから組織コア ID を取得するには、以下の手順を実行します。

   1. **Settings** (設定) ページの **Organization** (組織) セクションに移動します。
   2. **Organization core ID** (組織コア ID) の横にある数字の ID をコピーします。

   > **Note:**
   >
   > 数字の **Organization core ID** (組織コア ID) をコピーし、英数字の **Organization ID** (組織 ID) はコピーしないように注意してください。

### Tenjin のダッシュボードで Unity Ads をアクティブ化する##activate-unity-ads-in-the-tenjin-dashboard

[Tenjin のダッシュボード](https://dashboard.tenjin.com/) で Unity と Tenjin を統合するには、以下の手順を実行してください。

1. **Configure** タブに移動し、**Channels** を選択します。
2. **Marketing Channel Name** フィールドで **Unity Ads** を検索します。
3. Unity Ads の **New Marketing Channel** 設定で、Unity のダッシュボードからコピーした Unity アカウントの認証情報を入力し、アカウント名を指定します。
4. Tenjin ナビゲーションメニューで **Campaigns** タブに移動し、**Create Campaign** を選択します。
5. **Marketing Account** ドロップダウンで **Unity Ads** を選択します。
6. **App** ドロップダウンからアプリを選択し、**Name** でキャンペーンにわかりやすい名前を付けます。
7. **Callback to be created** というメッセージが表示されたら、提示されたリンクに従って続行し、トラッキング URL を生成します。

### データ共有設定を行う##configure-data-sharing-settings

Tenjin では、データ共有設定を行うことで、アプリ内イベントもマップされます。Tenjin でデータ共有設定を行ってイベントをマップするには、アクティブ化ワークフローの完了時に以下を実行します。

1. **Callback to be created** メッセージのリンクをクリックした後、**Channels and Partners** ドロップダウンから **Unity Ads** を選択します。
2. **Channel callbacks** セクションで、以下のトグルをアクティブ化します。

* **Unity Ads ad revenue**
* **Unity Ads app open**
* **Unity Ads IAP**
* **Unity Ads install**

> **Important:**
>
> 広告収益イベントを **In-App Purchase** イベントとしてマップしないでください。Tenjin アカウントで広告収益データの共有がサポートされている場合、このデータを専用の **Ad Revenue Impression** イベントとして送信してください。
>
> アカウントで広告収益データの共有がサポートされていない場合は、広告収益を異なるイベントの種類として送信しないでください。イベントの不一致が原因でキャンペーンの最適化が停止する可能性があります。

3. 各イベントコールバックについて、**all users** を **User filter** ドロップダウンから選択します。

![Tenjin インテグレーション設定のチャンネルコールバックページ。](/api/media?file=/user-acquisition/media/images/tenjin-channel-callbacks.png)