简介

开发者使用 Tracking Link 上报广告点击事件，Bonamobi 平台将基于这些点击数据进行后续的归因和分析。

上报步骤

获取 Tracking Link

从 Offer API 获取广告 Offer 的 Tracking Link。

上报时机

建议在用户点击广告并跳转至 Google Play Store 时触发上报。

上报内容

替换 Tracking Link 中的宏（例如 {click_id}），然后进行 URL 编码处理。

上报示例：

原始 Tracking Link

http://api.bonamobi.com/moonlight/v4?value=5146ea64xxx&click_id={click_id}&affiliate_id={affiliate_id}&idfa={idfa}&gaid={gaid}&imei={imei}&android_id={android_id}&mac={mac}&oaid={oaid}&ua={ua}&os_version={os_version}&device_model={device_model}&ip={ip}&country_code={country_code}&ext={ext}

替换后 Tracking Link（以非华为手机安卓为例）

http://api.bonamobi.com/moonlight/v4?value=5146ea64xxx&click_id=4948d389-88a5-f63b-49b7-ff4831b5e21b&affiliate_id=YFQH&idfa={idfa}&gaid=d49bad8e-9fbf-442f-a5ee-87beb3492d10&imei={imei}&android_id={android_id}&mac={mac}&oaid={oaid}&ua=Dalvik/2.1.0%20(Linux;%20U;%20Android%206.0;%20ZTE%20BA520%20Build/MRA58K)&os_version={os_version}&device_model={device_model}&ip=101.72.203.33&country_code=IN&ext={ext}

Tracking Link 参数说明

参数分类	参数名	参数类型	参数描述	是否为必填
通用信息	value	string	无需替换，请勿修改	N
affiliate_id	string	渠道标识，从 AM 处获取	Y
channel	string	渠道信息，取值：gp、other	N
设备信息	imei	string	Android 设备的设备标识
android_id	string	Android 设备的设备标识
mac	string	设备 MAC 地址，以 MAC 进行归因的 Offer 必传。
uagent	string	设备 User-Agent	Y
os_platform	string	系统平台，例：android
os_version	string	操作系统版本，例：3.0
device_model	string	设备型号，例：vivo 1901
用户信息	gaid	string	Google 广告平台的用户标识	Y
idfa	string	iOS 设备的设备标识，iOS 必传
oaid	string	若用户使用华为手机，则 gaid 不存在，此时 oaid 必传
ip	string	设备网络 IP 地址，开发者服务器端需要获取 APP 客户端外网 IP 并填入此字段，而非客户端本地获取的内网 IP	Y
country_code	string	ISO 3166-1 国际标准二位字母代码 (alpha-2)，示例：CA、US。 country_code 与 ip 需至少上报一个，建议二者均上报
ext		拓展个性化参数，最长 100 字符
归因信息	click_id	string	开发者需为每次点击上报生成一个不重复的 clickid，最长 150 个字符。若上报为空或者重复上报，则无法匹配对应的上报点击，影响整体数据统计	Y
pkg_name	string	offer 应用包名	N
event	string	show - 展示 click - 点击 startDownload - 开始下载 download - 下载结束 startInstall - 开始安装 install-安装 注：需按照当前枚举值进行替换，区分大小写	N