Cost API

🚧

Important Note

Data Issue Report
We have identified an issue affecting the accuracy of impression and click numbers in the COST API under certain conditions, which may cause data discrepancies (* the ad cost data won’t be affected). This issue has been previously reported to our Mobile Measurement Partner (MMP) partners.
The problem originated in our legacy data pipeline. We have identified the root cause and released a fix. However, due to the significance of this upgrade, we are conducting a gradual migration to ensure stability and prevent any critical issues.

System Upgrade Announcement
The new data pipeline is currently in closed beta. If you encounter the data discrepancies issue, please contact your Account Manager.

Please note that this feature is only for AIBID solution

Appier we offer our clients two options to view cost data for their new user marketing campaigns: campaign level data & inventory level data. The primary difference between the two options is tied to the amount of data or the granularity of the data they provide:

• campaign_report API will give you access to campaign level data with 6 to 8 hours delay.
• inventory_report API will show inventory level data, but at the cost of a 48 hour delay for data entry, data is updated hourly.

📘

Note

Due to the 48hr delay in inventory_report API, we will initially default to providing the campaign level data upon request.

API Data

Our API will provide you with the following data in JSON format:

- date (YYYY-MM-DD)
- campaign_id (generated by Appier)
- campaign_name (generated by Appier. If you need a custom campaign name, please let us know in advance)
- impressions
- clicks
- installs (install or any KPI event count)
- cost
- currency
- timezone

- date (YYYY-MM-DD)
- timezone
- app_id (your App)
- campaign_id (generated by Appier)
- campaign_name (generated by Appier. If you need a custom campaign name, please let us know in advance)
- geo
- currency
- cost
- impressions
- clicks
- installs (install or any KPI event count)
- publisher_id (encoded exchange value)
- sub_publisher_id (encoded bundle ID)
- publisher_site_id (encoded bundle ID)
- os (Android/iOS)

Example Data

Campaign Report API	Inventory Report API

API Endpoint

If the data and its format match your requirements, please notify our Account Manager and we will provide you with an access token for you to access the report in accordance to the requested format.

https://mmp.appier.org/campaign_report?access_token={YOUR_TOKEN_HERE}&start_date={START_DATE}&end_date={END_DATE}&timezone={TIME_ZONE}

https://mmp.appier.org/inventory_report?access_token={YOUR_TOKEN_HERE}&start_date={START_DATE}&end_date={END_DATE}&timezone={TIME_ZONE}

Make sure to edit the access_token, start_date, end_date, and timezone parameters accordingly.

🚧

Be careful

For Agencies, please note that access_token you get may include all of the campaigns that you run with Appier.

If your Advertiser request to get api token, please inform it to your Account Manager.

Example URL:

Notes

• Time: The date on API is based on the event times.
• Number of Installs: Although the key name is installs, we are able send any KPI event count (such as install or purchase) to this key.
• Supported Traffic: This endpoint is exclusively for RTB traffic data.
• Inventory Report API: Data only support 60 days retention, and request time range cannot be longer than 10 days.

📘

Looking for MMP Specific Cost Data integration?

Please refer to the following documents instead:

• AppsFlyer
• Singular
• Tenjin