1. 点击上报介绍
接口简介:
B站广告投放典型的上报地址示例如下,回调参数可借鉴如以下配置:
http:/url/advstat/track/bili_feedback_url?trackid=__TRACKID__&crid=__CREATI
VEID__&os=__OS__&model=__MODEL__&mac=__MAC1__&idfa=__IDFAMD5__&ip
=__IP__&ua=__UA__&click_ts=__TS__
其中调用方可自定义参数名称,API1 中关于广告主如何定义参数名,B站广告投放并不做限制,仅将广告主提供的链接中的宏按规则进行替换。宏的定义参考下文表格:
点击监测地址支持的宏参数列表如下:
注意:参数名广告主可自定义,并选择所需要的宏进行参数值的获取。如需要做激活
回传,“__TRACKID__”为必填宏,其值在 API2 回传中使用
回调地址在 B 站广告投放后台创建创意时填写,作为向广告主发送点击事件的固定地址。
一个 B 站广告服务端发出的 API1 请求案例:
http://XXX.com/callback/bilibili?click_time=1519626045000&client_ip=10.23.60.13
8&device_type=2&imei=b72c9cbd09706fc9b686a6421b4875ca&track_id=WZNsJ
EC1cc2r2QYqhdSWs307tAhHX4CRfff8NEm4N_ckdjdQ4kUll6446qhbDHbkMvfUSYw
EM7S2G3I6dmRlAB8tSZ5g
M4_uHJmHKV8aTBMpYVIYKAuGl1ri7VXy5h__1retObLe
SMdcEBTWlXRF400fWayyMhKCfPJrkZl5c=_01
API1 若调用成功,服务端应返回 http code 200,表示接收成功。
2.转化回传接口(API2)介绍
1、广告主产生某种转化行为的时候,调用回传 API 对 B 站 API2 接口进行数据上报。
2、回传的转化记录将通过 TrackID 与历史广告的点击行为进行关联,从而记录在广告主的相关记录中,用于后续 DMP 服务,及投放系统的报表展示。
接口简介:
典型的请求 URL 为:
https://cm.bilibili.com/conv/api/conversion/ad/cb/v1?conv_type=APP_FIRST_ACTI
VE&conv_time=……
一个广告主服务端发出的 API2 请求案例:
https://cm.bilibili.com/conv/api/conversion/ad/cb/v1?conv_type=APP_FIRST_
ACTIVE&conv_count=3&conv_time=1529741853000&imei=b24a86f7b373f1cc1ed
de4fc522367fe&os=2&client_ip=49.95.205.227&track_id=MkPeuXp4Hst6S74klNN
wiC9moFW23Im4C45yglMsHep8rpZcuqoP
VGjNRaTRjyg1eypWOCg7NkBixUNYTpWD6KOYN_eKhqGffEKS5nkcg_aNa0gLHW4_ZUFxgM0aIVXgx3OdkFrAPRcmL5M4bTkFw-9GUvYQxbgOVUth-wD9PQFEV
c_G8pSk2f4PrX8LuwPtrAe7B_M57tnXX1Vu_TUg%3D%3D_01
API2 调用后,若调用成功,返回 http code 200,并返回一个 Json 字符串,具体格式如下:
若调用失败,请尝试重新调用。