广告点击数据上报接口

一、接口说明

此接口用于接收媒体上报的广告点击数据,当用户点击广告时上报。我方收到点击数据后,会将点击数据保存, 当用户下载安装应用打开后,通过算法匹配到点击数据,并调用callback_url将激活归因事件回调给媒体。

请求协议和方法

支持HTTPS GET方法发送请求,这种方式下请求参数需要包含在请求的URL中。

字符编码

UTF-8

接口地址

https://ad.openinstall.io/ad/click

接口参数说明

参数名描述
op_ak应用标识(创建Openinstall渠道后提供)
cid渠道标识(创建Openinstall渠道后提供)
os系统类型,1表示iOS,0表示安卓
idfaiOS广告标识符
ip客户端ip
uaUser-Agent
ad_clickid广告归因激活回调url,即callback_url,媒体提供。urlEncode(utf-8)
oaid安卓广告标识符
imei移动设备识别码,安卓

iOS示例数据:

https://ad.openinstall.io/ad/click?cid=62901cb418c85caf7b49efe2&op_ak=uj8dz3&os=1&idfa=3567737C-77C5-4F60-86DC-04BC1F1C97GF&ip=119.11.23.12&ad_clickid=http%3A%2F%2Ffoldplum.com%2Fjlss%2Fconfirm.jsp%3Fidfa%3D3567737C-77C5-4F60-86DC-04BC1F1C97GF%26clickid%3Dxxx%26ip%3D119.11.23.12

二、操作步骤

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}

③ 将完整的链接交给投放人员或媒体,进行投放监测。在投放过程中,当用户点击广告,媒体替换链接上的宏参数并填充相应信息,例如:

https://ad.openinstall.io/ad/click?cid=62901cb418c85caf7b49efe2&op_ak=uj8dz3&os=1&idfa=3567737C-77C5-4F60-86DC-04BC1F1C97GF&ip=119.11.23.12&ad_clickid=http%3A%2F%2Ffoldplum.com%2Fjlss%2Fconfirm.jsp%3Fidfa%3D3567737C-77C5-4F60-86DC-04BC1F1C97GF%26clickid%3Dxxx%26ip%3D119.11.23.12

通过此链接发送HTTP GET请求将点击数据上报给我方即可。