快手信息流广告：H5落地页类广告转化数据API对接文档

一、快手广告账户方案背景

广告主在快手广告平台投放H5落地页形式的广告时，通过JS代码回传后端转化数据易存在误差且难以优化，同时部分广告主希望能够回传更丰富的落地页转化信息便于广告平台进行优化。针对以上场景，广告主可采用落地页API对接方案，支持回传多种转化数据类型，帮助算法模型找到相关性更高的目标人群，同时也最大程度优化数据差异。

 

二、快手广告平台方案流程

1.     在快手平台投放H5落地页形式的广告，用户每次到达广告投放落地页时，系统会在落地页URL上自动拼接广告ID参数（参数名默认为callback，参数值字节数小于1k，建议相关数据库字段适当放宽字符串长度限制）；

2.     广告主技术团队通过在落地页面部署相关代码，抓取落地页URL上的广告ID，并通过一定方式将广告ID和当前到达落地页的用户关联起来；

3.     相关转化事件发生时，广告主技术团队将转化数据回传至快手广告平台。

转化数据上报接口

请求方：广告主服务器/客户端

处理方：快手广告服务器

请求协议：HTTP

请求方式：GET

请求接口：http://ad.partner.gifshow.com/track/activate

参数详情：

返回信息：JSON

返回值为{"result":1,……}，即表示上报成功，其他参数无需关注。

三、联调测试

目前仅支持线上联调。即需开启广告投放（可通过人群包等方式缩小投放范围），使用账户中创意层级的“体验”功能进行测试联调。

完成全部转化流程测试后，建议广告主技术同学先内部检查是否已上报转化请求，如确认已上报，可在后台报表中查看对应事件的转化数据。

“体验”功能操作流程可咨询快手运营同学。

四、案例分享

广告主在快手广告平台配置投放的落地页为：https://www.test.com?utm_source=kuaishou&utm_campaign=June，希望通过转化数据对接，回传落地页上产生的表单行为、付费行为。

用户实际点击广告时，系统会默认在落地页URL后拼接广告ID，如果使用宏替换，仅支持__AID__/__CID__/__DID__/__Dname__宏参数替换（广告ID仅作为样例）：

https://www.test.com?utm_source=kuaishou&utm_campaign=June&callback=DHAJASALKFyk1uCKBYCyXp-iIDS-uHDd_a5SJ9Dbwkqv46dahahd87TW7hhkJkd

广告主技术通过落地页面代码从URL上获取广告ID，用户提交表单时，将表单的手机号与广告ID关联并存储，同时上报表单事件，上报请求链接样例：http://ad.partner.gifshow.com/track/activate?event_type=9&event_time=1536045380000&callback=DHAJASALKFyk1uCKBYCyXp-iIDS-uHDd_a5SJ9Dbwkqv46dahahd87TW7hhkJkd；

该用户后续产生了付费行为，通过手机号找到该用户对应的广告ID，将付费事件上报给快手，上报请求链接样例：http://ad.partner.gifshow.com/track/activate?event_type=3&purchase_amount=66.66&event_time=1537045380000&callback=DHAJASALKFyk1uCKBYCyXp-iIDS-uHDd_a5SJ9Dbwkqv46dahahd87TW7hhkJkd。

五、多触点回传

如果广告主有能力并愿意将非快手渠道带来的转化数据，通过一定方式匹配到广告ID并上报给快手，帮助算法模型更深度地学习理解目标人群的用户特征，有助于提高投放的精准性，提升投放效果。可联系快手运营同学提供多触点对接方案，进行更深度的数据对接。

六、常见问题

Q：为什么上报时报错，返回信息提示“{"result":0,"error_msg":"callbackinfo decoded failure","host-name",……}”？

        A：请求中的callback参数的参数值有误，必须使用通过广告上报的完整callback值，文档中的样例值、自行编写的测试值以及不完整的callback值，都会导致上报报错。

七、附录

转化事件类型参数（event_type）枚举值

---

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