设置 AppTree
====================

AppTree 是一家已与 Adjust 集成的广告渠道。我们的集成允许 AppTree 通过自动回传接收归因和应用内事件数据。

在本文中了解如何为您的应用设置 AppTree 监测，这包括激活集成、创建推广活动链接、以及选择 Adjust 可以与 AppTree 分享的数据。

[操作前须知](before-you-begin)
-------------------------



**要求**&#x200b; 

* Adjust 中的[管理员、编辑员或自定义编辑员权限](/zh/article/permission-levels)。
* Adjust SDK v4\.0\.0 或更新版本，以便将 SDK 参数映射至 AppTree 参数。按照以下指南使用此功能。

[iOS](https://dev.adjust.com/zh/sdk/ios/features/events/#add-partner-parameters) | [安卓](https://dev.adjust.com/zh/sdk/android/features/events/#partner-parameters) | [Windows](https://github.com/adjust/windows_sdk#8-partner-parameters) | [Unity](https://dev.adjust.com/zh/sdk/unity/features/events/#add-partner-parameters) | [React Native](https://dev.adjust.com/zh/sdk/react-native/features/events/#add-partner-parameters) | [Flutter](https://dev.adjust.com/zh/sdk/flutter/features/events/#add-partner-parameters) | [Adobe Air](https://github.com/adjust/adobe_air_sdk#partner-parameters) | [Cordova](https://github.com/adjust/cordova_sdk#partner-parameters) | [Marmalade](https://github.com/adjust/marmalade_sdk#partner-parameters) | [Xamarin](https://github.com/adjust/xamarin_sdk#partner-parameters) | [Cocos2d-x](https://github.com/adjust/cocos2dx_sdk#partner-parameters) | [Titanium](https://github.com/adjust/titanium_sdk#partner-parameters) | [Corona](https://github.com/adjust/corona_sdk#partner-parameters)



[在 Campaign Lab 中选择 AppTree 和应用](select-network-in-campaign-lab)
--------------------------------------------------------------------------



1. 找到 **Campaign Lab**&#x200b; ，选择 **合作伙伴**&#x200b; 。
2. 选择 **新合作伙伴**&#x200b; > **AppTree**&#x200b; 。选择 **下一步**&#x200b; 进入下一界面。
3. 在 **应用选择**&#x200b; 界面选择要创建链接的应用，启用集成来与 AppTree 分享数据。
4. 选择 **下一步**&#x200b; 。

[启用数据分享](enable-data-sharing)
-----------------------------



启用数据分享以激活与 AppTree 的集成。要启用数据分享：

1. 选择启用



启用与 AppTree 的数据分享后，Adjust 会默认自动向 AppTree 发送以下数据：
* 安装



[设置数据分享](set-your-data-sharing)
-------------------------------



如果您的多平台应用启用了多个平台的数据分享，那么可以：

1. 通过选择 **使用平台特定设置**&#x200b; 来在平台层级区分数据共享设置。
2. 通过选择 **使用全局设置**&#x200b; 来为多个平台应用相同的数据共享设置。

在 **哪些数据会默认分享？**&#x200b; 部分, 查看 Adjust 默认与 AppTree 分享的活动。

* 安装



### 发送额外数据



选择您想通过回传与 AppTree 分享的数据量和数据类型。AppTree 可能会使用此信息来优化表现。


1. 在 __您想分享哪些数据来源？__&#x200b; 部分，选择与 AppTree 分享数据的归因来源： 

* 来自所有归因渠道的数据
* 仅限归因至 AppTree 的数据

## [配置链接和设置](configure-link-and-settings) 

您可以进行以下设置：

* [链接结构](/zh/article/link-structure-ad-network)
* [用户目的位置](/zh/article/user-destinations-ad-network)
* [归因设置](/zh/article/attribution-settings-ad-network)

[创建链接并与 AppTree 分享](create-and-share-link)
----------------------------------------------------



在 **设置概览**&#x200b; 界面，您可以检查自己的选择，也可以返回并更改以下内容：

* 所选应用
* 数据分享选项
* 链接结构参数
* 用户目的位置
* 归因设置

选择 **创建链接**&#x200b; 来创建点击 URL、展示 URL、二维码和链接识别码。创建链接还会启用数据共享及与 AppTree 的集成。

创建链接后，请与 AppTree 分享链接，以便在推广活动中放置。


## [转发给 AppTree 的所有参数列表](list-of-all-parameters-forwarded) 

AppTree 要求 Adjust 在回传中发送以下参数 (数据点)：

|          占位符           |             信息              |
|------------------------|-----------------------------|
| `{device_name}`        | 设备型号                        |
| `{idfa\|\|gps_adid}` | IDFA 或 GPS ADID（如果 IDFA 为空） |
| `{os_name}`            | 设备操作系统                      |
| `{random}`             | 随机数（每个回传都有唯一的随机数）           |
| `{click_time}`         | 归因的点击时间戳                    |
| `{created_at}`         | 活动时间戳                       |
| `{installed_at}`       | 安装（即，首次打开应用）时间戳             |



AppTree logo

设置 {DisplayName}
====================

{DisplayName} 是一家已与 Adjust 集成的广告渠道。我们的集成允许 {DisplayName} 通过自动回传接收归因和应用内事件数据。

在本文中了解如何为您的应用设置 {DisplayName} 监测，这包括激活集成、创建推广活动链接、以及选择 Adjust 可以与 {DisplayName} 分享的数据。

[操作前须知](before-you-begin)
-------------------------

<asset headerId="1" />

**要求** 

* Adjust 中的[管理员、编辑员或自定义编辑员权限](/zh/article/permission-levels)。
* Adjust SDK v4\.0\.0 或更新版本，以便将 SDK 参数映射至{DisplayName} 参数。按照以下指南使用此功能。

[iOS](https://dev.adjust.com/zh/sdk/ios/features/events/#add-partner-parameters) | [安卓](https://dev.adjust.com/zh/sdk/android/features/events/#partner-parameters) | [Windows](https://github.com/adjust/windows_sdk#8-partner-parameters) | [Unity](https://dev.adjust.com/zh/sdk/unity/features/events/#add-partner-parameters) | [React Native](https://dev.adjust.com/zh/sdk/react-native/features/events/#add-partner-parameters) | [Flutter](https://dev.adjust.com/zh/sdk/flutter/features/events/#add-partner-parameters) | [Adobe Air](https://github.com/adjust/adobe_air_sdk#partner-parameters) | [Cordova](https://github.com/adjust/cordova_sdk#partner-parameters) | [Marmalade](https://github.com/adjust/marmalade_sdk#partner-parameters) | [Xamarin](https://github.com/adjust/xamarin_sdk#partner-parameters) | [Cocos2d-x](https://github.com/adjust/cocos2dx_sdk#partner-parameters) | [Titanium](https://github.com/adjust/titanium_sdk#partner-parameters) | [Corona](https://github.com/adjust/corona_sdk#partner-parameters)

<if value="Tokens">

**凭证**

<switch length="Tokens">
  <case length="1"> {Tokens}</case>
  <case length="2"> {Tokens} 和 {Tokens}</case>
  <case length="3"> {Tokens}、{Tokens} 和 {Tokens}</case>
</switch> 

   * 如需帮助查找凭证，请联系您的 {DisplayName} 代表。
   
</if>

<if value="NeedsActivationInstructions">

</if>   
   
<if value="PartnerUiSetup">

  **在您的 {DisplayName} 控制面板中：**

<parse html="PartnerUiSetup" />
</if>

[在 Campaign Lab 中选择 {DisplayName} 和应用](select-network-in-campaign-lab)
--------------------------------------------------------------------------

<asset headerId="2" />

1. 找到 **Campaign Lab** ，选择 **合作伙伴** 。
2. 选择 **新合作伙伴** > **{DisplayName}** 。选择 **下一步** 进入下一界面。
3. 在 **应用选择** 界面选择要创建链接的应用，启用集成来与 {DisplayName} 分享数据。
4. 选择 **下一步** 。

[启用数据分享](enable-data-sharing)
-----------------------------

<asset headerId="3" />

启用数据分享以激活与 {DisplayName} 的集成。要启用数据分享：

<switch length="Tokens">
  <case length="0"> 1. 选择启用</case>
  <case length="1"> 1. 输入您的 {Tokens}。</case>
  <case length="2"> 1. 输入您的 {Tokens} 和 {Tokens}。</case>
  <case length="3"> 1. 输入您的 {Tokens}、{Tokens} 和 {Tokens}。</case>
</switch>

<if value="SendClicks">
由于点击量过大，Adjust 不会自动发送点击回传。要向 {DisplayName} 发送点击，请启用__Send clicks (发送点击)__开关。
</if>

启用与 {DisplayName} 的数据分享后，Adjust 会默认自动向 {DisplayName} 发送以下数据：
<list value="Callbacks" />

<if value="NeedsOptionalSetupInstructions">
</if>

[设置数据分享](set-your-data-sharing)
-------------------------------

<asset headerId="4" />

如果您的多平台应用启用了多个平台的数据分享，那么可以：

1. 通过选择 **使用平台特定设置** 来在平台层级区分数据共享设置。
2. 您可以通过选择 **使用全局设置** 来为多个平台应用相同的数据共享设置。

在 **哪些数据会默认分享？** 部分, 查看 Adjust 默认与 {DisplayName} 分享的活动。

<list value="Callbacks" />

### 发送额外数据

<asset headerId="5" />

选择您想通过回传与 {DisplayName} 分享的数据量和数据类型。{DisplayName} 可能会使用此信息来优化表现。

<if value="IsAttributedOnly">
1. 在__您想分享哪些数据来源？__部分，选择与 {DisplayName} 分享数据的归因来源： 

* 来自所有归因渠道的数据
* 仅限归因至 {DisplayName} 的数据
</if>

<if value="IsOrganicOnly">
Adjust 同时向 {DisplayName} 发送自然和付费流量归因数据。
</if>

<if value="Ad_Spend_Forwarding__c">
#### [广告支出](ad-spend) 

通过广告支出分享，{DisplayName} 能够接收用户广告支出数据。{DisplayName} 可以使用广告支出数据来优化您的推广活动。

Adjust 仅向 {DisplayName} 发送通过回传接收的广告支出数据。此数据来自您已设置且适用于 {DisplayName} 的以下解决方案：

* [合作伙伴广告支出推送 API](/zh/article/partner-ad-spend-push-api)
* [用于交互的广告支出数据](/zh/article/ad-spend-on-engagement)

如果 {DisplayName} 需要完整广告支出数据，则可以针对 {DisplayName} 设置[广告支出第三方存储导出](/zh/article/ad-spend-third-party-storage-exports)。

:::{growthSolution}

此功能包含在 Adjust SpendWorks 套餐中。要购买 SpendWorks 套餐，请联系您的销售代表。

:::

</if>

<if value="IsAdRevenueForwarding">
#### [广告收入 (来自广告查看)](ad-revenue) 

通过广告收入分享，{DisplayName} 能够接收用户广告收入数据。而 {DisplayName} 可以使用广告收入数据来优化您的用户定向和推广活动。

:::{growthSolution}

Adjust 的广告收入套餐可为您提供此功能。如需购买我们的广告收入套餐，请联系您的销售代表。

:::

要与 {DisplayName} 分享广告收入，请选择一个或多个 **广告收入来源** 。

* 若此处留白，我们则会发送所有已集成的广告收入来源。
</if>

<if value="IsSessionForwarding">
#### [会话](sessions) 

由于会话数量过大，Adjust 不会自动发送会话回传。启用会话分享后，{DisplayName} 将接收应用的会话活动数据。
</if>

<if value="IsUninstallForwarding">
#### [卸载与重装](uninstalls-reinstalls) 

通过共享卸载或重装数据，{DisplayName} 可以接收 Adjust 监测的所有应用卸载和/或重装数据。

:::{note}

对于 iOS 应用，记录到的卸载和/或重装可能会偏低。要获取更多信息，请参考[卸载和重装监测](/zh/article/uninstalls-reinstalls)。

:::
</if>

<if value="IsRevenueForwarding">
#### [应用内收入 (来自应用内购买)](in-app-revenue) 

通过应用内收入分享，{DisplayName} 可以接收收入金额以及您的收入事件数据。您需要[映射](#map-events)能产生收入的事件，才能分享该数据。
</if>

<if value="EventLinking">

#### [映射事件](map-events)

将您想分享的事件映射到 {DisplayName} 可以接收的值。未映射事件的数据不会被发送至 {DisplayName}。

##### 映射单个事件

如果您的应用为多平台应用，则可以选择按平台与 {DisplayName} 分享不同事件。这有助于您：

* 通过设定单个事件来管理不同平台的推广活动策略。
* 按平台自定义数据分享。

在 **映射事件** 中，按照以下步骤选择要直接发送至 {DisplayName} 的应用内事件。

1. 选择 **映射事件** 。
2. 在 **Adjust 事件** 列表中，选择要与 {DisplayName} 分享的 Adjust 事件。
3. 在 **合作伙伴事件** 下，您需要选择与 Adjust 事件对应的 {DisplayName} 事件。 
   1. 对于单平台应用和仅针对一个平台启用了数据共享的多平台应用，您只能针对一个平台映射事件。对于针对多个平台启用了数据共享的多平台应用，您可以： 
      * 选择 **使用平台特定映射** 来在平台层级映射单独事件或不针对某些平台映射事件。
      * 选择 **使用全局映射** 来为所有平台映射相同的事件。

   2. 打开 **合作伙伴** 列表，选择要映射到 Adjust 事件的渠道事件，或输入自定义事件名称。

4. 选择 **确认** 。

现在 {DisplayName} 将接收每个关联事件的应用内事件数据。

##### 映射全部事件

如果 {DisplayName} 支持自动映射所有事件，则在 **映射事件** 下选择 **映射全部事件** ，这能够省去映射单个事件的时间。

现在 {DisplayName} 将接收所有关联事件的应用内事件数据。

</if>

<if value="Map_Subscription_Events">

#### [映射订阅事件](map-subscription-events)

选择要分享的订阅事件，将其映射到渠道可接收的值。未映射事件数据不会被分享给渠道。

如果您的应用为多平台应用，则可以选择按平台与渠道分享不同事件。这有助于您：

* 通过设定单个事件来管理不同平台的推广活动策略。
* 按平台自定义数据分享。

打开映射订阅事件，按照下列步骤操作，选择要直接发送至渠道的订阅事件。

1. 选择 **映射事件** 。
2. 打开 **Adjust 事件** 列表，选择要与渠道分享的 Adjust 事件。
3. 在 **合作伙伴事件** 下，您需要选择与 Adjust 事件对应的合作伙伴事件。 
   1. 对于单平台应用和仅针对一个平台启用了数据共享的多平台应用，您只能针对一个平台映射事件。对于针对多个平台启用了数据共享的多平台应用，您可以： 
      * 选择 **使用平台特定映射** 来在平台层级映射单独事件或不针对某些平台映射事件。
      * 选择 **使用全局映射** 来为所有平台映射相同的事件。

   2. 在 **合作伙伴事件** 列表中，选择或输入要映射到 Adjust 事件的自定义事件名称。

4. 选择 **确认** 。

现在渠道将针对您关联的每一个事件接收订阅事件数据。

+++>

### 订阅事件 - 无收入

* `billing_retry`
* `cancellation`
* `expiration`
* `grace_period`
* `on_hold`
* `paused`
* `price_accepted`
* `price_declined`
* `revoked`
* `trial_started`

===

### 订阅事件 - 正收益

* `activation`
* `discounted_offer`
* `reactivation`
* `renewal`
* `renewal_from_billing_retry`

+++<

</if>

<if value="IsPartnerParameterForwarding">
  #### [映射参数](map-parameters) 

要与 {DisplayName}分享自定义数据，您通常需要映射参数。

合作伙伴参数 (在 Adjust SDK 4\.0+ 版本中提供) 允许 Adjust 从您的应用中收集自定义数据点，并将其发送至 {DisplayName}。借此，{DisplayName} 可以接收每个已关联事件的自定义事件详情。

在向 Adjust SDK 添加新的合作伙伴参数之前，请确保现有的合作伙伴参数均不符合您的要求。

如需与 {DisplayName} 分享合作伙伴参数，请遵循以下步骤。

1. 在 Adjust SDK 中设置合作伙伴参数。 
   * 在[操作前须知](#before-you-begin)部分查看所有 SDK 开发平台链接。

2. 在 **设置数据分享** 下，选择 **参数** 。
3. 打开 **映射参数** ，选择如何向渠道发送 SDK 中指定的合作伙伴参数。 
   1. 选择 **映射参数** 。
   2. 在 **SDK 参数** 字段中输入要与渠道分享的 SDK 参数名称。
   3. 在 **合作伙伴参数** 字段中输入 SDK 参数对应的渠道参数。

:::{note}

如果您在 Adjust SDK 中设置了合作伙伴参数而没有在控制面板中设置参数分享，那么 Adjust 会按照 Adjust SDK 中的名称发送参数。

:::  

</if>
## [配置链接和设置](configure-link-and-settings) 

您可以进行以下设置：

* [链接结构](/zh/article/link-structure-ad-network)
* [用户目的位置](/zh/article/user-destinations-ad-network)
* [归因设置](/zh/article/attribution-settings-ad-network)

[创建链接并与 {DisplayName} 分享](create-and-share-link)
----------------------------------------------------

<asset headerId="6" />

在 **设置概览** 界面，您可以检查自己的选择，也可以返回并更改以下内容：

* 所选应用
* 数据分享选项
* 链接结构参数
* 用户目的位置
* 归因设置

选择 **创建链接** 来创建点击 URL、展示 URL、二维码和链接识别码。创建链接还会启用数据共享及与 {DisplayName} 的集成。

创建链接后，请与 {DisplayName} 分享链接，以便在推广活动中放置。

<if value="PartnerSpecificSetup">
## [合作伙伴特定设置说明](partner-specific-setup-instructions)

<asset headerId="7" />   
   
<parse html="PartnerSpecificSetup" />
</if>

<if value="DataList">
## [转发给 {DisplayName} 的所有参数列表](list-of-all-parameters-forwarded) 

{DisplayName} 要求 Adjust 在回传中发送以下参数 (数据点)：

<table value="DataList" >
</if>


阅读 Adjust 设置向导、最佳做法及常见问题解答，让您的业务更上一层楼。



营销人员

在您的应用和业务分析中集成我们的 API 和开源 SDK。


开发者


全球技术合作伙伴如何与 Adjust 开展高效合作？本文提供了大量实用建议。



占位符	信息
`{device_name}`	设备型号
`{idfa\|\|gps_adid}`	IDFA 或 GPS ADID（如果 IDFA 为空）
`{os_name}`	设备操作系统
`{random}`	随机数（每个回传都有唯一的随机数）
`{click_time}`	归因的点击时间戳
`{created_at}`	活动时间戳
`{installed_at}`	安装（即，首次打开应用）时间戳