菜单

附:渠道对接SE文档


1.概述

SolarEngine(以下简称:SE)面向企业客户提供一站式营销解决方案服务;在与合作渠道数据对接上,可通过该说明文档完成数据对接。本文档定义了广告数据接收与转化数据回调能力,阅读对象为双方产品、开发及测试人员。

2. 展点数据接收

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即可

2.1参数说明

参数名枚举说明
account_id9dfe8503-5d3f-4440-bb3f-9e45b6179a4f广告账户id
adgroup_id1725113652546577广告组id
adgroup_namekup_and_tier_6广告组名称
adplan_id17251136512312451广告计划id
adplan_namekup_and_tier广告计划名称
adcreative_id17251136512342351广告创意id
adcreative_namekup_and_tier_ad广告创意名称
adcreative_type创意类型(如大图、小图、视频等)
site_id23423233244流量媒体id
site_name快手流量媒体名称
ad_type开屏广告类型(如开屏、信息流、搜索等)
placement_id342323324412广告位id
conversion_id323324412131转化id
click_id2342323124广告点击id
impression_id2342312312广告展示id
request_id2342323324广告请求id
callback_idEJiw267wvfQCGKf2g74ZIPD89-vIATAMOAFCIjIwMTkxMTI3MTQxMTEzMDEwMDI2MDc3MjE1MTUwNTczNTBIAQ==渠道回调id
callback_urlhttp%3A%2F%2Ftracking.e.qq.com%2Fconv%3Fcb%3DMTIzYWJjNDU2ZGVm%26conv_id%3D12345678渠道回调地址
os操作系统
modelMate 40设备型号
ipv41.1.1.1用户公网IP V4版本,服务端上报展点必传
ipv62409%3A8a55%3A4cc0%3A4050%3A2507%3A4922%3Abbe0%3A524b用户公网IP V6版本
uaMozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/95.0.4638.54 Safari/537.36用户代理信息服务端上报展点必传
idfa3DEA635F-B24F-434B-833F-4ED028FEAEEFiOS IDFA原值
idfa_md58e488a40a17aed2f6752f51382a4eafciOS IDFA原值MD5后转小写
idfv3DEA635F-B24F-434B-833F-4ED028FEAEEFiOS IDFV原值
idfv_md58e488a40a17aed2f6752f51382a4eafciOS IDFV原值MD5后转小写
oaid3DEA635F-B24F-434B-833F-4ED028FEAEEFAndroid OAID原值
oaid_md58e488a40a17aed2f6752f51382a4eafcAndroid OAID原值MD5后转小写
imei18342732742383Android主卡IMEI原值
imei1_md58e488a40a17aed2f6752f51382a4eafcAndroid主卡IMEI原值MD5后转小写
imei28342732742383Android副卡IMEI原值
imei2_md58e488a40a17aed2f6752f51382a4eafcAndroid副卡IMEI原值MD5后转小写
gaidB21C5EC5-9921-42FD-AAC5-07A0EB6CF1A0Google Advertising ID原值
gaid_md58e488a40a17aed2f6752f51382a4eafcGoogle Advertising ID原值MD5后转小写
macB21C5EC5-9921-42FD-AAC5-07A0EB6CF1A0MAC原值
mac_md58e488a40a17aed2f6752f51382a4eafcMAC原值MD5后转小写
android_id1a34fc556a43c453Android ID原值
android_id_md58e488a40a17aed2f6752f51382a4eafcAndroid 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_s2sl 1=服务器上报触点
l 0=客户端上报触点
是否是服务器端到端数据传输
custom_params_123423523424自定义触点参数。固定的key名称
custom_params_223423523425自定义触点参数。固定的key名称
custom_params_323423523426自定义触点参数。固定的key名称
custom_params_4234235234247自定义触点参数。固定的key名称
custom_params_523423523428自定义触点参数。固定的key名称
custom_params_623423523429自定义触点参数。固定的key名称
custom_params_723423523420自定义触点参数。固定的key名称
custom_params_823423523421自定义触点参数。固定的key名称
custom_params_923423523422自定义触点参数。固定的key名称
custom_params_1023423523424自定义触点参数。固定的key名称

3. 数据回调

