Last Updated on
July 15, 2022
The campaign analytics endpoint provides detailed reports that can be grouped by either app or creative. Be advised that when specifying a groupBy field, a job ID will be returned by the Queued Analytics system, as detailed in the “Before you begin” section.
The app analytics endpoint provides detailed reports that can be grouped by app, ad type, or ad location.
The export installs endpoint provides a full list of all installs received and/or provided. Please note that this endpoint will always return a Job ID from the Queued Analytics system, as detailed in the “Before you begin” section.
In addition to the endpoints you’ll find on the dashboard’s API Explorer page, we’ve built one specially designed to return clean analytics data at the app, date, and country level. This endpoint can also be used on behalf of Chartboost customers by third-party attribution and mediation services that require country-level data.You can expect the full data for a previous calendar day to be available 9 hours after that date is completed in most cases. For example, you can expect that the data for a day ending 0:00 AM PST (7:00 AM UTC) will be completely available after 9:00 AM PST (4:00PM UTC).
When you use the App analytics grouped by country the data is limited to the past 40 days.
Note for mediation networks: We strongly recommend that you omit the campaignType field, as the API will automatically return results for network.
Please note that there might be a discrepancy between app and campaign endpoints and your dashboard analytics. Use the campaign endpoint and group by country to retrieve app, country, and ad_type data.
While data returned by this endpoint is typically only 1-3 hours delayed, in extreme cases it may take up to 9 hours after a day has ended for that day’s complete data to become available to this API.
By default, data from this API segments calendar days by UTC time.
Any adLocation sent with empty "" string value via SDK are aggregated under Default.
adLocation values must cross a small threshold of activity (generally around 10 different ad creatives displayed, for example), otherwise they will not be broken out and instead aggregated under Default.