设置 Forensiq
====================

Forensiq 是数据分析和 Adjust 模块合作伙伴。我们的集成能让 Forensiq 通过自动化回传来接收归因和应用内事件数据。

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

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

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

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

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

* 点击
* 安装
* 事件
* 被拒安装

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Forensiq 要求 Adjust 通过您的回传发送以下参数 (数据点)：
|          占位符           |                    信息                     |
|------------------------|-------------------------------------------|
| `{android_id}`         | 安卓 ID（仅限安卓设备）                             |
| `{gps_adid}`           | Google Play 应用商店广告 ID                     |
| `{idfa}`               | 广告主 ID（仅限 iOS 设备）                         |
| `{idfa\|\|gps_adid}` | IDFA 或 GPS ADID（如果 IDFA 为空）               |
| `{ip_address}`         | 设备 IP 地址                                  |
| `{match_type}`         | 归因方法                                      |
| `{reftag}`             | 随机设备参考标签                                  |
| `{revenue_usd}`        | 以美元计算的收入                                  |
| `{sdk_version}`        | Adjust SDK 版本（按应用）                        |
| `{user_agent}`         | 传入的原始用户代理                                 |
| `{win_adid}`           | Windows 广告标识符                             |
| `{activity_kind}`      | 用户活动类型                                    |
| `{adgroup_name}`       | 广告组名称，取自跟踪链接                              |
| `{app_id}`             | 商店的应用 ID 或 Google Play 商店                 |
| `{app_version}`        | 应用版本号 (安卓)，Bundle build 版本号 (iOS) |
| `{campaign_name}`      | 推广活动名称，取自跟踪链接                             |
| `{click_referer}`      | 来自点击的 Referrer 标头                         |
| `{engagement_time}`    | 交互时间戳                                     |
| `{installed_at}`       | 安装（即，首次打开应用）时间戳                           |
| `{is_organic}`         | 若为自然流量，则为 1；若为非自然流量，则为 0                  |
| `{network_name}`       | 渠道名称，取自跟踪链接                               |
| `{rejection_reason}`   | 归因被拒的原因                                   |

Forensiq logo

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

{DisplayName} 是一家已与 Adjust 集成的数据分析合作伙伴。我们的集成允许 {DisplayName} 通过自动回传接收 Adjust 监测的数据。您可以使用合作伙伴的工具进行数据分析并获取洞见。

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

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

**要求** 

* 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#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="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="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} 。数据分析合作伙伴不使用推广活动链接。启用合作伙伴后，我们的集成会通过自动回传发送归因和应用内事件数据。

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

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

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

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

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



营销人员

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


开发者


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



占位符	信息
`{android_id}`	安卓 ID（仅限安卓设备）
`{gps_adid}`	Google Play 应用商店广告 ID
`{idfa}`	广告主 ID（仅限 iOS 设备）
`{idfa\|\|gps_adid}`	IDFA 或 GPS ADID（如果 IDFA 为空）
`{ip_address}`	设备 IP 地址
`{match_type}`	归因方法
`{reftag}`	随机设备参考标签
`{revenue_usd}`	以美元计算的收入
`{sdk_version}`	Adjust SDK 版本（按应用）
`{user_agent}`	传入的原始用户代理
`{win_adid}`	Windows 广告标识符
`{activity_kind}`	用户活动类型
`{adgroup_name}`	广告组名称，取自跟踪链接
`{app_id}`	商店的应用 ID 或 Google Play 商店
`{app_version}`	应用版本号 (安卓)，Bundle build 版本号 (iOS)
`{campaign_name}`	推广活动名称，取自跟踪链接
`{click_referer}`	来自点击的 Referrer 标头
`{engagement_time}`	交互时间戳
`{installed_at}`	安装（即，首次打开应用）时间戳
`{is_organic}`	若为自然流量，则为 1；若为非自然流量，则为 0
`{network_name}`	渠道名称，取自跟踪链接
`{rejection_reason}`	归因被拒的原因