SolarEngine(以下简称:SE)面向企业客户提供一站式营销解决方案服务;在与合作渠道数据对接上,可通过该说明文档完成数据对接。本文档定义了广告数据接收与转化数据回调能力,阅读对象为双方产品、开发及测试人员。
SE通过监测链接获取渠道广告监测数据,监测链接通常包含展示链接(Impression URL)和点击链接(Click URL),分别用于追踪广告展示与点击情况。
监测链接主要由"https://tkio-redirect.solar-engine.com/receive/turl/xxxxxxx?”+"参数"+其他部分组成,格式如下:
(1) 监测链接的前缀格式为:https://tkio-redirect.solar-engine.com/receive/turl/xxxxxxx?
(2) 宏“参数”的格式为“{参数}”,其中:
l 参数为小写
l “{参数}” 格式中参数两边为花括号
当广告被展示或点击时,渠道按照约定的格式,将真实广告信息通过宏参替换给SE即可
参数名 | 枚举 | 说明 |
account_id | 9dfe8503-5d3f-4440-bb3f-9e45b6179a4f | 广告账户id |
adgroup_id | 1725113652546577 | 广告组id |
adgroup_name | kup_and_tier_6 | 广告组名称 |
adplan_id | 17251136512312451 | 广告计划id |
adplan_name | kup_and_tier | 广告计划名称 |
adcreative_id | 17251136512342351 | 广告创意id |
adcreative_name | kup_and_tier_ad | 广告创意名称 |
adcreative_type | 创意类型(如大图、小图、视频等) | |
site_id | 23423233244 | 流量媒体id |
site_name | 快手 | 流量媒体名称 |
ad_type | 开屏 | 广告类型(如开屏、信息流、搜索等) |
placement_id | 342323324412 | 广告位id |
conversion_id | 323324412131 | 转化id |
click_id | 2342323124 | 广告点击id |
impression_id | 2342312312 | 广告展示id |
request_id | 2342323324 | 广告请求id |
callback_id | EJiw267wvfQCGKf2g74ZIPD89-vIATAMOAFCIjIwMTkxMTI3MTQxMTEzMDEwMDI2MDc3MjE1MTUwNTczNTBIAQ== | 渠道回调id |
callback_url | http%3A%2F%2Ftracking.e.qq.com%2Fconv%3Fcb%3DMTIzYWJjNDU2ZGVm%26conv_id%3D12345678 | 渠道回调地址 |
os | 操作系统 | |
model | Mate 40 | 设备型号 |
ipv4 | 1.1.1.1 | 用户公网IP V4版本,服务端上报展点必传 |
ipv6 | 2409%3A8a55%3A4cc0%3A4050%3A2507%3A4922%3Abbe0%3A524b | 用户公网IP V6版本 |
ua | Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/95.0.4638.54 Safari/537.36 | 用户代理信息服务端上报展点必传 |
idfa | 3DEA635F-B24F-434B-833F-4ED028FEAEEF | iOS IDFA原值 |
idfa_md5 | 8e488a40a17aed2f6752f51382a4eafc | iOS IDFA原值MD5后转小写 |
idfv | 3DEA635F-B24F-434B-833F-4ED028FEAEEF | iOS IDFV原值 |
idfv_md5 | 8e488a40a17aed2f6752f51382a4eafc | iOS IDFV原值MD5后转小写 |
oaid | 3DEA635F-B24F-434B-833F-4ED028FEAEEF | Android OAID原值 |
oaid_md5 | 8e488a40a17aed2f6752f51382a4eafc | Android OAID原值MD5后转小写 |
imei1 | 8342732742383 | Android主卡IMEI原值 |
imei1_md5 | 8e488a40a17aed2f6752f51382a4eafc | Android主卡IMEI原值MD5后转小写 |
imei2 | 8342732742383 | Android副卡IMEI原值 |
imei2_md5 | 8e488a40a17aed2f6752f51382a4eafc | Android副卡IMEI原值MD5后转小写 |
gaid | B21C5EC5-9921-42FD-AAC5-07A0EB6CF1A0 | Google Advertising ID原值 |
gaid_md5 | 8e488a40a17aed2f6752f51382a4eafc | Google Advertising ID原值MD5后转小写 |
mac | B21C5EC5-9921-42FD-AAC5-07A0EB6CF1A0 | MAC原值 |
mac_md5 | 8e488a40a17aed2f6752f51382a4eafc | MAC原值MD5后转小写 |
android_id | 1a34fc556a43c453 | Android ID原值 |
android_id_md5 | 8e488a40a17aed2f6752f51382a4eafc | Android ID原值MD5后转小写 |
caid | [{"version":"20220111","caid":"912ec803b2ce49e4a541068d495ab570"},{"version":"20211207","caid":"e332a76c29654fcb7f6e6b31ced090c7"}] | ios的caid |
caid1 | ||
caid2 | ||
caid_md5 | [{"version":"20220111","caid_md5":"5259ee4a034fdeddd1b65be92debe731"},{"version":"20211207","caid_md5":"fb897e26ae333f8a0e4eac5aeb1a2c68"}] | ios的caid md5 |
caid1_md5 | ||
caid2_md5 | ||
amazon_id | 亚马逊设备amazon_id | |
amazon_id_md5 | ||
is_s2s | l 1=服务器上报触点 l 0=客户端上报触点 | 是否是服务器端到端数据传输 |
custom_params_1 | 23423523424 | 自定义触点参数。固定的key名称 |
custom_params_2 | 23423523425 | 自定义触点参数。固定的key名称 |
custom_params_3 | 23423523426 | 自定义触点参数。固定的key名称 |
custom_params_4 | 234235234247 | 自定义触点参数。固定的key名称 |
custom_params_5 | 23423523428 | 自定义触点参数。固定的key名称 |
custom_params_6 | 23423523429 | 自定义触点参数。固定的key名称 |
custom_params_7 | 23423523420 | 自定义触点参数。固定的key名称 |
custom_params_8 | 23423523421 | 自定义触点参数。固定的key名称 |
custom_params_9 | 23423523422 | 自定义触点参数。固定的key名称 |
custom_params_10 | 23423523424 | 自定义触点参数。固定的key名称 |
SE支持将行为数据回调至渠道,用于优化渠道投放广告模型与算法,帮助广告主提升投放效果,提升ROI。以下列表为SE支持回调的参数及说明。
数据回调主要分为三部分:install&event回调,变现数据回调,反作弊安装回调。不同的类型回调支持回调参数主要包括以下:
Install&event
参数名 | 枚举 | 说明 |
attribution_touch_type | l Clickl Impression | 归因类型 |
attribution_method | l deviceidl probabilisticl meta_referrer | 归因模型Deviceid为用设备ID进行归因 probabilistict为用IP、UA进行归因 Meta_referrer为用referrer方法进行归因 |
attribution_lbw | 604800 | 归因时间窗 |
attribution_ttit | 80940 | 激活到触点的差值 |
ry_touchpoint_ts | 1671161460000 | 归因触点时间 |
install_time | 1671242400000 | 激活时间 |
attribution_time | 1671242410000 | 归因时间 |
turl_campaign_id | 12314125 | 推广计划id |
turl_campaign_name | Big Makeover_And | 推广计划名称 |
turl_id | 123124151 | 短链id |
channel_id | 514 | 渠道id |
channel_name | 快手 | 归因的渠道名称 |
attribution_type | UA | UA(标识拉新) |
event_name | install(激活)startup(启动)register(注册) login(登陆)order(订单)purchase(付费) | 事件名若对接其他事件,单独开发 |
order_amount | 30 | 事件收入 |
currency_type | CNY | 事件币种 |
account_id | 123124125 | 渠道推广账号ID |
adgroup_id | 123141251 | 渠道推广广告组ID |
adgroup_name | kup_and_tier_6 | 渠道推广广告组名称 |
adplan_id | 312312455 | 渠道推广计划ID |
adplan_name | kup_and_tier | 渠道推广计划名称 |
adcreative_id | 13125125 | 渠道推广使用素材ID |
adcreative_name | kup_and | 渠道推广使用素材名称 |
adcreative_type | 大图 | 渠道推广使用素材类型 |
site_id | 13125125123 | 子渠道ID |
site_name | 快手 | 子渠道名称 |
ad_type | 15 | 渠道推广广告类型 |
placement_id | 1312125125 | 渠道推广广告位ID |
conversion_id | 12312314115 | 广告位id |
click_id | 1312312412515152 | 渠道推广点击唯一ID |
impression_id | 2131231241241415 | 渠道推广展示唯一ID |
request_id | 1231231241241251 | 广告请求id |
callback_id | 1312312155343434 | 回调ID |
custom_params_1 | - | 渠道推广自定义参数1-10 |
custom_params_2 | - | 渠道推广自定义参数1-10 |
custom_params_3 | - | 渠道推广自定义参数1-10 |
custom_params_4 | - | 渠道推广自定义参数1-10 |
custom_params_5 | - | 渠道推广自定义参数1-10 |
custom_params_6 | - | 渠道推广自定义参数1-10 |
custom_params_7 | - | 渠道推广自定义参数1-10 |
custom_params_8 | - | 渠道推广自定义参数1-10 |
custom_params_9 | - | 渠道推广自定义参数1-10 |
custom_params_10 | - | 渠道推广自定义参数1-10 |
callback_data_ source | l 1:本渠道 l 0:其他渠道 | 标记回调数据来源 |
gaid | 9C3FA051-DB2A-4F4F-9154-BC15EF565760 | - |
gaid_md5 | 8e488a40a17aed2f6752f51382a4eafc | - |
imei1 | 8342732131333 | - |
imei1_md5 | 8342732742123 | - |
imei2 | 8342732123412 | - |
imei2_md5 | 8342732312314 | - |
oaid | 3DEA635F-B24F-434B-833F-4ED028FEAEEF | - |
oaid_md5 | 8e488a40a17aed2f6752f51382a4eafc | - |
mac | 23456787898767898 | - |
mac_md5 | 2345678789876741 | - |
android_id | 1a34fc556a43c453 | - |
android_id_md5 | 8e488a40a17aed2f6752f51382a4eafc | - |
ipv4 | 1.1.1.1 | - |
ipv6 | 2409%3A8a55%3A4cc0%3A4050%3A2507%3A4922%3Abbe0%3A524b | - |
ua | Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/95.0.4638.54 Safari/537.36 | - |
manufacturer | HUAWEI | 设备品牌 |
model | Mate 40 | 设备机型 |
os | 1 | 设备平台,如Android |
os_version | 14.1 | 设备系统版本 |
参数名 | 枚举 | 说明 |
attribution_touch_type | l Clickl Impression | 归因类型 |
attribution_method | l deviceidl probabilisticl meta_referrer | 归因模型deviceid为用设备ID进行归因probabilistic为用IP、UA进行归因 Meta_referrer为用referrer方法进行归因 |
attribution_lbw | 604800 | 归因时间窗 |
attribution_ttit | 80940 | 激活到触点的差值 |
ry_touchpoint_ts | 1671161460000 | 归因触点时间 |
install_time | 1671242400000 | 激活时间 |
attribution_time | 1671242410000 | 归因时间 |
turl_campaign_id | 12314125 | 推广计划id |
turl_campaign_name | Big Makeover_And | 推广计划名称 |
turl_id | 123124151 | 短链id |
channel_id | 514 | 渠道id |
channel_name | 快手 | 归因的渠道名称 |
attribution_type | UA | UA(标识拉新) |
event_name | adimpression | Ad rev |
adrev | 30 | 变现事件收入 |
currency_type | CNY | 事件币种 |
account_id | 123124125 | 渠道推广账号ID |
adgroup_id | 123141251 | 渠道推广广告组ID |
adgroup_name | kup_and_tier_6 | 渠道推广广告组名称 |
adplan_id | 312312455 | 渠道推广计划ID |
adplan_name | kup_and_tier | 渠道推广计划名称 |
adcreative_id | 13125125 | 渠道推广使用素材ID |
adcreative_name | kup_and | 渠道推广使用素材名称 |
adcreative_type | 大图 | 渠道推广使用素材类型 |
site_id | 13125125123 | 子渠道ID |
site_name | 快手 | 子渠道名称 |
ad_type | 15 | 渠道推广广告类型 |
placement_id | 1312125125 | 渠道推广广告位ID |
conversion_id | 12312314115 | 广告位id |
click_id | 1312312412515152 | 渠道推广点击唯一ID |
impression_id | 2131231241241415 | 渠道推广展示唯一ID |
request_id | 1231231241241251 | 广告请求id |
callback_id | 1312312155343434 | 回调ID |
custom_params_1 | - | 渠道推广自定义参数1-10 |
custom_params_2 | - | 渠道推广自定义参数1-10 |
custom_params_3 | - | 渠道推广自定义参数1-10 |
custom_params_4 | - | 渠道推广自定义参数1-10 |
custom_params_5 | - | 渠道推广自定义参数1-10 |
custom_params_6 | - | 渠道推广自定义参数1-10 |
custom_params_7 | - | 渠道推广自定义参数1-10 |
custom_params_8 | - | 渠道推广自定义参数1-10 |
custom_params_9 | - | 渠道推广自定义参数1-10 |
custom_params_10 | - | 渠道推广自定义参数1-10 |
callback_data_ source | l 1:本渠道l 0:其他渠道 | 标记回调数据来源 |
gaid | 9C3FA051-DB2A-4F4F-9154-BC15EF565760 | - |
gaid_md5 | 8e488a40a17aed2f6752f51382a4eafc | - |
imei1 | 8342732131333 | - |
imei1_md5 | 8342732742123 | - |
imei2 | 8342732123412 | - |
imei2_md5 | 8342732312314 | - |
oaid | 3DEA635F-B24F-434B-833F-4ED028FEAEEF | - |
oaid_md5 | 8e488a40a17aed2f6752f51382a4eafc | - |
mac | 23456787898767898 | - |
mac_md5 | 2345678789876741 | - |
android_id | 1a34fc556a43c453 | - |
android_id_md5 | 8e488a40a17aed2f6752f51382a4eafc | - |
ipv4 | 1.1.1.1 | - |
ipv6 | 2409%3A8a55%3A4cc0%3A4050%3A2507%3A4922%3Abbe0%3A524b | - |
ua | Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/95.0.4638.54 Safari/537.36 | - |
manufacturer | HUAWEI | 设备品牌 |
model | Mate 40 | 设备机型 |
os | 1 | 设备平台,如Android |
os_version | 14.1 | 设备系统版本 |
参数名 | 枚举 | 说明 |
attribution_touch_type | l Clickl Impression | 归因类型 |
attribution_method | l deviceidl probabilisticl meta_referrer | 归因模型Deviceid为用设备ID进行归因probabilistic为用IP、UA进行归因Meta_referrer为用referrer方法进行归因 |
attribution_lbw | 604800 | 归因时间窗 |
attribution_ttit | 80940 | 激活到触点的差值 |
ry_touchpoint_ts | 1671161460000 | 归因触点时间 |
install_time | 1671242400000 | 激活时间 |
attribution_time | 1671242410000 | 归因时间 |
turl_campaign_id | 12314125 | 推广计划id |
turl_campaign_name | Big Makeover_And | 推广计划名称 |
turl_id | 123124151 | 短链id |
channel_id | 514 | 渠道id |
channel_name | 快手 | 归因的渠道名称 |
attribution_type | UA | UA(标识拉新) |
event_name | Rejected_install | Rejected_install |
account_id | 123124125 | 渠道推广账号ID |
adgroup_id | 123141251 | 渠道推广广告组ID |
adgroup_name | kup_and_tier_6 | 渠道推广广告组名称 |
adplan_id | 312312455 | 渠道推广计划ID |
adplan_name | kup_and_tier | 渠道推广计划名称 |
adcreative_id | 13125125 | 渠道推广使用素材ID |
adcreative_name | kup_and | 渠道推广使用素材名称 |
adcreative_type | 大图 | 渠道推广使用素材类型 |
site_id | 13125125123 | 子渠道ID |
site_name | 快手 | 子渠道名称 |
ad_type | 15 | 渠道推广广告类型 |
placement_id | 1312125125 | 渠道推广广告位ID |
conversion_id | 12312314115 | 广告位id |
click_id | 1312312412515152 | 渠道推广点击唯一ID |
impression_id | 2131231241241415 | 渠道推广展示唯一ID |
request_id | 1231231241241251 | 广告请求id |
callback_id | 1312312155343434 | 回调ID |
custom_params_1 | - | 渠道推广自定义参数1-10 |
custom_params_2 | - | 渠道推广自定义参数1-10 |
custom_params_3 | - | 渠道推广自定义参数1-10 |
custom_params_4 | - | 渠道推广自定义参数1-10 |
custom_params_5 | - | 渠道推广自定义参数1-10 |
custom_params_6 | - | 渠道推广自定义参数1-10 |
custom_params_7 | - | 渠道推广自定义参数1-10 |
custom_params_8 | - | 渠道推广自定义参数1-10 |
custom_params_9 | - | 渠道推广自定义参数1-10 |
custom_params_10 | - | 渠道推广自定义参数1-10 |
callback_data_ source | 1:本渠道 0:其他渠道 | 标记回调数据来源 |
gaid | l 9C3FA051-DB2A-4F4F-9154-BC15EF565760 | - |
gaid_md5 | 8e488a40a17aed2f6752f51382a4eafc | - |
imei1 | 8342732131333 | - |
imei1_md5 | 8342732742123 | - |
imei2 | 8342732123412 | - |
imei2_md5 | 8342732312314 | - |
oaid | 3DEA635F-B24F-434B-833F-4ED028FEAEEF | - |
oaid_md5 | 8e488a40a17aed2f6752f51382a4eafc | - |
mac | 23456787898767898 | - |
mac_md5 | 2345678789876741 | - |
android_id | 1a34fc556a43c453 | - |
android_id_md5 | 8e488a40a17aed2f6752f51382a4eafc | - |
ipv4 | 1.1.1.1 | - |
ipv6 | 2409%3A8a55%3A4cc0%3A4050%3A2507%3A4922%3Abbe0%3A524b | - |
ua | Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/95.0.4638.54 Safari/537.36 | - |
manufacturer | HUAWEI | 设备品牌 |
model | Mate 40 | 设备机型 |
os | 1 | 设备平台,如Android |
os_version | 14.1 | 设备系统版本 |
Rejected_install | 0:no 1:yes | 如果为reject数据,则固定为1 |
Rejected_reason | 反作弊拦截原因 |