APP推广合作
联系“鸟哥笔记小乔”
信息流广告api(媒体渠道的“广告投放转化”数据回传API,对接需求怎么写?)
2024-02-21 10:14:39

媒体渠道的“广告投放转化”数据回传API,对接需求怎么写?

信息流广告api(媒体渠道的“广告投放转化”数据回传API,对接需求怎么写?)

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

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

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

  1. 首先,手机号是最为准确的匹配字段,如果媒体方和广告主的账号绑定的是同一个手机号,就可以认定这是同一个用户,数据可统一归集。
  2. 然而,不是所有的媒体渠道都需要用户注册登录,一些游客也会点击广告带来转化。这时,安卓的IMEI设备号、苹果的IDFA设备号就有了用武之地,即时你没有注册账号,但你手机的设备号总不会变,如果媒体方和广告主采集的行为数据对应的设备号是一致的,那也可匹配上两端的数据。
  3. 可是这样也不能100%解决问题,有些用户并不会授权给客户端获取它的设备号,那就压根拿不到他的IMEI和IDFA。不过,我们还有手机的MAC网卡地址、Android下的AndroidID、IP地址等可以用来匹配用户身份的字段。总体来说,IMEI和IDFA的采集率最高,其它匹配方式可作为备选或补充。(其实,IMEI和IDFA之外的字段媒体方也不一定会采集、广告平台接口也不一定会提供)

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

****、***在快手信息流投放缺少转化数据统计分析,转化量及成本有优化空间。

如下表所示,从历史数据来看对接转化数据回传API,收益明显。

另外,需求实施的前置条件是达标的设备号获取率,经调研已满足要求:

  1. 快手的IMEI和IDFA获取率95%左右;
  2. APP客户端优化于5月7日上线:V*.*.*版本(****)的IMEI获取率为91.53%,V*.*.*版本(***)的IMEI获取率为91.21%,达到预期要求;
  3. ****和***的IDFA抓取率在98%以上。

如下表所示,通过本次对接转化数据回传API,实现****、***在快手信息流投放的量级增长、成本降低。

  1. 快手用户点击快手客户端展示的广告。
  2. 快手客户端请求广告平台中设置的监测链接(广告主自行开发或者托管第三方监测平台),通过宏替换的方式把点击数据详细信息实时同步给广告主或者第三方监测平台(具体见接口一)。
  3. 广告主或者第三方监测平台接收到快手接口一上报的点击请求后,记录请求参数中的用户信息(例如用户的IDFA-MD5、IMEI-MD5等)和callback信息,后续从产生相关转化的用户中,匹配出由快手推广渠道带来的用户及其转化数据。
  4. 广告主或者第三方监测平台将匹配出的转化数据,通过请求相应的callback通知快手效果统计服务器(具体见接口二)。
  5. 快手效果统计服务器将接收到的转化信息和广告点击数据匹配,在投放平台报表中披露出对应广告计划-广告组-广告创意的转化数据。

1.4.1 广告主

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

1.4.2 新增注册

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

1.4.3 广告点击

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

1.4.4 转化数

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

作为广告主,****、***对接快手API的流程分为记录点击用户的设备号相关信息新增注册用户判断获取注册用户的设备号相关信息设备号匹配发送注册用户的设备号相关信息5个环节。

需要注意的是,记录点击用户的设备号相关信息对其它4个环节来说是异步的、前置的。

2.2.1 记录点击用户的设备号相关信息

1. 快手客户端请求点击监测URL(广告主预先在快手广告平台设置),把用户点击数据详细信息实时通过接口一同步给广告主服务端;

2. 广告主服务端接收到快手接口一上报的点击请求后,记录请求参数中的用户信息,其中包括用户的IDFA-MD5或IMEI-MD5、用户点击广告的AID、CID、DID和DNAME、用户点击广告的时间TS和callback信息;(参数说明如下表)

需要额外说明的是,用户每一次点击行为都会上报,都需要完整记录参数信息;

3.

