Click Reporting
Introduction
Developers use the Tracking Link to report ad click events. The Bonamobi platform will use this click data for subsequent attribution and analysis.
Reporting Steps
Obtain Tracking Link
Get the ad offer's Tracking Link from the Offer API.
Reporting Timing
It is recommended to trigger the report when the user clicks the ad and is redirected to the Google Play Store.
Reporting Content
Replace the macros (e.g., {click_id}) in the Tracking Link, then perform URL encoding.
Reporting Example:
Original 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 After Replacement (Example for non-Huawei Android device)
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 Parameter Description
| Parameter Category | Parameter Name | Type | Description | Required |
|---|---|---|---|---|
| General Info | value | string | No need to replace, do not modify | N |
| affiliate_id | string | Channel identifier, obtained from AM | Y | |
| channel | string | Channel info, values: gp, other | N | |
| Device Info | imei | string | Device identifier for Android | |
| android_id | string | Device identifier for Android | ||
| mac | string | Device MAC address, required for offers attributed by MAC | ||
| uagent | string | Device User-Agent | Y | |
| os_platform | string | OS platform, e.g., android | ||
| os_version | string | OS version, e.g., 3.0 | ||
| device_model | string | Device model, e.g., vivo 1901 | ||
| User Info | gaid | string | Google Advertising ID | Y |
| idfa | string | iOS device identifier, required for iOS | ||
| oaid | string | If the user uses a Huawei device, gaid does not exist, oaid is required | ||
| ip | string | Device public IP address, must be obtained by the developer's server from the app client, not the local IP | Y | |
| country_code | string | ISO 3166-1 alpha-2 code, e.g., CA, US. At least one of country_code or ip must be reported, both are recommended | ||
| ext | Custom extension parameter, up to 100 characters | |||
| Attribution Info | click_id | string | Developers must generate a unique click_id for each click report, up to 150 characters. If empty or duplicate, the click cannot be matched, affecting data statistics | Y |
| pkg_name | string | Offer app package name | N | |
| event | string | show - impression, click - click, startDownload - start download, download - download complete, startInstall - start install, install - install. Note: use the current enum values, case sensitive | N |
title: tracking createTime: 2025/05/26 14:42:28 permalink: /en/tracking/