Ad spend callbacks

The ad spend data point is specifically for accessing ad spend data that networks send to us through our Partner ad spend push API. You need to confirm with the networks you’re running campaigns with whether they are using the Parnter ad spend API or the ad spend on engagement method to send us ad spend data.

If they're using ad spend on engagement, you can append thes following placeholders to an impression, click, install, and/or global callback URL instead.

Recommended placeholders

PlaceholderDescriptionExample
{cost_type}The campaign pricing modelcpi
{cost_amount}Cost of the user engagement4.99
{cost_currency}ISO 4217 currency code of the cost dataeur
{reporting_cost}Cost of the user engagement converted to your app’s reporting currency and as displayed in Datascape2.56
{cost_id_md5}An MD5 hash of the cost ID provided by a network using our ad spend API73a00ef928d55b23071bff981c098d48
Note:
If placeholder data is not available, it will be dropped from the callback.

Callback example

Callback URL with placeholdersUnencoded (Do not use as is)
Callback URL populated with values
https://serverendpoint.com/mobile_attribution?gps_adid={gps_adid}&idfa={idfa}&idfv={idfv}&adid={adid}&tracker_token={link_token}&tracker_name={link_name}&app_name={app_name}&activity_kind={activity_kind}&created_at={created_at}&cost_type={cost_type}&cost_amount={cost_amount}&cost_currency={cost_currency}&reporting_cost={reporting_cost}&cost_id_md5={cost_id_md5}

Other recommended placeholders

We also advise that you include the following placeholders in all callback URLs. These placeholders will ensure that you always receive basic information that you can use to identify the app, link, data point, and device to which the rest of your callback data belongs.

PlaceholderDescriptionExample
{gps_adid}Google Play Store advertising ID (Android only)38400000-8cf0-11bd-b23e-10b96e40000d
{idfa}ID for advertisers (iOS only)8C6CBCOD-5F43-4765-A6E6-84DFF3D24707
{idfv}ID for vendors (iOS only)CCB300A0-DE1B-4D48-BC7E-599E453B8DD4
{adid}Adjust device ID18546f6171f67e29d1cb983322ad1329
{tracker}Adjust link tokenabc123
{tracker_name}Current link name as defined in Campaign LabNetwork1%3A%3AChristmas%3A%3AReindeers%3A%3A320x70_en
{app_name}Name of the appMyApp
{activity_kind}This will allow you to determine the data point: impression, click, install, rejected install, rejected reattribution, session, reattribution, uninstall, reinstall, reattribution reinstall, updated attribution, in-app event, or ad spend (cost_updated)rejected_reattribution
{created_at}The timestamp for when the data point occurred1404214665