设置 Upsight
====================

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

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

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

**要求**&#x200b; 

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

[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)



**凭证**&#x200b;

AUTHORIZATION TOKEN 和 APP TOKEN 

   * 如需帮助查找凭证，请联系您的 Upsight 代表。



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

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

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

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

1. 输入您的 AUTHORIZATION TOKEN 和 APP TOKEN。



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



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

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

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

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

* 安装
* 再归因



### 发送额外数据

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



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



[为您的应用启用 Upsight](enable-partner)
-------------------------------------------

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

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

选择 **启用合作伙伴**&#x200b; ，为您的应用启用 Upsight 。数据分析合作伙伴不使用推广活动链接。启用合作伙伴后，我们的集成会通过自动回传发送归因和应用内事件数据。


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

Upsight 要求 Adjust 在回传中发送以下参数 (数据点)：
|          占位符           |             信息              |
|------------------------|-----------------------------|
| `{android_id}`         | 安卓 ID（仅限安卓设备）               |
| `{idfa\|\|gps_adid}` | IDFA 或 GPS ADID（如果 IDFA 为空） |
| `{idfv}`               | 供应商的大写 iOS ID               |
| `{os_name}`            | 设备操作系统                      |
| `{campaign_name}`      | 推广活动名称，取自跟踪链接               |
| `{creative_name}`      | 素材名称，取自跟踪链接                 |
| `{network_name}`       | 渠道名称，取自跟踪链接                 |



Upsight 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（仅限安卓设备）
`{idfa\|\|gps_adid}`	IDFA 或 GPS ADID（如果 IDFA 为空）
`{idfv}`	供应商的大写 iOS ID
`{os_name}`	设备操作系统
`{campaign_name}`	推广活动名称，取自跟踪链接
`{creative_name}`	素材名称，取自跟踪链接
`{network_name}`	渠道名称，取自跟踪链接