设置 Ampush
====================

Ampush 是 Adjust 模块合作伙伴。我们的集成允许 Ampush 接收以下自归因渠道的归因和应用事件数据：

 - Facebook

使用我们的基本设置说明来启用 Adjust 的集成，并向 Ampush 发送回传。之后，使用我们的高级设置说明来自定义 Ampush 将接收哪些信息。 

[基本设置](basic-setup)
-------------------

要启用 Adjust 与 Ampush 的集成，请遵循以下步骤。

1. 查找应用并选择应用选项插入符号 (^)
2. 选择 **合作伙伴设置**&#x200b; > **添加合作伙伴**&#x200b; 
3. 选择 **Ampush**&#x200b; 旁的添加 (+) 图标
4. 输入您的 ADVERTISER NAME (若需要帮助查找此信息，请联系您的 Ampush 代表)
5. 可选：查看[高级设置](#advanced-setup)，以便自定义您的回传 
6. 选择 "保存" 

太好了！基本设置已经完成。Ampush 将接收以下活动的回传：

* 安装
* 会话
* 再归因
* 事件

## [高级设置](advanced-setup) 

通过自定义设置，选择 Ampush 将从 Adjust 接收哪些数据。

### [转发应用内收入](forward-in-app-revenue)

应用内收入转发功能允许 Ampush 接收收入金额以及您的收入事件数据。

要向 Ampush 发送应用内收入数据，请遵循以下步骤。

1. 查找应用并选择应用选项插入符号 (^)
2. 选择 **合作伙伴设置**&#x200b; > **Ampush**&#x200b; 
3. 打开 **应用内收入转发**&#x200b; 

现在 Ampush 将接收每笔跟踪交易的收入金额。

**注意：**&#x200b; 在打开 "收入转发" 之前，至少要将一个[收入事件]关联到 Ampush。

### [发送应用内事件](forward-in-app-events)

事件关联允许 Ampush 接收应用内事件数据。您可以在 Adjust 中将每个应用内事件关联到预设的 Ampush 名称或自定义的事件名称。

要向 Ampush 发送应用内事件，请遵循以下步骤。

1. 查找应用并选择应用选项插入符号 (^)
2. 选择 **合作伙伴设置**&#x200b; > **Ampush**&#x200b; > **事件关联**&#x200b; 
3. 查找您希望关联的事件，并使用 Ampush 事件或自定义名称来更新此字段
4. 当您完成关联事件后，选择 **确定**&#x200b; 
5. 选择 **"保存"**&#x200b; 

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

[合作伙伴特定设置说明](partner-specific-setup-instructions)
-------------------------------------------------

Ampush 仅接收过滤后的 Facebook 流量数据。此举旨在让您将 Ampush Facebook 流量与可能正在进行的其他 Facebook 推广活动分开管理。

只有名称包含关键字 *Ampush* 的 Facebook 推广活动才会被传输至 Ampush。也就是说，您必须在希望通过 Ampush 管理的每个推广活动名称中包含该关键字。不包含该关键字的推广活动将不会被传输至 Ampush。

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

Ampush 要求 Adjust 通过您的回传发送以下参数 (数据点)：

|           占位符            |           信息            |
|--------------------------|-------------------------|
| `{fb_adgroup_id}`        | Facebook 素材层 ID         |
| `{fb_adgroup_name}`      | Facebook 广告名称           |
| `{fb_campaign_id}`       | Facebook 广告组系列 ID       |
| `{fb_campaign_name}`     | Facebook 广告系列名称         |
| `{random}`               | 随机数（每个回传都有唯一的随机数）       |
| `{revenue}`              | 从 Adjust SDK 发送的收入（以分计） |
| `{click_time_hour}`      | 归因的点击时间戳（取最近的整时点）       |
| `{impression_time_hour}` | 归因的展示时间戳（取最近的整时点）       |

Ampush logo

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

{DisplayName} 是一款 SAN 推广活动管理工具，可以管理以下自归因渠道 (SAN) 的推广活动：

<list value="selfAttributingNetworks" />

通过 SAN 推广活动管理工具开展推广活动时无需创建链接。您需要设置投放广告的 SAN 平台，以及管理推广活动的 SAN 推广活动管理工具。

一旦您开始通过 SAN 推广活动管理工具开展推广活动，Adjust 就会同时与 SAN 和 SAN 推广活动管理工具分享数据，用于分析和推广活动优化。

:::{note}

Meta 将 SAN 推广活动管理工具称为 Meta 商务合作伙伴 (Meta Business Partner)。

:::

在本文中了解如何为您的应用设置 {DisplayName} 监测，其中包括激活集成，以及选择 Adjust 可以与 {DisplayName} 分享的数据。

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

**要求** 

* Adjust 中的[管理员、编辑员或自定义编辑员权限](/zh/article/permission-levels)。
* [启用](/zh/article/self-attributing-network-san-setup)您将在其平台上投放广告的 SAN。
* 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#add-partner-parameters) | [Windows](https://dev.adjust.com/zh/sdk/windows/features/events#add-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://dev.adjust.com/zh/sdk/cordova/features/events#add-partner-parameters) | [Marmalade](https://github.com/adjust/marmalade_sdk#partner-parameters) | [Xamarin](https://github.com/adjust/xamarin_sdk#partner-parameters) | [Cocos2d-x](https://dev.adjust.com/zh/sdk/cocos2dx/features/events#add-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 value="PartnerUiSetup">

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

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

</if>

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

1. 找到 **Campaign Lab** ，选择 **合作伙伴** 。
2. 选择 **新合作伙伴** > **{DisplayName}** 。选择 **下一步** 进入下一界面。
3. 在 **应用选择** 界面，选择要设置 {DisplayName} 的应用。
4. 选择 **下一步** 。

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

启用数据分享以激活与 {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)
-------------------------------

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

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

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

<list value="Callbacks" />

### 发送额外数据

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

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

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

要发送额外数据，您可以查看并自定义以下选项：

<if value="IsOrganicOnly">
  Adjust 同时向 {DisplayName} 发送自然和付费流量归因数据。
</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} 可以接收收入金额以及您的收入事件数据。您需要映射能产生收入的事件，才能分享该数据。
</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="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>

