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
	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
User Info	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	string	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/

---