其中:

  • www.example.com是广告主接收点击上报数据的地址,需服务端给出
  • channel=kuaishou是广告主自定义用来区分渠道的参数信息,快手上报时原样返回,不做任何修改
  • channel/aid/cid/did/dname/ts/idfaMD5/imeiMD5/callback这几个参数名称仅作为参考,最终使用的参数名称可由服务端自行设定
  • __CALLBACK__为必填参数,快手客户端在上报的时候会替换成http形式的地址(已编码一次),广告主在接收到上报数据后,需要保存该地址,当用户在应用内完成注册时,请求该地址来上报转化数据(需要拼接相应参数)。

4. 响应要求:响应方式为JSON数据格式,HTTP标准状态码,响应内容不做要求。

2.2.2 新增注册用户判断

  1. 用户首次登录APP,广告主服务端判断用户是否为新增注册的用户,若用户不是新增注册则流程结束;
  2. 若用户本次是新增注册,则广告主服务端获取该用户安装来源的注册渠道号,若获取的注册渠道号不是快手渠道号(****、***的快手渠道号详见附件《快手&**渠道号》),则流程结束;
  3. 若获取的注册渠道号是快手渠道号,则流程进入下一环节2.2.3.。

2.2.3 获取注册用户的设备号相关信息

经过广告主服务端判断,通过快手信息流渠道下载APP且为新增注册的用户通过筛选。

针对这一部分用户,获取他们的MD5加密后的设备ID、用户注册时间两个字段信息,若获取失败则流程结束,若获取成功则流程进入下一环节2.2.4。

其中:

  • 安卓imei双卡手机可能有两个,取默认的一个
  • iOS下的idfa计算MD5,规则为32位十六进制数字+4位连接符“-”的原文(比如:32ED3EE5-9968-4F25-A015-DE3CFF569568),再计算MD5,再转大写
  • 用户注册时间需为13位毫秒级时间戳

2.2.4 设备号匹配

信息流广告api(媒体渠道的“广告投放转化”数据回传API,对接需求怎么写?)

将获取到的注册用户MD5加密设备号与2.2.1.记录的点击用户的MD5加密设备号进行匹配,具体匹配规则为:注册用户的MD5加密设备号存在于点击用户的MD5加密设备号名单中,且最近一次的点击行为发生在注册前7天之内(天数可配置)视为匹配成功,否则为不成功。

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

2.2.5 发送注册用户的设备号相关信息

1. 发送地址:广告主通过接口一接收的注册前7天内最近一次点击行为的__CALLBACK__替换后的http地址(需要拼接相应参数);

2. 需要拼接的参数:

  • event_type,事件类型,参数值回传2,含义是转化事件为注册
  • event_time,事件时间,13位毫秒级时间戳(若请求中携带event_type参数,则必须同时携带event_time参数,否则报错)
  • callback,接口一接收的__CALLBACK__替换后的http地址中的callback参数(参考下方示例中标红处)

3. 回调的请求URL(接口一中__CALLBACK__的对应值,链接地址Decode后再拼接相关参数)(“callback=”后字段的字符每次都会不同)

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

若接口二响应异常,广告主最多上报3次同一条应用内转化数据;如果发送仍失败,则放弃本次发送,并记录异常日志。

广告主上报应用内转化数据到快手广告平台,采用即时策略,如果连续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.1 快手广告平台转化数据API文档v1.4

3.4.2 快手&**渠道号

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

题图来自 Unsplash ,基于 CC0 协议

信息流广告api(媒体渠道的“广告投放转化”数据回传API,对接需求怎么写?)
运营那些事儿
分享到朋友圈
收藏
收藏
评分

综合评分:

