跳到主要内容

三方数据回传用户转化失败排查最佳实践

最近更新 2026/10/05

一、背景​

客户在接入和使用三方数据回传方案时，经常会遇到用户 ID 转化失败的问题。这类问题在日常问题处理中占据较高比例，影响了数据的准确性和业务决策的有效性。为了指导内部同事和外部客户更好地排查和解决此类问题，编写了本最佳实践文档，提供了一套系统性的排查指南和解决方案。

提示

Adjust ：adjust push api 配置文档

AppsFlyer：appsflyer push api 配置文档

热力引擎：热力引擎 push api 配置文档

二、SDK 初始化顺序（重要）​

警告

数数&三方 SDK 需要严格按照以下流程初始化及接口调用，如果确定代码初始化流程没问题再往下看

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

三、问题场景​

提示

  • App 版本号 ：转化前数据 app_version 为 app 版本， 如果转化前数据没有 app_version 字段需要在三方平台配置回传下。

  • 事件名 ：

    • Appsflyer: 使用转化前数据 event_name 作为事件名
    • Adjust: 事件名采用优先级 activity_kind（值不为"event"） > event_token > event_name
    • 热力引擎：使用转化前数据 event_name 作为事件名

  • 场景一：

    • 同一个 APP 版本，install 事件并未携带 distinct_id，而其它事件则携带了 distinct_id。

      • 三方 install 事件采集原理：
        • 在使用第三方 SDK 追踪应用安装时，install 事件是 SDK 初始化后自动上报的首个事件。如果在 SDK 初始化后才设置用户标识符（distinct_id），则 install 事件将无法包含该 distinct_id，因为 install 事件在 distinct_id 设置之前就已经触发
      • 问题原因：数数客户端 SDK 在三方 SDK 初始化后才初始化导致
      • 解决方案：将数数客户端 SDK 及设置 did 接口调整到三方 SDK 前初始化及调用

  • 场景二：

    • 不同的 APP 版本中，有些版本带上了 distinct_id，而有些版本则没有带上。
      • 核实是否存在部分

  • 场景三：

    • SDK 初始化顺序流程核实没问题，回传的所有事件全部显示用户转化失败。

  • 场景四：

    • 以上场景都正常，那么请确认下有没有在三方后台将用户识别字段返回到 AE

      • AppsFlyer 请确认是否勾选了 Custom Data & Customer User ID 两个字段
      • Adjust 请确认配置的回传链接有没有携带publisher_parameters={publisher_parameters}参数，没有的话需要加上
      • 热力引擎请确认回传地址有没有携带 event_custom_params 参数
这篇文档对你有帮助吗？
本页内容