B站广告投放数据API对接-如何操作上报-转化回传

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 字符串，具体格式如下：

若调用失败，请尝试重新调用。