# 将 Tenjin 与 Unity 集成

> 在 Tenjin 后台激活 Unity Ads 集成，并启用完整数据共享。

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

将 Tenjin 设置为 Unity Ads 用户获取广告系列的移动端成效衡量合作伙伴 (MMP)。集成包括以下设置任务：

* [从 Unity Dashboard（Unity 后台）复制凭据](#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 Ads User Acquisition（用户获取）后台](https://cloud.unity.com/acquire)中至少[添加](../../get-started/set-up-user-acquisition#add-new-apps-to-the-dashboard)一个应用。
* 在 Unity Dashboard（Unity 后台）中启用 \*\*Organization Owner（组织所有者）\*\*或 \*\*Organization Manager（组织管理员）\*\*访问权限。更多信息请参阅[用户类型、角色和权限](/cloud/organizations/roles-and-permissions.md)。
* 下载最新版 [Tenjin SDK](https://github.com/tenjin/tenjin-unity-sdk)。

## 集成 Unity Ads 与 Tenjin##integrate-unity-ads-with-tenjin

完成以下步骤，将 Tenjin 集成到您的用户获取广告系列中：

### 从 Unity Dashboard（Unity 后台）复制凭据##copy-credentials-from-the-unity-dashboard

您需要以下 Unity 帐户凭据来完成 Tenjin 集成：

1. **Game ID**

   #### Game ID

   如需从 \*\*User Acquisition（用户获取）\*\*后台的 \*\*Apps（应用）\*\*页面获取您的 [Game ID](../../get-started/retrieve-your-advertiser-game-id)，请按照以下步骤操作：

   1.在后台左侧导航菜单中，转到 **Apps（应用）**。表格列出了您组织的每个应用。每个应用名称后，后台会显示应用平台和 Game ID。
   2.选择 ID 旁边的 \*\*Copy（复制）\*\*符号，将其复制到剪贴板。
   3.您也可以将鼠标悬停在应用名称上，复制 **Campaign Set ID（广告系列集 ID）** 和 **Store ID（商店 ID）**。

   > **Note:**
   >
   > 请严格按照用户获取后台中显示的 Game ID 输入。Game ID 不匹配会导致 Unity 无法正确接收事件。

2. **Secret Key and Key ID**

   #### 密钥和密钥 ID

   > **Note:**
   >
   > 只有**组织所有者**或**组织管理员**可以创建服务帐户和密钥。请参阅[用户类型、角色和权限](/cloud/organizations/roles-and-permissions.md)以了解更多信息。

   要在**用户获取**后台获取您的密钥和密钥 ID，请按以下步骤操作：

   1.在左侧导航菜单中，转到 **API Management（API 管理）**。
   2.选择 **Advertising Management API（广告管理 API）** > **Service account（服务帐户）**。
   ![User Acquisition（用户获取）后台的 API Management（API 管理）页面。](/api/media?file=/grow/media/images/api-service-account.png)
   3.如果没有服务帐户，请选择 **+ New（新建）**。如果已有服务帐户，请在表格中选择该帐户。
   4.在服务帐户页面，进入 \*\*Keys（密钥）\*\*部分。
   5.选择 \*\*+ Add key（添加密钥）\*\*以生成两组密钥。
   6.选择 \*\*Key ID（密钥 ID）\*\*和 \*\*Secret key（密钥）\*\*后的复制按钮，复制两组凭据。

3. **Organization core ID**

   #### Organization core ID

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

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

   > **Note:**
   >
   > 请确保复制纯数字的**Organization core ID**，而不是字母数字的**组织 ID**。

### 在 Tenjin 后台激活 Unity Ads##activate-unity-ads-in-the-tenjin-dashboard

要集成 Unity 与 Tenjin，请在 [Tenjin 后台](https://dashboard.tenjin.com/)中按以下步骤操作：

1. 进入 **Configure（配置）** 选项卡，选择 **Channels（通道）**。
2. 在 \*\*Marketing Channel Name（市场营销通道名称）\*\*字段中搜索 **Unity Ads**。
3. 在 Unity Ads 的 \*\*New Marketing Channel（新市场营销通道）\*\*设置中，输入从 Unity Dashboard（Unity 后台）复制的 Unity 帐户凭据，并为帐户命名。
4. 在 Tenjin 导航菜单中，转到 \*\*Campaigns（广告系列）\*\*选项卡，选择 **Create Campaign（创建广告系列）**。
5. 从 \*\*Marketing Account（营销帐户）\*\*下拉选单中选择 **Unity Ads**。
6. 在 **App（应用）**下拉菜单中选择您的应用，并为广告系列设置一个有描述性的**名称**。
7. 当系统显示 \*\*Callback to be created（待创建回调）\*\*消息提示时，请按照提供的链接继续并生成归因链接。

### 配置数据共享设置##configure-data-sharing-settings

为 Tenjin 配置数据共享设置时也需要映射您的应用内事件。要为 Tenjin 配置数据共享设置并映射事件，请在完成激活工作流程后按以下步骤操作：

1. 按照 \*\*Callback to be created（待创建回调）\*\*消息中的链接操作后，从 \*\*Channels and Partners（通道和合作伙伴）\*\*下拉菜单中选择 **Unity Ads**。
2. 在 \*\*Channel callbacks（通道回调）\*\*部分，启用以下开关：

* **Unity Ads 广告收入**
* **Unity Ads app open（Unity Ads 应用打开）**
* **Unity Ads IAP**
* **Unity Ads install（Unity Ads 安装）**

> **Important:**
>
> 请勿将广告收入事件映射为**应用内购**事件。如果您的 Tenjin 帐户支持广告收入数据共享，请将此数据作为专门的**广告收入展示**事件发送。
>
> 如果您的帐户不支持广告收入数据共享，请勿将广告收入作为其他事件类型发送，否则事件类型不匹配可能导致广告系列优化失效。

3. 对于每个事件回调，从 \*\*User filter（用户筛选器）\*\*下拉菜单中选择 **all users（所有用户）**。

![Tenjin 集成设置的“Channel Callbacks”（通道回调）页面。](/api/media?file=/grow/media/images/tenjin-channel-callbacks.png)