我的评分
Xinstall 15天会员特权
Xinstall是专业的数据分析服务商,帮企业追踪渠道安装来源、裂变拉新统计、广告流量指导等,广泛应用于广告效果统计、APP地推与CPS/CPA归属统计等方面。
20羽毛
立即兑换
一书一课30天会员体验卡
领30天VIP会员,110+门职场大课,250+本精读好书免费学!助你提升职场力!
20羽毛
立即兑换
顺丰同城急送全国通用20元优惠券
顺丰同城急送是顺丰推出的平均1小时送全城的即时快送服务,专业安全,准时送达!
30羽毛
立即兑换
运营那些事儿
运营那些事儿
发表文章43456
确认要消耗 羽毛购买
信息流广告api(媒体渠道的“广告投放转化”数据回传API,对接需求怎么写?)吗?
考虑一下
很遗憾,羽毛不足
我知道了

我们致力于提供一个高质量内容的交流平台。为落实国家互联网信息办公室“依法管网、依法办网、依法上网”的要求,为完善跟帖评论自律管理,为了保护用户创造的内容、维护开放、真实、专业的平台氛围,我们团队将依据本公约中的条款对注册用户和发布在本平台的内容进行管理。平台鼓励用户创作、发布优质内容,同时也将采取必要措施管理违法、侵权或有其他不良影响的网络信息。


一、根据《网络信息内容生态治理规定》《中华人民共和国未成年人保护法》等法律法规,对以下违法、不良信息或存在危害的行为进行处理。
1. 违反法律法规的信息,主要表现为:
    1)反对宪法所确定的基本原则;
    2)危害国家安全,泄露国家秘密,颠覆国家政权,破坏国家统一,损害国家荣誉和利益;
    3)侮辱、滥用英烈形象,歪曲、丑化、亵渎、否定英雄烈士事迹和精神,以侮辱、诽谤或者其他方式侵害英雄烈士的姓名、肖像、名誉、荣誉;
    4)宣扬恐怖主义、极端主义或者煽动实施恐怖活动、极端主义活动;
    5)煽动民族仇恨、民族歧视,破坏民族团结;
    6)破坏国家宗教政策,宣扬邪教和封建迷信;
    7)散布谣言,扰乱社会秩序,破坏社会稳定;
    8)宣扬淫秽、色情、赌博、暴力、凶杀、恐怖或者教唆犯罪;
    9)煽动非法集会、结社、游行、示威、聚众扰乱社会秩序;
    10)侮辱或者诽谤他人,侵害他人名誉、隐私和其他合法权益;
    11)通过网络以文字、图片、音视频等形式,对未成年人实施侮辱、诽谤、威胁或者恶意损害未成年人形象进行网络欺凌的;
    12)危害未成年人身心健康的;
    13)含有法律、行政法规禁止的其他内容;


2. 不友善:不尊重用户及其所贡献内容的信息或行为。主要表现为:
    1)轻蔑:贬低、轻视他人及其劳动成果;
    2)诽谤:捏造、散布虚假事实,损害他人名誉;
    3)嘲讽:以比喻、夸张、侮辱性的手法对他人或其行为进行揭露或描述,以此来激怒他人;
    4)挑衅:以不友好的方式激怒他人,意图使对方对自己的言论作出回应,蓄意制造事端;
    5)羞辱:贬低他人的能力、行为、生理或身份特征,让对方难堪;
    6)谩骂:以不文明的语言对他人进行负面评价;
    7)歧视:煽动人群歧视、地域歧视等,针对他人的民族、种族、宗教、性取向、性别、年龄、地域、生理特征等身份或者归类的攻击;
    8)威胁:许诺以不良的后果来迫使他人服从自己的意志;


3. 发布垃圾广告信息:以推广曝光为目的,发布影响用户体验、扰乱本网站秩序的内容,或进行相关行为。主要表现为:
    1)多次发布包含售卖产品、提供服务、宣传推广内容的垃圾广告。包括但不限于以下几种形式:
    2)单个帐号多次发布包含垃圾广告的内容;
    3)多个广告帐号互相配合发布、传播包含垃圾广告的内容;
    4)多次发布包含欺骗性外链的内容,如未注明的淘宝客链接、跳转网站等,诱骗用户点击链接
    5)发布大量包含推广链接、产品、品牌等内容获取搜索引擎中的不正当曝光;
    6)购买或出售帐号之间虚假地互动,发布干扰网站秩序的推广内容及相关交易。
    7)发布包含欺骗性的恶意营销内容,如通过伪造经历、冒充他人等方式进行恶意营销;
    8)使用特殊符号、图片等方式规避垃圾广告内容审核的广告内容。


