集成 ByteBrew 与 Unity
将用户获取广告系列与 ByteBrew 集成以传递应用的互动数据和安装后事件数据。
阅读时间6 分钟最后更新于 3 个月前
通过与 ByteBrew 集成，您可以追踪安装，并接收广告系列的安装后事件回传数据。如需了解最新的 ByteBrew 集成信息，请查阅 ByteBrew Developer Hub。 要激活 Unity 和 ByteBrew 之间的集成，请完成以下任务：
- 在 Unity Ads User Acquisition（用户获取）后台中创建服务帐户。
- 在后台服务帐户设置中创建 API 密钥。
- 在 ByteBrew 后台中完成集成工作流程。
先决条件
- 添加至少一个应用到 Unity Ads User Acquisition（用户获取）后台。
- 在应用中初始化 ByteBrew SDK。请参阅 ByteBrew 的 Unity SDK 集成指南，了解详细的初始化说明。
创建服务帐户
服务帐户允许您与 ByteBrew 集成时使用 Unity Advertising Statistics API。要创建服务帐户，请在 Unity Ads User Acquisition（用户获取）后台中执行以下操作：- 从左侧导航菜单中选择 API Management（API 管理）。
- 在 Stats API v2.0 部分，选择 Service account（服务帐户）。
- 在 **Service Accounts（服务帐户）**页面右上角，选择 + New（新建），打开 **Create service account（创建服务帐户）**对话框并新建服务帐户。
- 在 **Service account name（服务帐户名称）**和 **Service account description（服务帐户描述）**字段中输入相应的内容。请参阅以下名称和描述示例：
- Service account name（服务帐户名称）：ByteBrew attribution（ByteBrew 归因）
- Service account description（服务帐户描述）：ByteBrew attribution campaign metadata pull（ByteBrew 归因广告系列元数据拉取）
- 选择 **Create（创建）**以保存设置，并将新服务帐户添加到 **Service Accounts（服务帐户）**页面列表中。
创建 API 密钥
要在 ByteBrew 集成中启用通过 Unity 统计数据 API 进行的程序化数据共享，必须在服务帐户设置中创建两个 API 密钥：**Key ID（密钥 ID）**和 Secret Key（密钥）。 要创建这些密钥，请在 Unity Dashboard（Unity 后台）的 Organization（组织）> **Service accounts（服务帐户）**设置中执行以下操作：- 查找并选择先前创建的服务帐户。您可以使用搜索栏查找帐户。
- 在 **Keys（密钥）**部分中，选择 **+ Add key（+ 添加密钥）**以生成密钥，然后将打开 **New key has created（已创建新密钥）**对话框。
- 您需要同时使用此对话框中的 **Key ID（密钥 ID）**和 **Secret key（密钥）**才能在 ByteBrew 后台中完成集成。复制这两个密钥。
- 选择 **Done（完成）**以关闭对话框。
完成 ByteBrew 集成工作流程
重要
以下文档涉及非 Unity 开发、拥有或运营的产品或服务（“第三方产品”）。
这些信息可能已过时或不完整，仅为方便您参考才提供。
您对任何第三方产品的使用均受产品自身条款的约束。
Unity 对这些产品不提供任何担保，也不对因使用这些产品而造成的任何损害或损失负责，包括与第三方供应商提供的内容、广告或材料有关的问题。
- 从后台导航菜单中选择您的应用。
- 转到 Attribution（归因）> Network Settings（广告网络设置），然后从广告网络列表中找到 UnityAds。
- 在 UnityAds 旁边，选择 **Setup（设置）**以打开 **Add Ad Network（添加广告网络）**对话框。
- 填写 **Network Settings（广告网络设置）**字段。请参阅以下选项卡，了解在 User Acquisition（用户获取）后台中查找这些值的位置：
如需从用户获取后台获取 API 密钥，请执行以下操作：1.转到 API Management page（API 管理页面）。
2.复制 **Stats API v1.0（统计数据 API v1.0）**部分中的 **API Key（API 密钥）**值。
- 选择 Next（下一步），进入到对话框的 **Install Settings（安装量设置）**选项卡。
- 要启用查看归因，请选择 **Enable view through tracking（启用查看跟踪）**复选框，并配置查看回溯窗口。ByteBrew 默认会生成点击归因链接。
- 在以下 **Install Settings（安装量设置）**字段中配置归因回溯期：
安装设置 | 必填项 | 配置 | 备注 |
|---|---|---|---|
| 点击归因窗口 | 是 | 使用 **Days（天数）**选择器设置用户点击广告后多少天安装可归因。 | 最大点击归因回溯期为 30 天。建议的最佳做法是将点击归因回溯期设置为七天或更长时间，以便准确归因。 |
| 查看归因窗口 | 否 | 使用 **Days（天数）**选择器设置用户观看广告后多少天安装可归因。 | 最大查看归因回溯期为 7 天。建议的最佳做法是将查看归因回溯期设置为一天或更长时间，以便准确归因。 |
- 在 **Send all install events from（发送所有安装事件的来源）**部分中，选择传递应用所有安装的互动数据（包括未归因的安装数据）还是仅传递归因于 Unity 的互动数据。请从以下选项中进行选择：
- Only this partner（仅此合作伙伴）
- All Partners and Organics（所有合作伙伴和自然流量）
- 该合作伙伴及自然流量
- 选择 Next（下一步），进入到对话框的 **Postback Settings（回传设置）**选项卡。
- 要添加需要传递给 Unity 的安装后事件，请选择 + Add Postback Event（+ 添加回传事件），然后从以下选项中进行选择：
- Ad Watched Event（广告观看事件）
- User App Open Event（用户应用打开事件）
- In-App Purchase Event（应用内购事件）
重要
不要在应用代码中定义新用户事件。ByteBrew 默认使用 **User App Open Event（用户应用打开事件）**选项来追踪新用户事件。如需了解更多信息，请参阅 ByteBrew 开发者中心 归因文档。
- 在 **Postback Events Settings（回传事件设置）**部分中，选择是否传递所有应用安装的安装后事件数据（包括未归因安装数据），或仅传递归因于 Unity 的数据。请从以下选项中进行选择：
- Send only from this partner（仅发送此合作伙伴的数据）
- Send from all Networks and Organics（发送所有网络和自然流量的数据）
- Send only from this Partner and Organics（仅发送此合作伙伴和自然流量的数据）
- 在广告网络设置对话框的最后一个选项卡上，可以复制归因链接。如需了解如何在 User Acquisition（用户获取）后台中集成这些 URL，请参阅将归因链接与 Unity 集成。
- 选择 **Finish（完成）**以完成集成。