跳到主要内容

Tenjin 实时回调接口

最近更新 2026/10/03
提示

请注意，第三方数据集成产生的数据会被纳入集群的消耗数据量

概要​

接口简介​

接口名类型粒度归因成本收益展示点击转化
实时回调接口回传用户级别✅✅

Tenjin 提供了配置实时回调链接的方法，您可以通过回传激活事件获取用户粒度的归因数据。

在开始接入 Tenjin 实时回调数据前，请确保您已经阅读 AE 系统用户识别规则，理解 AE 如何通过 #distinct_id 和 #account_id 识别一个用户

集成流程​

  1. 登录 AE 后台，进入三方集成模块，新增 Tenjin 实时回调接口方案，并完成相关配置
  2. 在 Tenjin 后台配置 Webhooks，传入 AE 的回调链接
  3. 查看 AE 系统是否成功接收数据，并完成报表搭建

一、方案配置​

接入 Tenjin 回调数据的第一步，需要您登录 AE 系统后台，在「三方集成」模块中完成 Tenjin 实时回调接口方案的配置。下图是 Tenjin 实时回调接口方案的配置界面：

1.1 事件表入库设置​

打开「事件表入库设置」开关后，Tenjin 回传的数据都将写入到事件表中，我们建议您开启事件数据入库。

1.2 用户属性入库规则​

在默认情况下，AE 系统不会将 Tenjin 回传数据中写入到用户属性中。由于 Tenjin 中不存在 AE 系统的用户识别字段，回传数据无法和 AE 用户进行绑定，因此不建议您开启用户属性入库

1.3 集成配置​

您可以在集成配置模块对数据拉取的细节配置进行控制。比如入库后的事件名等

集成配置中的内容是一个 JSON，您可以按照以下内容进行自定义配置：

模块名称含义
sink_eventevent_name入库后的事件名，可以自定义。

1.4 终端地址​

1.4.1 默认配置​

若您配置了系统和项目级别数据上报地址，则显示如下链接，您可以直接复制该地址：

若此处无地址没有显示，请进入右上角菜单「项目管理 → 项目配置 → 接入配置」处配置公网地址。该地址即 AE SDK 中配置的数据上报地址。配置后再回到 Tenjin 实时回调接口配置页的「终端地址」复制终端地址。

1.4.2 自定义宏​

Tenjin 实时回调接口的回调地址中包含一种称为宏的结构，表示方法为{{macro_name}}。宏可以被认为是一种占位符，当 Tenjin 需要回传的数据中包含与宏对应的字段时，会将该字段的值填入宏所在位置。以 {{campaign_name}}为例， Tenjin 会在回传数据时，将 Campaign 的值填入回调地址中宏所在位置。

请将您刚刚获取的终端地址，替换以下地址中的开头部分，请将替换后的回调地址复制下来，之后在 Tenjin 后台中需要填入该地址：

https://{终端地址}?bundle_id={{bundle_id}}&platform={{platform}}&store_id={{store_id}}&time_in_ms={{time_in_ms}}&engaged_at_s={{engaged_at_s}}&acquired_at_ms={{acquired_at_ms}}&advertising_id={{advertising_id}}&developer_device_id={{developer_device_id}}&allow_ad_tracking={{allow_ad_tracking}}&ip_address={{ip_address}}&country={{country}}&campaign_name={{campaign_name}}&tenjin_campaign_id={{tenjin_campaign_id}}&click_id={{click_id}}&referrer={{referrer}}&site_id={{site_id}}&ad_network={{ad_network}}&device={{device}}&os_version={{os_version}}&app_version={{app_version}}&sdk_version={{sdk_version}}&language={{language}}&user_agent={{user_agent}}&creative_name={{creative_name}}&device_brand={{device_brand}}&device_model={{device_model}}&carrier={{carrier}}&locale={{locale}}&timezone={{timezone}}&tracking_status={{tracking_status}}

二、Tenjin 后台配置​

2.1 设置方法​

首先，登录 Tenjin 后台，在「CONFIGURE」-「Apps」中选择您需要配置的应用，点击「+ New Callback」新增回调

点击右上角的「Create Custom Callback」

  • 触发事件选择「App Open」事件
  • 触发条件可以选择「Ping on Every Install」
  • 回调地址处，您可以填写 1.4.2 章节我们推荐的宏

完成配置后，您可以看到如下图所示的配置信息，Active 处显示为 true，代表回调配置完毕

回调链接宏是配置在回调链接中的占位字段，当数据回传时，Tenjin 会将字段值替换这些宏。因此，宏决定了回传的字段有哪些。

下表所示的是我们推荐设置的宏，这些宏也是我们在 1.4.2 中提供的带宏回调地址中所使用的。您可以访问 Tenjin 官网获取更为详细的宏列表，如果您希望调整设置的宏，请自行修改 Tenjin 回调中的 Callback URL。

宏描述
{{bundle_id}}Bundle ID (如 com.tenjin.wordfinder)
{{platform}}平台
{{store_id}}App Store ID (数字部分)
{{time_in_ms}}请求时间（毫秒级）
{{engaged_at_s}}点击或曝光的时间戳（秒级）
{{acquired_at_ms}}安装的时间戳（毫秒级）
{{advertising_id}}设备的广告标识 ID
{{developer_device_id}}IDFV 或开发者的 Device ID
{{allow_ad_tracking}}是否允许广告追踪? (true, false 分别代表允许和不允许)
{{ip_address}}IP 地址
{{country}}用户设备的 Country code
{{campaign_name}}归因 Campaign 名
{{tenjin_campaign_id}}归因 Campaign ID
{{click_id}}Channel 的 click ID
{{referrer}}Android 端的 referrer
{{site_id}}Channel 的 site ID
{{ad_network}}来源渠道名
{{device}}设备型号
{{os_version}}设备系统版本
{{app_version}}App 版本
{{sdk_version}}Tenjin SDK 的版本
{{language}}设备的语言
{{user_agent}}设备的 User Agent
{{creative_name}}创意名
{{device_brand}}设备品牌
{{device_model}}设备机型
{{carrier}}设备运营商
{{locale}}本地化信息
{{timezone}}设备时区
{{tracking_status}}

iOS 设备的 ATT 授权状态.

0 => 待定, 1 => 受限制, 2 => 已拒绝, 3 => 授权

三、数据入库​

3.1 入库规则​

  • 由于 Tenjin 中不存在 AE 系统的用户识别字段，因此我们将使用一个固定值作为其用户标识，您可以认为所有数据挂载在一个虚拟用户上
  • 使用数据中的 time_in_ms 字段，作为事件的 #event_time
  • 默认的事件名为 -- tenjin_callback
  • 回调链接中配置的其他字段将全数入库
备注

如果您需要将用户粒度回调数据关联到 AE 用户上，那么您需要在用户属性中记录 GAID 与 IDFA（推荐记录在一个用户属性上），再通过数据回溯的方式，将 Tenjin 回调数据关联到 AE 用户上

3.2 标准化字段​

Tenjin 实时回调数据中的部分字段，AE 系统会进行标准化处理

原字段标准化字段含义
campaign_namete_ads_object.campaign_name广告计划名
tenjin_campaign_idte_ads_object.campaign_id广告计划 ID
creative_namete_ads_object.ad_name广告名
ad_networkte_ads_object.media_source媒体渠道
bundle_idte_ads_object.app_id应用 ID
platformte_ads_object.platform平台，即 Android、iOS 等
countryte_ads_object.country国家地区编码
这篇文档对你有帮助吗？
本页内容