4. 色情低俗信息,主要表现为:
    1)包含自己或他人性经验的细节描述或露骨的感受描述;
    2)涉及色情段子、两性笑话的低俗内容;
    3)配图、头图中包含庸俗或挑逗性图片的内容;
    4)带有性暗示、性挑逗等易使人产生性联想;
    5)展现血腥、惊悚、残忍等致人身心不适;
    6)炒作绯闻、丑闻、劣迹等;
    7)宣扬低俗、庸俗、媚俗内容。


5. 不实信息,主要表现为:
    1)可能存在事实性错误或者造谣等内容;
    2)存在事实夸大、伪造虚假经历等误导他人的内容;
    3)伪造身份、冒充他人,通过头像、用户名等个人信息暗示自己具有特定身份,或与特定机构或个人存在关联。


6. 传播封建迷信,主要表现为:
    1)找人算命、测字、占卜、解梦、化解厄运、使用迷信方式治病;
    2)求推荐算命看相大师;
    3)针对具体风水等问题进行求助或咨询;
    4)问自己或他人的八字、六爻、星盘、手相、面相、五行缺失,包括通过占卜方法问婚姻、前程、运势,东西宠物丢了能不能找回、取名改名等;


7. 文章标题党,主要表现为:
    1)以各种夸张、猎奇、不合常理的表现手法等行为来诱导用户;
    2)内容与标题之间存在严重不实或者原意扭曲;
    3)使用夸张标题,内容与标题严重不符的。


8.「饭圈」乱象行为,主要表现为:
    1)诱导未成年人应援集资、高额消费、投票打榜
    2)粉丝互撕谩骂、拉踩引战、造谣攻击、人肉搜索、侵犯隐私
    3)鼓动「饭圈」粉丝攀比炫富、奢靡享乐等行为
    4)以号召粉丝、雇用网络水军、「养号」形式刷量控评等行为
    5)通过「蹭热点」、制造话题等形式干扰舆论,影响传播秩序


9. 其他危害行为或内容,主要表现为:
    1)可能引发未成年人模仿不安全行为和违反社会公德行为、诱导未成年人不良嗜好影响未成年人身心健康的;
    2)不当评述自然灾害、重大事故等灾难的;
    3)美化、粉饰侵略战争行为的;
    4)法律、行政法规禁止,或可能对网络生态造成不良影响的其他内容。


二、违规处罚
本网站通过主动发现和接受用户举报两种方式收集违规行为信息。所有有意的降低内容质量、伤害平台氛围及欺凌未成年人或危害未成年人身心健康的行为都是不能容忍的。
当一个用户发布违规内容时,本网站将依据相关用户违规情节严重程度,对帐号进行禁言 1 天、7 天、15 天直至永久禁言或封停账号的处罚。当涉及欺凌未成年人、危害未成年人身心健康、通过作弊手段注册、使用帐号,或者滥用多个帐号发布违规内容时,本网站将加重处罚。


三、申诉
随着平台管理经验的不断丰富,本网站出于维护本网站氛围和秩序的目的,将不断完善本公约。
如果本网站用户对本网站基于本公约规定做出的处理有异议,可以通过「建议反馈」功能向本网站进行反馈。
(规则的最终解释权归属本网站所有)

我知道了
恭喜你~答对了
+5羽毛
下一次认真读哦
成功推荐给其他人
+ 10羽毛
评论成功且进入审核!审核通过后,您将获得10羽毛的奖励。分享本文章给好友阅读最高再得15羽毛~
(羽毛可至 "羽毛精选" 兑换礼品)
好友微信扫一扫
复制链接