SE支持将行为数据回调至渠道,用于优化渠道投放广告模型与算法,帮助广告主提升投放效果,提升ROI。以下列表为SE支持回调的参数及说明。

数据回调主要分为三部分:install&event回调,变现数据回调,反作弊安装回调。不同的类型回调支持回调参数主要包括以下:

Install&event

3.1参数说明

参数名枚举说明
attribution_touch_typel Clickl Impression归因类型
attribution_methodl deviceidl probabilisticl meta_referrer归因模型Deviceid为用设备ID进行归因
probabilistict为用IP、UA进行归因
Meta_referrer为用referrer方法进行归因
attribution_lbw604800归因时间窗
attribution_ttit80940激活到触点的差值
ry_touchpoint_ts1671161460000归因触点时间
install_time1671242400000激活时间
attribution_time1671242410000归因时间
turl_campaign_id12314125推广计划id
turl_campaign_nameBig Makeover_And推广计划名称
turl_id123124151短链id
channel_id514渠道id
channel_name快手归因的渠道名称
attribution_typeUAUA(标识拉新)
event_nameinstall(激活)startup(启动)register(注册)
login(登陆)order(订单)purchase(付费)
事件名若对接其他事件,单独开发
order_amount30事件收入
currency_typeCNY事件币种
account_id123124125渠道推广账号ID
adgroup_id123141251渠道推广广告组ID
adgroup_namekup_and_tier_6渠道推广广告组名称
adplan_id312312455渠道推广计划ID
adplan_namekup_and_tier渠道推广计划名称
adcreative_id13125125渠道推广使用素材ID
adcreative_namekup_and渠道推广使用素材名称
adcreative_type大图渠道推广使用素材类型
site_id13125125123子渠道ID
site_name快手子渠道名称
ad_type15渠道推广广告类型
placement_id1312125125渠道推广广告位ID
conversion_id12312314115广告位id
click_id1312312412515152渠道推广点击唯一ID
impression_id2131231241241415渠道推广展示唯一ID
request_id1231231241241251广告请求id
callback_id1312312155343434回调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_ sourcel 1:本渠道
l 0:其他渠道
标记回调数据来源
gaid9C3FA051-DB2A-4F4F-9154-BC15EF565760-
gaid_md58e488a40a17aed2f6752f51382a4eafc-
imei18342732131333-
imei1_md58342732742123-
imei28342732123412-
imei2_md58342732312314-
oaid3DEA635F-B24F-434B-833F-4ED028FEAEEF-
oaid_md58e488a40a17aed2f6752f51382a4eafc-
mac23456787898767898-
mac_md52345678789876741-
android_id1a34fc556a43c453-
android_id_md58e488a40a17aed2f6752f51382a4eafc-
ipv41.1.1.1-
ipv62409%3A8a55%3A4cc0%3A4050%3A2507%3A4922%3Abbe0%3A524b-
uaMozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/95.0.4638.54 Safari/537.36-
manufacturerHUAWEI设备品牌
modelMate 40设备机型
os1设备平台,如Android
os_version14.1设备系统版本

变现数据回调

3.2参数说明

