跳到主要内容

Adjust FAQ（自查版）

最近更新 2026/10/07

1. Push API​

1.1 初始化 SDK 顺序（必看）​

警告

数数& Adjust SDK 需要严格按照以下流程初始化及接口调用

  • 初始化数数客户端 SDK
  • 通过调用自动集成或手动集成接口将 distinct_id 设置到三方事件中（设置代码参考官方文档本文不再做赘述）
  • 初始化 Adjust SDK

1.2 AE 配置 - 数据源下终端地址为空处理​

  • 在 AE 后台项目管理 — 接入配置— 数据上报地址中添加 8991 端口的服务器地址，可以向您公司运维同事确认。之后 Adjust 平台终端地址会自动同步进来。

1.3 Adjust 回传方案的几种状态​

1.3.1 状态一：接入异常​

1.3.2 接入异常的原因​

  • 创建或更新 Adjust 回传方案后 2 小时内无数据回传。
  • 72 小时内有数据接入但存在转化失败，或超过 72 小时没有新的事件回传。

1.3.3 转化失败原因解析​

  • 查看数据转化失败的原因，点击方案右上角「详情」图标，在数据详情中查看转化失败的原因

  • 场景：“转化失败，原因：用户 ID 无法关联”

    • 问题原因一：没有按照文档要求将 AE 用户标识赋值给 Adjust 事件导致
    • 问题原因二：旧版本 APP 没有设置用户标识到 Adjust 事件或者没有集成数数 SDK
    • 具体排查流程请参考 ：三方数据回传用户转化失败排查最佳实践

1.3.4 状态二：已接入​

  • 若平台接入状态为「已接入」，则说明已经从该平台接收到了数据，并且数据已经入库，此时您可以直接在集成页或每个平台的配置页点击「详情数据」查看收到的最近 1000 条数据：

1.3.5 状态三：等待接入​

  • 配置完成后没有事件回传到 AE，请确认回传 url 是否在 Adjust 后台正常配置

1.4 te_ads_object 属性是什么？能否存入其他字段？​

  • te_ads_object对象是一个标准化的对象字段，用于将不同三方平台中字段名不同但含义相同的字段统一存储在该对象中，以便后续进行分析。
  • 可以的，可以在用户属性入库规则配置模块配置，来源数据名为转化前字段目标属性名为入库字段名
    • 举例：将 Adjust 回传的原始数据字段 idfa 映射到te_ads_object对象中。

1.5 特殊事件曝光、点击、成本数据的入库规则​

  • 由于 impression、click、Ad spend 的回传数据不支持传入自定义参数，无法包含自定义用户 ID。为了接入此类数据，AE 系统自动将这些数据挂在一个“虚拟用户”身上。由于用户级别的 impression 及 click 数据量过大，建议通过 Adjust Report Service API 拉取以上事件的聚合数据。

    数据类型说明入库 AE 后事件名事件的虚拟用户
    impression曝光adjust_impressionwithout_id
    click点击adjust_clickwithout_id
    ad_revenue收入adjust_ad_revenuewithout_id

1.6 Adjust 回传方案是否支持 成本 /花费 数据回传？​

  • 不支持：由于 Adjust 限制，目前暂不支持回传成本数据。建议通过 Adjust Report Service API 拉取成本数据

1.7 Adjust 回传的 install 事件与 AE SDK 采集的 ta_app_install 事件数量不一致？​

  • 数据量差异小：

    • 通常情况是因为安装事件采集规则有所不同，ta_app_install的采集规则是只要 APP 有新安装或卸载重装行为，都会触发一次。而 Adjust SDK 的 install 事件有一定的窗口期，窗口期内卸载重装不会再次上报安装事件，Adjust 窗口期相关请参考下面文档：Attribution windows | Adjust Help Center

  • 数据量差异大：

    • 对比抽样时间是否太短、对比时区是否一致。
    • 是否有的 App 版本或渠道包没有接入 AE SDK 或 Adjust SDK。
    • 检查下三方回传方案是否是「接入异常」状态 Adjust 接入异常问题排查，然后依据文档进行排查处理

1.8 事件都转化成功，但查不到数据的原因是什么？​

  • 请确认项目是否开启了强校验模式（项目数据处理规则）。若已开启，建议先关闭该模式，等回传一批数据后再重新开启。
    • 确认是否为强校验模式方式：点击右上角设置按钮，找到项目管理并点击，然后查看数据处理规则。

1.9 归因渠道 media_source 显示 unattributed 和 restricted 问题​

2. Report Service API​

2.1 如何确认数据是否拉取成功或失败了？​

  • 配置成功后，点击方案右上角单次拉取，拉取结果将通过站内信通知。
  • 拉取成功示例
  • 拉取失败示例

2.2 核对 Report Service API 数据和 Adjust 后台数据对不上？​

  • 确认是否是维度不一样或参数配置导致数据差异

    • 是否与 Adjust 面板数据的时区一致
    • 归因设置是否全部是默认

  • 渠道类型筛选和拉取数据保持一致（目前 Report Service API 默认拉取数据类型为 network）

  • Adjust api 数据有延迟和更新变化，可以看下前几天的数据是否准确。如果只有个别日期的数据不准确可以尝试重新拉取试下

