附件一 :监测参数表
以下是快手所支持的参数值以及相应的说明。需要注意的是,对于没有对应值或者快手未能获取到值的占位符,不进行替换,或者替换为空字符串(非空格),并且占位符前后均为双下划线。
占位符 |
系统 |
说明 |
例子 |
__ACCOUNTID__ |
iOS/Android |
原值,快手广告账户 ID |
12345 |
__AID__ |
iOS/Android |
原值,快手广告组 ID |
2656338 |
__CID__ |
iOS/Android |
原值,快手广告创意 ID |
223372032123415808 由于创意 ID 已超出 int32 的最大值,所以广告主务必按照 int64 进行存储,否则会导致存储失败,无法正常归因 |
__DID__ |
iOS/Android |
原值,快手广告计划 ID |
223372036854775808 |
__DNAME__ |
iOS/Android |
原值,快手广告计划名称 |
游戏-男-18 岁 |
__PHOTOID__ |
iOS/Android |
原值,素材 ID |
2656338 |
__IMEI2__ |
Android |
对 15 位数字的 IMEI(例如 860576038225452)进行 MD5(备注:安卓广告唯一标识,imei 双卡手机可能有两个,取默认的一个) |
9a950230e16e0e5adace1cbded88478br |
__IMEI3__ |
Android |
Android 下的 IMEI,原文计算 SHA1 |
BF776E787C360D5B031BF1C877BCDF42BEFF456D(格式示例) |
__IMEI4__ |
Android |
IMEI 进行 MD5,适配三方监测方案,imei2 和 imei4 选取一个即可,都会替换 |
9a950230e16e0e5adace1cbded88478b |
__OAID2__ |
Android |
Android 设备标识计算 MD5(强烈建议使用) |
|
__IDFA2__ |
iOS |
iOS 下的 idfa 计算 MD5,规则为 32 位十六进制数字+4 位连接符“-”的原文(比如:32ED3EE5-9968-4F25-A015-DE3CFF569568),再计算 MD5,然后转为大写 |
737C5E53A3CDD1904CCOE71B31E5244D |
__IDFA3__ |
iOS |
iOS 下的 idfa 计算 SHA1,规则是原文带“-”,计算 SHA1 |
9E0A1817011FBAFOD8E52BCB078DCA8D5DA4AE99(格式示例) |
_KENYID_CAA_ |
iOS |
URL Encode 后的 JSON 数组;其中 kenyld 为中广协 ID(即 CAID),kenyld_MD5 为 CAID 原值 MD5 加密后的结果(32 位小写),version 为信通院算法包版本号,支持两个版本同时下发(即最新版和上一版) 举例:如果版本未更新则只会下发一个 kenyld+kenyld_MD5+version 组合 如果版本有更新,我们也只会下发最近的两个版本的 kenyld+kenyld_MD5+version 组合 |
URLEncode(“[“fT”kenyld”:”12345″,”kenyld_MD51″:”827ccb0eea8a706c4c34a16891f84e7b”,”version”:20200801},{“kenyld”:”16789O”,”kenyld_MD5″:”1e01ba3e07ac48cbdab2d3284d1dd0fav”,”version”:20200901}]) |
__MAC2__ |
Android |
对 MAC 进行 MD5 |
a96bf42b5fbe32456071b4af0291d7bd |
__MAC3__ |
Android |
对 MAC 去除分隔符之后进行 MD5 |
df141bb66712b729acab5feb2ce59e16 |
__ANDROIDID2__ |
Android |
对 ANDROIDID (举例:8t6581815307be28)进行 MD5 |
c3b54dbc33e7eb69e0c3758158a79daf |
__ANDROIDID3__ |
Android |
Android 下的 AndroidlD,原文计算 SHA1 |
E7456CB4325E42A16FE75B9DDDC29BE91EFD6E32(格式示例) |
__OS__ |
Android|IOS |
操作系统 |
0:Android,1:ios,3:其他 |
__TS__ |
Android|IOS |
UTC 时间戳,自 1970 年起的毫秒数,取当前设备返回的系统时间,可能与实际时间存在误差 |
154597327200o |
__IP__ |
Android|IOS |
用户 IP 地址(IPV4) |
123.89.234.34 |
__IPV6__ |
Android|IOS |
用户 IP 地址(IPV6) |
|
__UA__ |
Android|IOS |
用户代理(User Agent) |
上报时 Encode 一次,示例如下:Dalvik/2.1.0+(Linux; U; Android 10; HMA-ALOO Build/HUAWEIHMA-ALO0) Mozilla/5.0 (iPhone; CPU iPhone OS 12_4 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Mobile/15E148 |
__CSITE__ |
Android|IOS |
广告投放场景 |
1 – 优选广告,2 – 快手信息流广告 (日投放场景,含上下滑大屏广告),3 – 视频播放页广告,5 – 快手联盟广告,6 – 上下滑大屏广告,7 – 快手信息流广告(不含上下滑大屏广告)27 – 开屏位置 39 – 快手搜索广告 24 – 激励视频 |
__CALLBACK__ |
Android|IOS |
回调信息,编码一次的 URL,长度小于 10k |
http%3a%2f%2fad.partner.gifshow.com%2ftrack%2factivate%3fcallback%3dDHAJASALKFyk1uCKBYCyXp-iIDS-uHDd_a5SJ9Dbwkqv46dahahd87TW7hhkJKd |
__MODEL__ |
iOS |
设备型号 |
iPhone10 |
__AC_CREATIVE__ |
Android|IOS |
是否为高级创意 |
1:是 |
__WINFOID__ |
Android|IOS |
仅支持搜索流量,winfoid 可通过 marketing api 中关键词接口获得,对应 word_info_id,如果为非搜索流量或智能扩词流量,则 winfoid 不替换 |
16015060 |
附件二︰回传参数说明
请求方:由广告主提供的监测平台服务器。处理方:快手广告服务器
请求协议:HTTP、HTTPS。请求方式:GET
请求地址:http:/lad.partner.gifshow.com/track/activate
回传参数列表:
参数名 |
类型 |
是否 必填 |
参数含义 |
描述 |
callback |
string |
必填 |
广告 ID |
接口一接收的__CALLBACK__替换后的 http 地址中的 callback 参数 (参考下方示例中标红处) |
event_type |
int |
必填 |
转化事件类型 |
枚举值见下方附录,建议对接前与快手运营同学沟通确认 |
event_time |
long |
必填 |
事件转化时间 |
单位:毫秒,13 位级时间戳 |
purchase_amount |
double |
选填 |
付费金额 |
付费、授信、商品浏览、添加购物车、提交订单等转化事件必填,单位元,保留两位小数 |
user_tags_age |
int |
选填 |
用户年龄 |
仅限保险行业使用 |
user_tags_insurance |
int |
选填 |
社保情况 |
仅限保险行业使用,取值:0 – 无社保、1 – ext_pred_ltv 社保、2 – 其他 |
weighted_purchase_amount |
double |
选填 |
加权付费金额 |
仅限保险行业使用 |
action_reason |
int |
选填 |
行为原因 |
当 event_type 为{120,121}时必填,枚举值见下方表格 |
key_action_category |
string |
选填 |
关键行为类型 |
当 event_type = 143 时必填,枚举值见下方表格 |
key_action_threshold |
double |
选填 |
关键行为定义对应的次数/数量/等级/金额等信息 |
当 event_type = 143 时必填,枚举值见下方表格 |
ext_pred_ltv |
double |
选填 |
预估 LTV |
|
ext_pred_pay_ratio |
double |
选填 |
预估付费率</ © 版权声明 1 本站内容观点不代表本站立场,并不代表本站赞同其观点和对其真实性负责; 2 本站部分内容来源于网络,仅供学习与参考,如有侵权,请联系网站管理员删除 3 本站一律禁止以任何方式发布或转载任何违法的相关信息,访客发现请向站长举报 4 精准获客感谢您的访问!希望本站内容对您有所帮助! THE END
喜欢就支持一下吧 相关推荐
|
暂无评论内容