[为您的应用启用 {DisplayName}](enable-partner)
-------------------------------------------

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

* 所选应用
* 数据分享选项

选择 **启用合作伙伴** ，为您的应用启用 {DisplayName} 。如已设置，那么该操作也会启用数据分享。

[在 {DisplayName} 控制面板中设置带有关键词的推广活动](set-up-your-campaign-with-keyword-in-the-partner-dashboard)
---------------------------------------------------------------------------------------------------

在 {DisplayName} 控制面板中设置您的推广活动。设置推广活动时，您需要在推广活动名称中输入关键词。关键词不区分大小写。

如果未在推广活动名称中添加关键词，则 Adjust 无法识别您在 {DisplayName} 中管理的推广活动。这意味着 SAN 仍会收到此推广活动的数据，但您无法在报告中看到哪些推广活动由 {DisplayName} 管理，而 {DisplayName} 不会从 Adjust 收到任何回传。

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

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

<if value="CampaignKeywords">
### [{DisplayName} 推广活动关键词](keywords-list) 

{DisplayName} 的关键词为：

<list value="CampaignKeywords" />  
</if>

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

{DisplayName} 要求 Adjust 在回传中发送以下参数 (数据点)：
<table value="DataList" >
</if>

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



营销人员

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


开发者


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



占位符	信息
`{fb_adgroup_id}`	Facebook 素材层 ID
`{fb_adgroup_name}`	Facebook 广告名称
`{fb_campaign_id}`	Facebook 广告组系列 ID
`{fb_campaign_name}`	Facebook 广告系列名称
`{random}`	随机数（每个回传都有唯一的随机数）
`{revenue}`	从 Adjust SDK 发送的收入（以分计）
`{click_time_hour}`	归因的点击时间戳（取最近的整时点）
`{impression_time_hour}`	归因的展示时间戳（取最近的整时点）