2.3 Report Service API 是否支持拉取当天数据？拉取频次应该如何选取设置？​

  • 支持拉取当天数据

  • 由于 Adjust 存在动态修正机制，无论何时收到以往数据都会对当天数据值进行动态矫正，不存在一定的数据稳定周期时间。为了确保能够拉取修正后的数据，我们将适当增加拉取时间范围。

    • 对数据实时性要求高：建议配置每小时拉取最近 3-7 天数据
    • 数据实时性无要求：建议配置每天 12 点拉取最近 3-7 天数据

  • 拉取时间维度切换方式见下图

2.4 相同方案如何配置多个 App ID？​

  • 多个 App ID 之间用英文逗号 , 隔开就好，如下图所示

2.5 重复拉取相同时间范围的数据是否会出现重复数据？​

  • 多次拉取相同时间范围的数据不会导致数据重复。相同时间范围的数据将会被新数据整体覆盖

2.6 拉取事件名如何修改？​

  • 修改 event_name 对应的值即可

2.7 Report Service API 默认拉取的attribution_types是什么​

  • 默认为all，拉取全部归因类型。

2.8 常见拉取异常及处理方案​

  • Create event and props failed!
    • 此错误通常发生在首次拉取数据或新增方案拉取字段时，可能由于服务器过载导致新字段创建失败而引发异常。建议您等待大约 10 分钟后再次尝试拉取数据。如果问题仍然存在，请向对接群中的 ThinkingAI 客户成功经理（CSM）或 ThinkingAI 技术对接人反馈。
  • The job conflicts with the scheduled
    • 此错误是因为同一拉取方案上一个拉取任务还未执行结束又执行了新的拉取任务导致。一般可忽略或等待 10 分钟左右重新拉取
  • Get thirdparty data failed! The possible error is: {"error_code":"request_error","error_desc":"User doesn't have enough permissions loc=roas","source":"API","show_error":true}
    • metrics中revenue相关的都不支持，需要移除掉，和账号权限有关。其他维度需测试

Adjust卸载事件转化失败​

  • 原因: 卸载事件不能传自定义参数
  • 解决: 如需归因数据，可以配置安装事件及其他应用内事件配置回传地址

Adjust请求报错 start_date​

  • 原因: start_date: should not be in the future
  • 解决: 定时的拉取时间需要在服务器时间之前

Adjust广告层级数据对不上​

  • 原因: 部分数据归为Unattributed，或分到campaign_name字段
  • 解决: 检查数据分布，确认归因逻辑

Adjust归因数据和 AE 后台对不上​

  • 原因: 回传数据是organic但AD后台是GG
  • 解决: 需和adjust沟通确认数据来源

Adjust FB渠道数据对不上​

Adjust SKAN相关配置​

  • 针对不同事件类型填写callback url，之后只回传对应事件到 AE
  • essential和advanced是拼接在回传地址上的占位符，需要在回传地址中配置
  • 回传地址追加占位符 created_at_milli={sk_ts}

Adjust 回传用户属性缺失​

问题： Adjust 回传事件已配置用户属性回传，但 AE 平台用户属性中没有对应字段。

原因分析：

  • Adjust 回传 URL 中的占位符配置不完整
  • 部分属性需要 Adjust SDK 侧配合传递
  • 自定义宏未在 Adjust 后台配置

解决方案：

  1. 检查 Adjust 回传 URL 中是否包含了所有需要的占位符
  2. 在 Adjust 后台配置所需的自定义宏
  3. 验证回传数据中的用户属性字段是否有值

回传 withoutID 问题​

问题： Adjust 回传数据全部显示为 "withoutID" 状态。

原因分析： Adjust 回传的安装事件在 AE 平台无法匹配到已存在的用户（#distinct_id 或 #device_id），因此标记为 "withoutID"。

解决方案：

  • 确认客户端 SDK 上报的 #device_id 与 Adjust 回传的 {adid} 一致
  • 检查 SDK 初始化是否在 Adjust SDK 之前完成
  • 验证 Adjust 回传 URL 中是否包含了设备标识参数

Adjust数据转化后显示without ID​

  • 原因: Unity SDK版本问题，需要更新到3.4.0支持Adjust 5.0以上版本

配置补充​

如何过滤渠道​

过滤渠道：

"extra_params": {"allPurpose": "{\\"partner_name__in\\":\\"xxx\\"}"}

如何使用过滤器​

使用过滤器，key直接用待过滤字段：

"extra_params": {"attribution_source": "xxx"}

如何指定广告收入平台​

指定广告收入平台：

"extra_params": {"ad_revenue_sources": "applovin_max_sdk"}

异常补充​

start_date 报错​

  • 错误信息：{"error_code":"request_error","error_desc":"KPI Service: start_date: should not be in the future (400)"}
  • 解决方案：定时的拉取时间需要在服务器时间之前。

拉取报错​

  • 错误信息：
Get thirdparty data failed! The possible error is: {"error_code":"request_error","error_desc":"Invalid app tokens. No apps matching the given app filters combination loc=app_tokens"
  • 解决方案：app_token无效， 检查app_token 和API token从属关系。
    curl 验证： 请求参数中移除app_token__in, dimensions添加app_token， 查看返回数据中包含哪些app_token 
     //请求参数中添加adjust_account_id，可以返回个人账号下所属应用的数据，配置
      "extra_params": { "adjust_account_id": 12345 }
这篇文档对你有帮助吗？
本页内容