应用下载类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":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 

参数名

类型

是否

必填

参数含义

描述

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参数值

含义

行业

备注

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

银行卡信息填写完成

金融