# 集成 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 User Acquisition（用户获取）后台](https://cloud.unity.com/acquire)[添加](/user-acquisition/getting-started/add-an-app.md)至少一个 app。
* 在应用中初始化 ByteBrew SDK。请参阅 ByteBrew 的 [Unity SDK](https://docs.bytebrew.io/sdk/unity) 集成指南，了解详细的初始化说明。

## 创建服务帐户##create-a-service-account

服务帐户允许您与 ByteBrew 集成时使用 [Unity Advertising Statistics API](https://services.docs.unity.com/statistics/v2/index.html)。要创建服务帐户，请在 Unity User Acquisition（用户获取）后台中执行以下操作：

1. 从左侧导航菜单中选择 **API Management（API 管理）**。
2. 在 Stats API v2.0 部分，选择 **Service account（服务帐户）**。
3. 在 \*\*Service Accounts（服务帐户）\*\*页面右上角，选择 **+ New（新建）**，打开 \*\*Create service account（创建服务帐户）\*\*对话框并新建服务帐户。
4. 在 \*\*Service account name（服务帐户名称）\*\*和 \*\*Service account description（服务帐户描述）\*\*字段中输入相应的内容。请参阅以下名称和描述示例：

* **Service account name（服务帐户名称）**：ByteBrew attribution（ByteBrew 归因）
* **Service account description（服务帐户描述）**：ByteBrew attribution campaign metadata pull（ByteBrew 归因广告系列元数据拉取）

5. 选择 \*\*Create（创建）\*\*以保存设置，并将新服务帐户添加到 \*\*Service Accounts（服务帐户）\*\*页面列表中。

## 创建 API 密钥##create-api-keys

要在 ByteBrew 集成中启用通过 Unity 统计数据 API 进行的程序化数据共享，必须在服务帐户设置中创建两个 API 密钥：\*\*Key ID（密钥 ID）\*\*和 **Secret Key（密钥）**。

要创建这些密钥，请在 Unity Dashboard（Unity 后台）的 **Organization（组织）**> \*\*Service accounts（服务帐户）\*\*设置中执行以下操作：

1. 查找并选择先前创建的服务帐户。您可以使用搜索栏查找帐户。
2. 在 \*\*Keys（密钥）\*\*部分中，选择 \*\*+ Add key（+ 添加密钥）\*\*以生成密钥，然后将打开 \*\*New key has created（已创建新密钥）\*\*对话框。
3. 您需要同时使用此对话框中的 \*\*Key ID（密钥 ID）\*\*和 \*\*Secret key（密钥）\*\*才能在 ByteBrew 后台中完成集成。复制这两个密钥。
4. 选择 \*\*Done（完成）\*\*以关闭对话框。

## 完成 ByteBrew 集成工作流程##complete-the-bytebrew-integration-workflow

> **Important:**
>
> 以下文档涉及非 Unity 开发、拥有或运营的产品或服务（“第三方产品”）。
> 这些信息可能已过时或不完整，仅为方便您参考才提供。
> 您对任何第三方产品的使用均受产品自身条款的约束。
> Unity 对这些产品不提供任何担保，也不对因使用这些产品而造成的任何损害或损失负责，包括与第三方供应商提供的内容、广告或材料有关的问题。

在 Unity Dashboard（Unity 后台）中创建服务帐户和 API 密钥后，请转到 ByteBrew 后台并执行以下操作来完成集成设置：

1. 从后台导航菜单中选择您的应用。
2. 转到 **Attribution（归因）**> **Network Settings（广告网络设置）**，然后从广告网络列表中找到 **UnityAds**。
3. 在 **UnityAds** 旁边，选择 \*\*Setup（设置）\*\*以打开 \*\*Add Ad Network（添加广告网络）\*\*对话框。
4. 填写 \*\*Network Settings（广告网络设置）\*\*字段。请参阅以下选项卡，了解在 User Acquisition（用户获取）后台中查找这些值的位置：

1) **API Key**

   如需从用户获取后台获取 API 密钥，请执行以下操作：

   1.转到 **API Management page（API 管理页面）**。
   2.复制 \*\*Stats API v1.0（统计数据 API v1.0）\*\*部分中的 \*\*API Key（API 密钥）\*\*值。

2) **Game ID**

   如需从 **User Acquisition** 后台的 **Apps** 页面获取您的 [Game ID](../../getting-started/locate-advertiser-credentials#game-id)，请按照以下步骤操作：

   1.在后台左侧导航菜单中，转到 **Apps（应用）**。表格列出了您组织的每个应用。每个应用名称后，后台会显示应用平台和 Game ID。
   2.选择 ID 旁边的 \*\*Copy（复制）\*\*符号，将其复制到剪贴板。

3) **Organization ID**

   如需从用户获取后台获取组织 ID，请按照以下步骤操作：

   1.转到 \*\*Settings（设置）\*\*页面。
   2.从设置的 \*\*Organization（组织）\*\*部分中复制 \*\*Organization ID（组织 ID）\*\*值。

4) **Organization Core ID**

   如需从用户获取后台的 \*\*Settings（设置）\*\*页面获取 Organization core ID，请按照以下步骤操作：

   1.转到 \*\*Settings（设置）\*\*页面的 \*\*Organization（组织）\*\*部分。
   2.复制 \*\*Organization core ID（组织核心 ID）\*\*旁边的数字 ID。

5. 选择 **Next（下一步）**，进入到对话框的 \*\*Install Settings（安装量设置）\*\*选项卡。
6. 要启用查看归因，请选择 \*\*Enable view through tracking（启用查看跟踪）\*\*复选框，并配置查看回溯窗口。ByteBrew 默认会生成点击归因链接。
7. 在以下 \*\*Install Settings（安装量设置）\*\*字段中配置归因回溯期：

| **点击归因窗口** | 是 | 使用 \*\*Days（天数）\*\*选择器设置用户点击广告后多少天安装可归因。 | 最大点击归因回溯期为 30 天。建议的最佳做法是将点击归因回溯期设置为七天或更长时间，以便准确归因。 |
| ---------- | - | ---------------------------------------- | -------------------------------------------------- |
| **查看归因窗口** | 否 | 使用 \*\*Days（天数）\*\*选择器设置用户观看广告后多少天安装可归因。 | 最大查看归因回溯期为 7 天。建议的最佳做法是将查看归因回溯期设置为一天或更长时间，以便准确归因。  |

如需了解有关归因回溯选项的更多信息，请参阅 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（仅此合作伙伴）**
* **All Partners and Organics（所有合作伙伴和自然流量）**
* **该合作伙伴及自然流量**

有关安装数据源选项的更多信息，请参阅 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 开发者中心](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. 在广告网络设置对话框的最后一个选项卡上，可以复制归因链接。如需了解如何在 User Acquisition（用户获取）后台中集成这些 URL，请参阅[将归因链接与 Unity 集成](/user-acquisition/data-sharing/attribution/integrate-attribution-links.md)。
13. 选择 \*\*Finish（完成）\*\*以完成集成。