当在引力归因引擎中完成一次用户归因匹配成功事件时，引力引擎会通过归因回调链接通知到客户自己的后端系统，客户可以通过配置接口 API 中的宏参数，来感知此次归因匹配成功事件，以便做后续的数据分析。

引力引擎的归因回调链接不是媒体平台的广告监测链接！请不要混淆这两个链接！

支持的宏参数

宏参数	备注	示例
__TURBO_APP_ID__	引力 APPID	18760451
__TURBO_PROMOTED_OBJECT_ID__	推广活动 ID	duteQV0jSIsvvfaw
__TURBO_PROMOTED_OBJECT_NAME__	推广活动名称	默认推广活动
__TURBO_CLICK_TIME__	点击时间(毫秒时间戳)	1669867980827
__TURBO_ACTIVE_TIME__	归因激活时间(毫秒时间戳)	1669867980827
__USER_INITIALIZE_TIME__	用户初始化时间(毫秒时间戳)	1669867980827
__CHANNEL__	用户渠道	用户实际渠道
__CLICK_CHANNEL__	点击渠道	点击监测链接中配置的 channel 字段
__WX_OPENID__	微信/抖音 open_id	o2URF5TjZdLG_LnSH4Vf67Knx
__CLIENT_ID__	用户 client_id	gXrXc69C
__USER_NAME__	用户名
__AD_PLATFORM__	媒体平台	允许的枚举值请参考：广告平台枚举值
__ADVERTISER_ID__	广告主账户 ID	19489328734
__CAMPAIGN_ID__	广告计划 ID	2329843543
__CAMPAIGN_NAME__	广告计划名称	测试计划
__AD_ID__	广告 ID	232456464
__AD_NAME__	广告名称	测试广告
__CREATIVE_ID__	广告创意 ID	23495848545
__CREATIVE_NAME__	广告创意名称	测试创意
__PROJECT_ID__	巨量引擎项目 ID（请使用__CAMPAIGN_ID__替代，后续将停止下发）	ID: 7074140945750507528
__PROMOTION_ID__	巨量引擎广告 ID（请使用__AD_ID__替代，后续将停止下发）	ID: 7074806092097929253
__MID1__	巨量引擎图片素材宏参数（下发原始素材 id）
__MID2__	巨量引擎标题素材宏参数（下发原始素材 id）
__MID3__	巨量引擎视频素材宏参数（下发原始素材 id）
__MID4__	巨量引擎搭配试玩素材宏参数（下发原始素材 id）
__MID5__	巨量引擎落地页素材宏参数（下发原始素材 id）
__MID6__	巨量引擎安卓下载详情页素材宏参数（下发原始素材 id）
__MID7__	巨量引擎抖音小游戏试玩素材宏参数（下发原始素材id）
__MID8__	巨量引擎抖音小游戏直玩素材宏参数（下发原始素材id）
__CLICK_IP__	点击 IP	192.174.3.2
__ACTIVE_IP__	激活 IP	192.174.3.2
__CSITE__	广告投放版位
__OS_TYPE__	设备类型	ios/android
__ROM__	ROM	miui
__DEVICE_BRAND__	设备品牌	xiaomi
__DEVICE_MODEL__	设备型号	mi 9
__IMEI__	imei
__OAID__	OAID
__CAID1_MD5__	当前用户中广协 ID 的 md5 hash（20230330 版本）
__CAID2_MD5__	当前用户中广协 ID 的 md5 hash（20220111/20250325 版本）
__ANDROID_ID__	Android id
__MAC__	MAC 地址
__ANDROID_VERSION__	Android api version
__IDFA__	IDFA
__IDFV__	IDFV
__ASA_KEYWORD_ID__	ASA 关键词 ID
__ASA_CONVERSION_TYPE__	ASA 转化类型
__ASA_COUNTRY_OR_REGION__	ASA 地区
__ASA_CLAIM_TYPE__	ASA 归因类型	枚举值：Click/Impression
__STAR_ITEM_ID__	巨量星图视频ID
__STAR_LIVE_ITEM_ID__	巨量星图直播场景room_id
__STAR_AWEME_ITEM_ID__	巨量星图短视频场景video_id
__STAR_GAME_CHANNEL__	巨量星图场景枚举	1 - 直播 2 - 短视频 3 - 内容社区
__STAR_ORDER_ID__	巨量星图任务ID
__STAR_DEMAND_ID__	巨量星图计划ID
__STAR_AWEME_AUTHOR_ID__	巨量星图抖音达人的uid
__CUSTOM_PARAMS__	自定义参数，您可以在引力提供的监测链接后使用 custom_params 作为 key，自定义自己的参数，引力会直接透传
__EXTRA_PARAMS__	媒体监测链接中的其他参数，会拼接成 json 字符串，例如：{"key1":"value1","key2":"value2"} ，放在 __EXTRA_PARAMS__ 宏参中
__TENCENT_CLICK_ID__	腾讯点击 ID，只在归因为腾讯的用户下有值
__MATERIAL_ID__	媒体素材ID
__RETARGETING_COUNT__	再归因次数(再归因为自然量时，不统计)	当前用户执行过的再归因次数，首次归因为 0，第一次再归因为 1，依次类推
__LATEST_RETARGETING_TIME__	最新再归因时间(毫秒时间戳，再归因为自然量时，不统计)	1669867980827
__OPERATOR_NAME__	优化师信息	当前用户对应推广活动所绑定的优化师信息，例如（张三-1）
__LTS_ATTRIBUTION_BUNDLE_ID__	最近一次归因的应用包名	例如：com.gravity.test

使用方法

例如：您目前只关心，在发生归因匹配成功时，对应用户的广告组 ID、广告计划 ID、手机系统，则您只需要将**__CAMPAIGN_ID__、__AD_ID__、__OS_TYPE__**三个宏参数加入到后端链接中，假设您的域名是：https://your.domain.com 接口是track 则您配置的归因回调链接可能是这样：

https://your.domain.com/track?campaign_id=__CAMPAIGN_ID__&ad_id=__AD_ID__&os_type=__OS_TYPE__

在发生归因匹配成功事件时，引力引擎会替换里面的宏参数，并发起 Get 请求这个链接，具体需要哪些参数，您可以自行根据需求定义。

兜底回调链接

为了避免每个推广活动都需要配置一遍归因回调链接，我们提供了兜底回调链接，在回调触发时，会优先使用推广活动下的归因回调链接，若当前推广活动没有配置，则取兜底回调链接来完成归因信息的数据回调。

您可以在引力后台-设置-应用管理-配置中添加兜底回调链接