媒体渠道的广告投放转化资料回传API 对接需求怎么写？_快手

本文将以某款金融产品对接快手广告平台为例，介绍广告主商业产品经理的入门级需求策划任务——对接广告平台的标准界面，把转化资料准确上报。

一款有强变现能力的产品（比如金融、游戏、电商），免不了在各种媒体渠道投放广告（比如快手、头条、抖音）。而从使用者点选广告到下载、注册、登入、付费等一系列关键行为转化的资料统计，一方面关系到广告结费，另一方面也可以分析广告投放效果、及时调整策略缩减成本提升转化率。

但是，媒体方只有使用者点选广告的资料，投放广告的广告主也只有自身产品相关的转化资料，要做到整体漏斗的统计分析，就需要整合双方资料，许多广告平台应运而生（比如凤巢、广点通、多彩互动）。广告主商业产品经理的入门级需求策划任务，就是要对接广告平台的标准界面，把转化资料准确上报。

需要注意的是，媒体方和广告主不会共用一套账户体系，如何把一个使用者在两端产生的资料匹配到一起就大有文章：

（以某款金融产品对接快手广告平台为例）

一、业务概述 1.1 背景

****、***在快手资讯流投放缺少转化资料统计分析，转化量及成本有优化空间。

如下表所示，从历史资料来看对接转化资料回传API，收益明显。

另外，需求实施的前置条件是达标的装置号获取率，经调研已满足要求：

如下表所示，通过本次对接转化资料回传API，实现****、***在快手资讯流投放的量级增长、成本降低。

1.3 业务主流程示意图

1.4.1 广告主

本次对接快手API，****、***两款产品流程、需求一致，统称为在快手媒体渠道投放资讯流广告的“广告主”。

1.4.2 新增注册

使用者手机号本次注册是首次注册，对于同一个手机号****和***是独立分开的，即同一个手机号可以在****和***各新增注册一次。

1.4.3 广告点选

当快手使用者点选广告可互动区域时，触发点选事件，该事件被认为是一次有效的广告点选。进入指定落地页后点选内部相关连结等行为，不算作点选。

1.4.4 转化数

快手后台报表中展现的转化资料，时间上以快手服务器收到回拨请求的时间为准，量级上以客户实际上报请求数为准。

二、API对接流程 2.1 流程图

作为广告主，****、***对接快手API的流程分为记录点选使用者的装置号相关资讯、新增注册使用者判断、获取注册使用者的装置号相关资讯、装置号匹配、传送注册使用者的装置号相关资讯5个环节。

需要注意的是，记录点选使用者的装置号相关资讯对其它4个环节来说是异步的、前置的。

2.2 流程说明

2.2.1 记录点选使用者的装置号相关资讯

1. 快手客户端请求点选监测URL（广告主预先在快手广告平台设定），把使用者点选资料详细资讯实时通过界面一同步给广告主服务端；

2. 广告主服务端接收到快手界面一上报的点选请求后，记录请求引数中的使用者资讯，其中包括使用者的IDFA-MD5或IMEI-MD5、使用者点选广告的AID、CID、DID和DNAME、使用者点选广告的时间TS和callback资讯；（引数说明如下表）

需要额外说明的是，使用者每一次点选行为都会上报，都需要完整记录引数资讯；

其中：

4. 响应要求：响应方式为JSON资料格式，HTTP标准状态码，响应内容不做要求。

2.2.2 新增注册使用者判断

2.2.3 获取注册使用者的装置号相关资讯

经过广告主服务端判断，通过快手资讯流渠道下载APP且为新增注册的使用者通过筛选。

针对这一部分使用者，获取他们的MD5加密后的装置ID、使用者注册时间两个字段资讯，若获取失败则流程结束，若获取成功则流程进入下一环节2.2.4。

其中：

2.2.4 装置号匹配

将获取到的注册使用者MD5加密装置号与2.2.1.记录的点选使用者的MD5加密装置号进行匹配，具体匹配规则为：注册使用者的MD5加密装置号存在于点选使用者的MD5加密装置号名单中，且最近一次的点选行为发生在注册前7天之内（天数可配置）视为匹配成功，否则为不成功。

若匹配不成功则流程结束，若匹配成功则进入下一环节2.2.5。

2.2.5 传送注册使用者的装置号相关资讯

1. 传送地址：广告主通过界面一接收的注册前7天内最近一次点选行为的__CALLBACK__替换后的http地址（需要拼接相应引数）；

2. 需要拼接的引数：

3. 回拨的请求URL（界面一中__CALLBACK__的对应值，连结地址Decode后再拼接相关引数）点选检视示例（“callback=”后字段的字元每次都会不同）

4. 响应内容：回拨后response里的result=1代表回拨请求上报成功。

2.3 时序说明

三、其他说明 3.1 异常处理

若界面二响应异常，广告主最多上报3次同一条应用内转化资料；如果传送仍失败，则放弃本次传送，并记录异常日志。

3.2 异常报警

广告主上报应用内转化资料到快手广告平台，采用即时策略，如果连续3次同一条应用内转化资料传送失败，就简讯或邮件报警提醒到相应人员，每天最多传送一次报警，具体传送名单如下：

姓名***，手机号**********，邮箱**********

需要记录注册转化使用者装置号相关资讯的传送、响应资料，具体需求字段如下：

Ø channel：渠道

Ø aid：广告组id

Ø cid：广告创意ID

Ø did：广告计划Id

Ø dname：广告计划名称

Ø dt：广告点选事件发生的UTC时间戳

Ø idfaMD5：iOS下的idfa计算MD5

Ø imeiMD5：对15位数字的IMEI进行MD5

Ø event_type：转化事件型别

Ø event_time：转化事件时间

Ø sendNumber：第几次传送（1~3）

Ø sendTime：传送时间

Ø returnCode：返回码

Ø returnTime：返回时间

3.4 资讯资料

3.4.1 快手广告平台转化资料API档案v1.4

3.4.2 快手&**渠道号

本文由 @三点半 原创释出于人人都是产品经理。未经许可，禁止转载

题图来自 Unsplash ，基于 CC0 协议