菜单

Adjust

集成流程一览

1.客户端集成 Adjust SDK，且 DT SDK 初始化完成后获取dt_id，并调用 Adjust SDK 接口上报用户的dt_id
2.DT 平台「数据管理-三方数据集成-广告归因-数据接入」获取 Adjust 归因数据回调地址
3.Adjust 平台「全局回调 Global Callback 配置页」配置 DT 平台中数据关联项目的回调地址
4.DT 平台「数据管理-三方数据集成-广告归因-数据接入」完成归因字段映射关系配置
5.DT 平台「数据管理-三方数据集成-广告归因-数据转化」校验 DT 集成数据转化情况

一、集成必要操作

1.1 集成 Adjust SDK

Adjust Android SDK 集成方法：参见 Get started with the Android SDK | Adjust Help Center

在 DT SDK 初始化完成后，通过 DTAnalytics.getDataTowerId 方法获取 dataTowerId
然后调用 Adjust SDK 的 addSessionCallbackParameter 方法上报用户的 dataTowerId，方法的第一个参数请传入"dt_id"

kotlin 复制代码

```private fun initAdjust(context: Context) {
  DTAnalytics.getDataTowerId(object : OnDataTowerIdListener {
      override fun onDataTowerIdCompleted(dataTowerId: String) {
          //请注意：下面一行代码必须要在 Adjust.onCreate() 之前调用
          Adjust.addSessionCallbackParameter("dt_id", dataTowerId)
          val appToken = "Your Adjust App Token"
          val environment = if (BuildConfig.DEBUG) AdjustConfig.ENVIRONMENT_SANDBOX else AdjustConfig.ENVIRONMENT_PRODUCTION
          val config = AdjustConfig(context, appToken, environment)
          Adjust.onCreate(config)
      }
  })

iOS 参见：Get started with the iOS SDK | Adjust Help Center
Unity 参见：Get started with the Unity SDK| Adjust Help Center

1.2 DT 平台授权

授权字段	说明
关联项目	为本次授权归因平台的数据关联 DT 平台中的项目
Adjust 回调地址	DT 平台生成关联项目用于接收 Adjust 数据的地址

注意：每个项目仅能授权配置一个 Adjust 平台

1.3 Adjust 配置

Adjust 平台实时回调功能讲解视频：Raw data export

配置方法：

查找应用并点击应用选项插入符号（^）
选择 所有设置 > 原始数据导出 > 实时回传
选择添加安装事件回传
输入 DT 平台生成回调地址，点击保存

1.4 配置归因映射

配置成功后，DT 平台会实时接收 Adjust 服务端回调的数据

待 DT 平台获取到归因数据后，需要对接入的归因数据和DT平台的归因信息字段配置好映射关系

操作列的设置图标会提示当前归因平台的数据中有多少渠道未配置映射关系

配置字段	说明
广告归因平台渠道	Adjust 实时归因数据中的广告平台字段
DT 平台-关联渠道	DT 平台统一定义的广告平台字段名称，可在「数据管理-三方数据集成-广告归因-渠道配置」中配置归因优先级以及增加新渠道
DT 平台-关联流量平台	目前仅限于 Meta 渠道下 Instagram、Facebook 这两个流量平台进行关联映射，DT 平台会自动处理Adjust对于Meta渠道的流量平台关联关系，此处无需配置
广告归因平台代理商	Adjust 目前不支持关联代理商数据
DT 平台-关联代理商	DT 平台统一定义的代理商字段名称，可在「数据管理-三方数据集成-广告归因-代理商配置」中配置归因优先级以及增加新渠道
发现时间	DT 首次收到该渠道/代理商数据的时间
更新状态	归因关系最后一次变更时间
接入状态	开启：该归因关系规则生效关闭：该归因关系规则不生效

注意：如不配置渠道的映射关系，则等同于未接入三方归因数据！

1.5 校验数据转化

在「转化统计」页面可以查看每个项目的归因集成转化情况

归因新用户数：与广告归因平台的原始新用户数完全相等
DT 转化成功：DT 平台成功解析归因用户的数量，与事件分析「app 首次安装。触发用户数」完全相等
DT 转化失败比例
1. 正常情况：转化失败比例≤5%，属于正常误差内
2. 异常情况：转化失败比例＞5%，未在「广告归因-数据接入」配置归因关联关系

注意：在 DT 集成广告归因数据后，如果比对 DT 平台和广告归因平台两者的平台显示数据，两个平台的数据计算时区需要保持一致

二、归因数据使用

2.1 数据说明

每一次三方归因数据的转化都会对应生成一个归因事件“app 安装（服务端）”

在分析模型中可以对以下 DT 转化后的属性进行分析

事件/用户属性名	显示名	属性说明
$network_name	渠道	广告投放的合作公司主体名称，如 google Ads、Meta
$network_id	渠道 ID	广告投放的合作公司主体 ID，具有唯一性
$tracker_name	代理商	广告投放代理名称
$tracker_id	代理商 ID	广告投放代理 ID，具有唯一性
$channel_name	广告计划	合作公司的推广通道方式名称，例如广告计划/Campaign
$channel_id	广告计划 ID	合作公司的推广通道方式 ID，具有唯一性
$channel_sub_name	广告组	渠道下的再次细分名称，例如广告组/Ad group
$channel_sub_id	广告组 ID	渠道下的再次细分 ID，具有唯一性
$channel_ssub_name	广告	广告组下的再次细分名称，例如广告素材/Ad
$channel_ssub_id	广告 ID	广告组下的再次细分 ID，具有唯一性
$channel_platform_name	流量平台	合作公司主体下的流量平台名称，例如 Meta 下的 Instagram、Facebook
$channel_platform_id	流量平台 ID	合作公司主体下的流量平台 ID，具有唯一性
$attribution_source	归因-归因平台	归因数据来源平台名称，例如 AppsFlyer、Adjust、Appsflyer
$attribution_callback_time	归因-报告时间	归因报告时间，需要回调则按照回调时间，不需要回调则按照归因时间

也可以直接对三方归因数据中的原始字段进行分析

事件/用户属性名	显示名	属性说明
$original_network_name	原始渠道	广告归因平台数据中广告投放平台的原始字段
$original_network_id	原始渠道 ID	广告归因平台数据中广告投放平台 ID 的原始字段
$original_tracker_name	原始代理商	广告归因平台数据中代理商的原始字段
$original_tracker_id	原始代理商 ID	广告归因平台数据中代理商 ID 的原始字段

2.1 使用示例

以上说明数据都可以在分析模型中的筛选或分组项中进行选择使用，例如分析每个渠道（campaign）下的某个指标（新用户数、ROI、获客成本、收入）

以分析指标「新用户数」做示例：

分析对象	图例
分析指定广告计划（campaign）的新用户数

分析所有广告计划（campaign）的新用户数

三、常见 FAQ

Adjust 归因数据中各个广告字段的映射关系

如何获取Meta ads原始数据

Adjust官方说明

Facebook原始数据由于FB隐私政策规定，无法直接回传细分Campaign信息
安卓的原始数据支持通过特殊配置进行回传，详见文档：Facebook raw data reporting for Android | Adjust Help Center
iOS的原始数据不支持回传

转化统计中每天的归因数据都有转化失败的情况

转化失败比例小于 5%以内是正常范围

转化失败的问题是：Adjust 实时归因数据的 Adjust_id 没有在客户端上报的 Adjust_id 中找到映射

一般的原因有以下 2 种：

客户端老版本没有使用 DT SDK 调用#user_set事件设置 Adjust_id
用户在下载 app 打开后， #user_set上报前关闭且之后一直没有打开 app

转化统计中新用户的数目和 Adjust 后台相比有差异

归因平台一般会有有重归因窗口期（窗口期内的安装都不算做新安装），加上 DT 可以自己设置渠道的优先级，所以差异是天然存在且无法消除的

复制代码

上一个

广告归因

下一个

AppsFlyer Push API

最近修改: 2024-11-01

大纲