# ByteBrew と Unity の統合

> ユーザー獲得キャンペーンを ByteBrew と統合して、アプリからのエンゲージメントデータとインストール後のイベントデータを渡します。

ByteBrew と統合すると、広告キャンペーンのために、インストールを追跡したり、インストール後のイベントポストバックを受信したりできます。ByteBrew の統合に関する最新情報については、[ByteBrew Developer Hub](https://docs.bytebrew.io/attribution-setup/attribution-unityads) を参照してください。

Unity と ByteBrew の統合をアクティベートするには、以下のタスクを実行します。

1. Unity の User Acquisition (ユーザー獲得) ダッシュボードで [サービスアカウント](#create-a-service-account) を作成します。
2. ダッシュボードのサービスアカウント設定で [API キー](#create-api-keys) を作成します。
3. ByteBrew ダッシュボードで [インテグレーションワークフロー](#complete-the-bytebrew-integration-workflow) を完了します。

## 前提条件##prerequisites

* [Unity ユーザー獲得ダッシュボード](https://cloud.unity.com/acquire) に 1 つ以上のアプリケーションを [追加](/user-acquisition/getting-started/add-an-app.md) します。
* アプリで ByteBrew SDK を初期化します。初期化手順の詳細については、ByteBrew の [Unity SDK](https://docs.bytebrew.io/sdk/unity) 統合ガイドを参照してください。

## サービスアカウントの作成##create-a-service-account

サービスアカウントがあると、ByteBrew との統合で [Unity 広告統計 API](https://services.docs.unity.com/statistics/v2/index.html) を使用できます。サービスアカウントを作成するには、Unity の User Acquisition (ユーザー獲得) ダッシュボードで以下の手順を実行します。

1. 左側のナビゲーション メニューから、**API Management** (API 管理) を選択します。
2. 統計 API の v2.0 セクションで、**Service account** (サービスアカウント) を選択します。
3. **Service Accounts** (サービスアカウント) ページの右上隅で、**+ New** (+ 新規) を選択して **Create service account** (サービスアカウントの作成) ダイアログを開き、新しいサービスアカウントを作成します。
4. **Service account name** (サービスアカウント名) と **Service account description** (サービスアカウントの説明) を入力します。以下の名前と説明の例を参照してください。

* **サービスアカウント名**: ByteBrew アトリビューション
* **サービスアカウントの説明**: ByteBrew アトリビューションキャンペーンのメタデータのプル

5. **Create** (作成) を選択して設定を保存し、新しいサービスアカウントを **Service Accounts** (サービスアカウント) ページのリストに追加します。

## API キーの作成##create-api-keys

ByteBrew との統合で Unity 統計 API からのプログラムデータ共有を有効にするには、サービスアカウント設定で **Key ID** (キー ID) と **Secret Key** (秘密鍵) の 2 つの API キーを作成する必要があります。

これらのキーを作成するには、Unity Dashboard の **Organization** (組織) > **Service accounts** (サービスアカウント) 設定で以下の手順を実行します。

1. 以前に作成したサービスアカウントを見つけて選択します。検索バーを使用してアカウントを検索できます。
2. **Keys** (キー) セクションで、**+ Add key** (+ キーの追加) を選択してキーを生成し、**New key has been created** (新しいキーが作成されました) ダイアログを開きます。
3. ByteBrew ダッシュボードでの統合を完了するには、このダイアログの **Key ID** と **Secret key** の両方が必要です。両方のキーをコピーします。
4. **Done** (完了) を選択してダイアログを閉じます。

## ByteBrew インテグレーションワークフローの完了##complete-the-bytebrew-integration-workflow

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

Unity Dashboard でサービスアカウントと API キーを作成したら、ByteBrew ダッシュボードに移動し、以下の手順を実行してインテグレーションの設定を完了します。

1. ダッシュボードのナビゲーションメニューからアプリを選択します。
2. **Attribution** (アトリビューション) > **Network Settings** (ネットワーク設定) に移動し、ネットワークのリストから **UnityAds** を見つけます。
3. **UnityAds** の横で **Setup** (設定) を選択し、**Add Ad Network** (広告ネットワークの追加) ダイアログを開きます。
4. **Network Settings** のフィールドに入力します。User Acquisition (ユーザー獲得) ダッシュボードでこれらの値を確認する方法については、以下のタブを参照してください。

1) **API Key**

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

   1. **API Management page** (API 管理ページ) に移動します。
   2. **Stats API v1.0** セクションの **API Key** をコピーします。

2) **Game ID**

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

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

3) **Organization ID**

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

   1. **Settings** (設定) ページに移動します。
   2. 設定の **Organization** (組織) セクションから **Organization ID** (組織 ID) をコピーします。

4) **Organization Core ID**

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

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

5. **Next** (次へ) を選択してダイアログの **Install Settings** (インストール設定) タブに進みます。
6. ビュースルーアトリビューションを有効にするには、**Enable view through tracking** (ビュースルーアトリビューションを有効にする) チェックボックスをオンにし、ビュースルールックバックウィンドウを設定します。ByteBrew はデフォルトでクリックスルートラッキング URL を生成します。
7. アトリビューションルックバックウィンドウは **Install Settings** の以下のフィールドで設定します。

| **クリックスルーウィンドウ**        | はい  | **Days** (日数) セレクターを使用して、ユーザーが広告をクリックしてから何日後までインストールをアトリビューション可能であるかを設定します。 | クリックスルールックバックの最長期間は 30 日間です。推奨されるベストプラクティスは、正確なアトリビューションのためにクリックスルー設定を 7 日以上に設定することです。 |
| ----------------------- | --- | --------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- |
| **View-Through Window** | いいえ | **Days** (日数) セレクターを使用して、ユーザーが広告を視聴してから何日後までインストールをアトリビューション可能であるかを設定します。   | ビュースルールックバックの最長期間は 7 日間です。推奨されるベストプラクティスは、正確なアトリビューションのためにビュースルー設定を 1 日以上に設定することです。    |

アトリビューションルックバックオプションの詳細については、ByteBrew のデータ共有に関するリファレンスの [アトリビューションのルックアップ設定](/user-acquisition/partner-integration/bytebrew/data-sharing-reference.md#attribution-lookback-settings) セクションを参照してください。

8. **Send all install events from** (すべてのインストールイベントを送信) セクションで、アプリのすべてのインストール ([非アトリビュート](/user-acquisition/data-sharing/attribution/campaign-attribution-fundamentals.md) インストールデータを含む) のエンゲージメントデータを渡すか、Unity にアトリビュートするインストールのみを渡すかを選択します。以下のオプションを選択できます。

* **Only this partner (このパートナーのみ)**
* **すべてのパートナーとオーガニック**
* **このパートナーとオーガニック**

インストールデータソースオプションの詳細については、ByteBrew のデータ共有に関するリファレンスの [アトリビューションのデータソース](/user-acquisition/partner-integration/bytebrew/data-sharing-reference.md#attribution-data-sources) セクションを参照してください。

9. **Next** (次へ) を選択して、ダイアログの **Postback Settings** (ポストバック設定) タブに進みます。
10. Unity に渡すインストール後イベントを追加するには、**+ Add Postback Event** (+ ポストバックイベントの追加) を選択し、以下のオプションから選択します。

* Ad Watched Event (広告視聴イベント)
* User App Open Event (ユーザーアプリのオープンイベント)
* In-App Purchase Event (アプリ内課金イベント)

ポストバックイベントオプションの詳細については、ByteBrew のデータ共有に関するリファレンスの [インストール後のイベントデータ共有のセクション](/user-acquisition/partner-integration/bytebrew/data-sharing-reference.md) を参照してください。

> **Important:**
>
> アプリコードに新しいユーザーイベントを定義しないでください。ByteBrew は、デフォルトで **User App Open Event** オプションを使用して新しいユーザーイベントを追跡します。詳細については、[ByteBrew Developer Hub](https://docs.bytebrew.io/attribution-setup/attribution-unityads) のアトリビューションに関するドキュメントを参照してください。

11. **Postback Events Settings** (ポストバックイベント設定) セクションで、アプリのすべてのインストール ([非アトリビュート](/user-acquisition/data-sharing/attribution/campaign-attribution-fundamentals.md) インストールデータを含む) からのインストール後イベントデータを渡すか、Unity にアトリビュートするインストールデータのみを渡すかを選択します。以下のオプションを選択できます。

* Send only from this partner (このパートナーからのみ送信)
* Send from all Networks and Organics (すべてのネットワークとオーガニックから送信)
* Send only from this Partner and Organics (このパートナーとオーガニックからのみ送信)

インストール後イベントデータのソースオプションの詳細については、ByteBrew のデータ共有に関するリファレンスの [ポストバックのデータソース](/user-acquisition/partner-integration/bytebrew/data-sharing-reference.md#postback-data-sources) セクションを参照してください。

12. ネットワーク設定ダイアログの最後のタブで、トラッキング URL をコピーできます。User Acquisition ダッシュボードでこれらの URL を統合する手順については、[トラッキング URL と Unity の統合](/user-acquisition/data-sharing/attribution/integrate-attribution-links.md) を参照してください。
13. **Finish** (終了) を選択してインテグレーションを完了します。