图片-精准获客

应用下载类 API 归因上报(下篇) | 快手推广代运营

附件一 :监测参数表

以下是快手所支持的参数值以及相应的说明。需要注意的是,对于没有对应值或者快手未能获取到值的占位符,不进行替换,或者替换为空字符串(非空格),并且占位符前后均为双下划线。

图片[1]-应用下载类 API 归因上报(下篇) | 快手推广代运营-精准获客

占位符

系统

说明

例子

__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

选填

预估付费率</

© 版权声明
THE END
喜欢就支持一下吧
点赞7 分享
评论 抢沙发

请登录后发表评论

    暂无评论内容