参数名枚举说明
attribution_touch_typel Clickl Impression归因类型
attribution_methodl deviceidl probabilisticl meta_referrer归因模型deviceid为用设备ID进行归因probabilistic为用IP、UA进行归因
Meta_referrer为用referrer方法进行归因
attribution_lbw604800归因时间窗
attribution_ttit80940激活到触点的差值
ry_touchpoint_ts1671161460000归因触点时间
install_time1671242400000激活时间
attribution_time1671242410000归因时间
turl_campaign_id12314125推广计划id
turl_campaign_nameBig Makeover_And推广计划名称
turl_id123124151短链id
channel_id514渠道id
channel_name快手归因的渠道名称
attribution_typeUAUA(标识拉新)
event_nameadimpressionAd rev
adrev30变现事件收入
currency_typeCNY事件币种
account_id123124125渠道推广账号ID
adgroup_id123141251渠道推广广告组ID
adgroup_namekup_and_tier_6渠道推广广告组名称
adplan_id312312455渠道推广计划ID
adplan_namekup_and_tier渠道推广计划名称
adcreative_id13125125渠道推广使用素材ID
adcreative_namekup_and渠道推广使用素材名称
adcreative_type大图渠道推广使用素材类型
site_id13125125123子渠道ID
site_name快手子渠道名称
ad_type15渠道推广广告类型
placement_id1312125125渠道推广广告位ID
conversion_id12312314115广告位id
click_id1312312412515152渠道推广点击唯一ID
impression_id2131231241241415渠道推广展示唯一ID
request_id1231231241241251广告请求id
callback_id1312312155343434回调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_ sourcel 1:本渠道l 0:其他渠道标记回调数据来源
gaid9C3FA051-DB2A-4F4F-9154-BC15EF565760-
gaid_md58e488a40a17aed2f6752f51382a4eafc-
imei18342732131333-
imei1_md58342732742123-
imei28342732123412-
imei2_md58342732312314-
oaid3DEA635F-B24F-434B-833F-4ED028FEAEEF-
oaid_md58e488a40a17aed2f6752f51382a4eafc-
mac23456787898767898-
mac_md52345678789876741-
android_id1a34fc556a43c453-
android_id_md58e488a40a17aed2f6752f51382a4eafc-
ipv41.1.1.1-
ipv62409%3A8a55%3A4cc0%3A4050%3A2507%3A4922%3Abbe0%3A524b-
uaMozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/95.0.4638.54 Safari/537.36-
manufacturerHUAWEI设备品牌
modelMate 40设备机型
os1设备平台,如Android
os_version14.1设备系统版本

反作弊安装回调

3.3参数说明

参数名枚举说明
attribution_touch_typel Clickl Impression归因类型
attribution_methodl deviceidl probabilisticl meta_referrer归因模型Deviceid为用设备ID进行归因probabilistic为用IP、UA进行归因Meta_referrer为用referrer方法进行归因
attribution_lbw604800归因时间窗
attribution_ttit80940激活到触点的差值
ry_touchpoint_ts1671161460000归因触点时间
install_time1671242400000激活时间
attribution_time1671242410000归因时间
turl_campaign_id12314125推广计划id
turl_campaign_nameBig Makeover_And推广计划名称
turl_id123124151短链id
channel_id514渠道id
channel_name快手归因的渠道名称
attribution_typeUAUA(标识拉新)
event_nameRejected_installRejected_install
account_id123124125渠道推广账号ID
adgroup_id123141251渠道推广广告组ID
adgroup_namekup_and_tier_6渠道推广广告组名称
adplan_id312312455渠道推广计划ID
adplan_namekup_and_tier渠道推广计划名称
adcreative_id13125125渠道推广使用素材ID
adcreative_namekup_and渠道推广使用素材名称
adcreative_type大图渠道推广使用素材类型
site_id13125125123子渠道ID
site_name快手子渠道名称
ad_type15渠道推广广告类型
placement_id1312125125渠道推广广告位ID
conversion_id12312314115广告位id
click_id1312312412515152渠道推广点击唯一ID
impression_id2131231241241415渠道推广展示唯一ID
request_id1231231241241251广告请求id
callback_id1312312155343434回调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_ source1:本渠道 0:其他渠道标记回调数据来源
gaidl 9C3FA051-DB2A-4F4F-9154-BC15EF565760-
gaid_md58e488a40a17aed2f6752f51382a4eafc-
imei18342732131333-
imei1_md58342732742123-
imei28342732123412-
imei2_md58342732312314-
oaid3DEA635F-B24F-434B-833F-4ED028FEAEEF-
oaid_md58e488a40a17aed2f6752f51382a4eafc-
mac23456787898767898-
mac_md52345678789876741-
android_id1a34fc556a43c453-
android_id_md58e488a40a17aed2f6752f51382a4eafc-
ipv41.1.1.1-
ipv62409%3A8a55%3A4cc0%3A4050%3A2507%3A4922%3Abbe0%3A524b-
uaMozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/95.0.4638.54 Safari/537.36-
manufacturerHUAWEI设备品牌
modelMate 40设备机型
os1设备平台,如Android
os_version14.1设备系统版本
Rejected_install0:no
1:yes
如果为reject数据,则固定为1
Rejected_reason反作弊拦截原因


最近修改: 2025-05-14Powered by