广告点击数据上报接口
一、接口说明
此接口用于接收媒体上报的广告点击数据,当用户点击广告时上报。我方收到点击数据后,会将点击数据保存, 当用户下载安装应用打开后,通过算法匹配到点击数据,并调用callback_url将激活归因事件回调给媒体。
请求协议和方法
支持HTTPS GET方法发送请求,这种方式下请求参数需要包含在请求的URL中。
字符编码
UTF-8
接口地址
https://ad.openinstall.io/ad/click
接口参数说明
参数名 | 描述 |
---|---|
op_ak | 应用标识(创建Openinstall渠道后提供) |
cid | 渠道标识(创建Openinstall渠道后提供) |
os | 系统类型,1表示iOS,0表示安卓 |
idfa | iOS广告标识符 |
ip | 客户端ip |
ua | User-Agent |
ad_clickid | 广告归因激活回调url,即callback_url,媒体提供。urlEncode(utf-8) |
oaid | 安卓广告标识符 |
imei | 移动设备识别码,安卓 |
iOS示例数据:
二、操作步骤
1、在【渠道管理】-【广告渠道】-【添加广告平台渠道】中,选择【通用】广告平台,填入信息后保存。
2、复制监测链接
① 复制详情页链接:
https://ad.openinstall.io/ad/click?cid=62901cb418c85caf7b49efe2&op_ak=uj8dz3
② 根据投放的媒体对接文档,在监测链接后拼接其他参数,例如拼接:
https://ad.openinstall.io/ad/click?cid=62901cb418c85caf7b49efe2&op_ak=uj8dz3&idfa={idfa}
其中 idfa={idfa} , 参数名idfa由我方定义,参数值{idfa}即宏参数由媒体定义。
以此类推,拼接完媒体支持的其他宏参数后,得到完整链接,如:
https://ad.openinstall.io/ad/click?cid=62901cb418c85caf7b49efe2&op_ak=uj8dz3&os=1&idfa={idfa}&ip={ip}&ua={ua}&ad_clickid={callback}
③ 将完整的链接交给投放人员或媒体,进行投放监测。在投放过程中,当用户点击广告,媒体替换链接上的宏参数并填充相应信息,例如:
通过此链接发送HTTP GET请求将点击数据上报给我方即可。