附件一 :监测参数表
以下为快手支持的参数值及对应说明。其中,无对应值或快手未获取到值的占位符,不做替换或替换为空字符串(非空格),注意:占位符前后都为双下划线。
占位符 | 系统 | 说明 | 例子 |
__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":v"827ccb0eea8a706c4c34a16891f84e7b","version":20200801},f"kenyld\":1"6789O", "kenyld_MD5\":Y"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%2F2.1.0+(Linux%3B+U%3B+Android+10%3B+HMA-ALOO+Build%2FHUAWEIHMA-ALO0) Mozilla%2F5.0%20%28iPhone%3B%20CPU%20iPhone%20OS%2012_4%20like%20Mac%20OS%20X%29%20AppleWebKit%2F605.1.15%20%28KHTML%2C%20like%20Gecko%29%20Mobile%2F15E148 |
__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 | 选填 | 预估付费率 | |
pay_level | string | 选填 | 付费等级 | S小RM中R L大R event_type=151回传 |
novel_chapter_num | int | 选填 | 小说章节 | 1-1000,event_type=150回传 |
convsersion_score | double | 选填 | 转化质量分 | 分数可选择【0,1】之间的数。要求质量分和用户价值有线性关系, 比如0.4质量分用户的价值是0.2质量分用户价值的两倍 |
event_props | json string | 选填 | 自定义事件属性 | 用户自定义事件回传 |
事件类型event_type参数值:
event type参数值 | 含义 | 行业 | 备注 |
1 | 激活 | 不限 | |
2 | 注册 | 不限 | 仅需传第一次注册 |
3 | 付费 | 不限 | 多次产生付费行为可多次回传,请求的callback地址相同, 需要同时回传purchase_amount参数 weighted_purchase_amount参数(仅限保险行业使用) |
5 | 活跃 | 不限 | 活跃:用户每次成功打开访问app,回传「活跃」 时需要携带该设备发生「激活」时对应的callback |
6 | |||
10 | 完件 | 金融 | |
11 | 授信 | 金融 | |
12 | 商品浏览 | 电商 | 需要同时回传purchase amount参数 |
13 | 添加购物车 | 电商 | 需要同时回传purchase amount参数 |
14 | 提交订单 | 电商 | 需要同时回传purchase amount参数 |
15 | 订单支付 | 电商 | 需要同时回传purchase amount参数 |
30 | 上报游戏时长 | 游戏 | |
31 | 创建游戏角色 | 游戏 | |
32 | 升级游戏角色 | 游戏 | |
39 | 人脸识别完成 | 金融 | |
40 | 身份信息填写完成 | 金融 | |
41 | 银行卡信息填写完成 | 金融 |
附件三︰返回信息
Android
快应用回传
1、快手用户浏览或点击快手客户端展示的快手广告。
2、客户通过魔力建站嵌入快应用,快应用的callback统一由魔力建站填充,客户需在魔力建站填写callback。、
3、广告主或者第三方监测平台接收到快手接口一上报的广告请求后,记录请求参数中的用户信息(例如用户的
IDFA-MD5、IMEI-MD5等)和callback信息(将callback作为唯一匹配值),后续从产生相关转化的用户中,匹配出由快手推广渠道带来的用户及其转化数据。
4、广告主或者第三方监测平台将匹配出的转化数据,通过请求相应的calback通知快手效果统计服务器(具体见接口二)。
5、快手效果统计服务器将接收到的转化信息和广告投放数据匹配,在投放平台报表中披露出对应广告计划-广告组-广告创意的转化数据。
多触点归因数据回传
为提升投放效果,快手希望广告主可以将归因至其它渠道的转化数据也回传至快手,帮助优化深度转化模型训练,上报此类转化数据时,需要增加参数&is_direct_match=false”,表示'该用户看过快手广告,但转化归因到了其它平台”,此类数据不会计入投放报表展现。
- 2024-10-12
看懂品牌广告大促玩法,让快手广告投放更破… - 2024-10-11
快手广告推广平台和微信广告推广平台的区别… - 2024-10-10
磁力金牛双11玩法指南来袭,快手广告推广助… - 2024-10-10
快手广告平台的优势适合哪些行业精准投放 - 2024-10-10
国庆期间—快手电商举办线上“美发节”,游… - 2024-10-09
解锁双11大促种草“星”路径,快手广告激发… - 2024-10-09
快手磁力引擎出席GDMS全球数字营销峰会,快… - 2024-10-07
快手广告进行应用推广已经走向成熟,快手应… - 2024-10-07
快手广告企微链路跑量神器!「添加企业微信… - 2024-10-07
快手广告商业私信x交通行业,有效获客show…
管理员
该内容暂无评论