快手广告管理平台：​应用下载类广告转化数据API接口文档《NO.2》

接口二

接口二用于广告主将应用内转化数据上报给快手广告服务器，快手会将收到的转化数据与广告计划-广告组-广告创意关联，跟踪每个广告创意的转化效果。

1. 简介

请求方：广告主提供的监测平台服务器

处理方：快手广告服务器

请求协议：HTTP HTTPS

请求方式：GET

请求地址：监测方通过接口一接收的__CALLBACK__替换后的http地址（需要拼接相应参数）

参数:

1.callback，接口一接收的__CALLBACK__替换后的http地址中的callback参数（参考下方示例中标红处）。

2.event_type，事件类型，转化事件和参数值的对应关系见下表，建议对接前与快手运营同学沟通确认。

3.event_time，事件时间，13位毫秒级时间戳。若请求中携带event_type参数，则必须同时携带event_time参数。

4.purchase_amount，金额。当event_type为{3,12,13,14,15}，必须同时回传消费金额参数purchase_amount，单位元，可保留两位小数。

5.user_tags_age，用户年龄，可选参数，整数，仅限保险行业使用。

6.user_tags_insurance，社保情况，可选参数，整数，仅限保险行业使用，取值：0-无社保、1-ext_pred_ltv社保、2-其他。

7.weighted_purchase_amount，加权付费金额，可选参数，双精度浮点型，仅限保险行业使用。

8.action_reason，行为原因，可选参数，整数，当event_type为{120,121}时强烈建议回传，枚举值见下方表格。

9.key_action_category：关键行为类型，可选参数，整数，当 event_type=143 时强烈建议回传，枚举值见下方表格。

10key_action_threshold：关键行为定义对应的次数/数量/等级/金额等信息，可选参数，数字，当 event_type=143 时强烈建议回传，枚举值见下方表格

11.ext_pred_pay_ratio：预估LTV，可选参数，double。

12.ext_pred_ltv：预估LTV，可选参数，double。

13.pay_level：付费等级，可选参数，具体:S/M/L,event_type=151可回传

14.novel_chapter_num：小说章节，可选参数，1-1000。event_type=150可回传

2. 回调请求

回调的请求URL（接口一中__CALLBACK__的对应值，UrlDecode后再拼接相关参数）示例如下：

1）激活

http://ad.partner.gifshow.com/track/activate?event_type=1&event_time=1536045380000&callback=DHAJASALKFyk1uCKBYCyXp-iIDS-uHDd_a5SJ9Dbwkqv46dahahd87TW7hhkJkd  （标红区域字段的字符，仅作为样例，不可用于联调）。

2）注册

http://ad.partner.gifshow.com/track/activate?event_type=2&event_time=1536045380000&callback=DHAJASALKFyk1uCKBYCyXp-iIDS-uHDd_a5SJ9Dbwkqv46dahahd87TW7hhkJkd  （标红区域字段的字符，仅作为样例，不可用于联调）。

3）付费

http://ad.partner.gifshow.com/track/activate?event_type=3&event_time=1536045380000&purchase_amount=10.88&callback=DHAJASALKFyk1uCKBYCyXp-iIDS-uHDd_a5SJ9Dbwkqv46dahahd87TW7hhkJkd  （标红区域字段的字符，仅作为样例，不可用于联调）。

3. 响应内容

回调后response为JSON格式，result=1代表回调请求上报成功，其他参数及参数值无需关注。

4. 多触点归因数据回传

为提升投放效果，快手希望广告主可以将归因至其它渠道的转化数据也回传至快手，帮助优化深度转化模型训练，上报此类转化数据时，需要增加参数“&is_direct_match=false”，表示“该用户看过快手广告，但转化归因到了其它平台”，此类数据不会计入投放报表展现。上报样例：

http://ad.partner.gifshow.com/track/activate?event_type=1&event_time=1536045380000&callback=DHAJASALKFyk1uCKBYCyXp-iIDS-uHDd_a5SJ9Dbwkqv46dahahd87TW7hhkJkd&is_direct_match=false  （标红区域字段的字符，仅作为样例，不可用于联调）

五、联调

广告主可在投放后台“工具-转化追踪-追踪应用”中，新建转化目标，填写相关内容后，按页面说明进行联调。

联调不计入报表，只有体验广告才计入报表。

六、Q&A

强烈建议广告主通过监测链接收集并记录账户/计划/组/创意这四个层级的ID，这样可以清楚的知道转化callback最终上报后，会披露在哪个账户/计划/组/创意下面；我们的广告id已经超过int32位了，请客户按照int64来存储，已经出现有客户因广告id过长导致存储失败，而无法归因的情况。

对接中如果遇到问题，广告主通常可关注以下几点来进行问题排查：1. 是否正确收到监测请求上报，2. 转化归因匹配是否正常，3. 是否成功回调转化callback。

若遇到其他问题，可查看Q&A文档。文档中包含了对接期间注意事项、常见问题的排查方向、以及产生数据差异时，双方的协作流程。

点击这里。

---

文章均来自互联网如有不妥请联系作者删除QQ:314111741 地址：http://www.mqs.net/post/2889.html