1022 - 快手短视频广告主接入实践笔记

Posted 2021-12-18 stark张宇

概述

对于不熟悉快手短视频推广，广告主接入的有很多坑，给我的整体感觉就是技术实现简单，但是方式上有很多坑，希望分享出来给大家解惑，也留给自己作为技术实践中的经验总结。

第一步是企业去快手投放管理后台开户，这个当时是公司运营的同事在搞，我们技术的同学没有参与，下面我开始说开发和接入的重点：

接入形式

接入形式主要有两种(推广下载App/收集表单数据)，在技术接入的时候一定要确认清楚，我们在接入的时候就遇到了这方面的问题，运营的同学开户时的业务申请的是下载App-注册-激活，我们做成了H5落地页的形式，没有加强沟通，结果南辕北辙了，这都是血的教训。

尽量要摸清楚流程和对接方式，因为快手方面的同学需要审核，审核一次的时间3-4个小时。

推广下载App

流程是：点击短视频 -> 跳转到App下载链接 -> 注册 ->激活。

需要提供给快手的同学应用下载链接、隐私链接、数据监测链接。

这里主要说的是数据监测链接部分，数据监测链接的作用是当投放在快手短视频的推广广告受到点击时，快手服务器请求给广告主提供的Url接口中。

请求方：快手App客户端
处理方：广告主提供的监测平台服务器
请求协议：HTTPS协议（仅支持HTTPS，不支持HTTP）
请求方式：GET
请求地址：广告主在快手广告平台设置的监测URL

检测链接是广告主接收参数的Key自定义的，参数是快手文档中规定好的，android和ios是分别处理的，建议分别提供检测链接地址。

Ios 格式样例：

https://www.example.com?xxx=XXXX&idfaMD5=__IDFA2__&callback=__CALLBACK__&campaignid=__DID__

Android格式样例：

https://www.example.com?xxx=XXXX&imeiMD5=__IMEI2__&callback=__CALLBACK__&campaignid=__DID__

说明：

由于目前不支持动态上报操作系统信息，建议iOS和Android各自使用一套独立监测链接。

• www.example.com是广告主接收点击上报数据的地址，需要广告主自行修改替换；
• xxx=XXXX是广告主自定义参数信息，可由广告主自行设定，快手在上报时，原样返回，不做任何修改；
• idfaMD5/imeiMD5/callback这几个参数名称仅作为参考，最终使用的参数名称可由广告主自行设定；
• IDFA2/__IMEI2__在上报的时候，会替换为相应的md5加密设备号，其他参数也可以获取，例如在链接地址中添加&mac2=MAC2，可以获取md5加密的mac信息，具体可支持的参数列表可查看下方参数说明；
• __CALLBACK__为必填参数，快手客户端在上报的时候会替换成http形式的地址（已编码一次），广告主在接收到上报数据后，需要保存该地址，当用户在应用内完成相应转化事件时，请求该地址来上报转化数据。

H5落地页形式

流程是：点击短视频 -> 跳转到H5落地页 -> 广告主自定义操作 -> 回传给快手服务器。
需要提供给快手的同学H5落地页的链接，要求是https协议，和开户时候的域名一致，不然会有审核不过的风险。

回传给快手服务器

两种形式的快手短视频接入，都需要把最终的回传数据返回给快手服务器作为数据投放的统计。

回传给快手的代码比较简单，按照投放的类型和方式进行回传就好，代码如下：

private function callback($event_type, $callback)


    $quickCallBack = 'http://ad.partner.gifshow.com/track/activate';
    $params = [
        'event_type' => $event_type,
        'callback' => $callback,
        'event_time' => intval(microtime(true) * 1000)
    ];

    Curl::geturl($quickCallBack . '?' . http_build_query($params), '', 2);

如果有不清楚的地方可以私信我，看到回复给您，希望我的分享对你有一点点帮助。

参考文档：

• App下载接入参考文档：https://docs.qingque.cn/d/home/eZQBTWKAahwgCU4YeU_bRW5B_#
• H5落地页开发参考文档：https://yiqixie.qingque.cn/d/home/fcACjQFu3lSI1QT7ktc7TCH9e