Analytics

Regular analytics are updated within 2 to 6 hours.
▲ Back to top

You can find your user ID and user signature at the top of your Chartboost dashboard’s API Explorer page.
Click at any time to reset your user signature and revoke API access for third-party services.
Click to copy your user signature to the clipboard.
▲ Back to top

You have a few different options when it comes to monitoring your account. The Advertising Overview and Publishing Overview pages both offer at-a-glance views to easily identify trends over time. More information If you need to view more detailed reports, head to Apps > Analytics or Campaigns > Analytics, where you can also download data in TSV form (note: our TSV files have .csv extensions) for use with Excel or other programs. More information
▲ Back to top

Your Banner analytics are available in the App Analytics section of your Chartboost dashboard. The Campaign Analytics section does not include Banner analytics.
▲ Back to top

Because your Banner analytics are only displayed in the App Analytics section of Chartboost dashboard, your earnings will not match between App and Campaign analytics. Your total earnings are correctly displayed in the App Analytics and your interstitial & rewarded earnings are displayed in the campaign analytics.
▲ Back to top

    • The time zone used in analytics reports is Pacific Standard Time (PST).
    • Most analytics reports returned from our API are in JSON format.
    • Reports requesting from the campaign endpoint that group by country or creative, or all queries against the export install endpoint, are returned in TSV (tab-separated value) format.
    • All reports are UTF-16LE encoded for proper display of non-Latin characters.
    • If you make programmatic changes to analytics data received from Chartboost, you may need to update your system to account for tab separation.
    • Analytics reports should continue to open properly in Excel or other spreadsheet programs.
▲ Back to top

Don’t fret – because bootups/installs and other actions can take up to 2-6 hours to be reflected in the dashboard (though they usually arrive much faster), try checking your app analytics or campaign analytics again after that delay. You can also check this status page to see when analytics were last updated in the dashboard. If you’re still not able to see bootups/installs, double-check your code for one of the following calls:
    • iOS games: [Chartboost startWithAppId:@"YOURAPPID" appSignature:@"YOURAPPSIGNATURE" delegate:self];
    • Android games: Chartboost.startWithAppId(this, "YOURAPPID", "YOURAPPSIGNATURE");
    • iOS games built with Unity: CBBinding.init("YOURAPPID", "YOURAPPSIGNATURE");
    • Android games built with Unity: CBBinding.init();
Our system needs to receive these calls from your game every time it becomes active to accurately track bootups and installs.
▲ Back to top

Callbacks are server-to-server event notifications that report detailed information about clicks or converted installs driven by your campaigns. Learn more ▶
▲ Back to top

Larger analytics reports will automatically be returned in TSV form after our system processes the data, but if you regularly have trouble downloading the file, we recommend using callbacks or our API to report information to a third-party server or system.
▲ Back to top

▲ Back to top

Several factors can cause discrepancies between your app’s iTunes Connect install count and Chartboost’s, found here:

Below are some common causes:
    • iTunes Connect reports installs based on Apple IDs, while Chartboost uses unique device identifiers. This means you may see more than one install from Device X in iTunes Connect, but only one in Chartboost.
    • iTunes logs an install the moment your game is installed (even before launch). Chartboost requires the game to be launched at least once, with a reliable internet connection and proper SDK integration.
    • Chartboost always reports in PST/PDT (UTC-8 hours/UTC-7 hours), but iTunes reporting can vary depending on the developer’s location. iTunes Connect uses…
        • PST/PDT for developers in the US, Canada, and Latin America
        • CET for developers in Europe, the Middle East, Africa, and Asia Pacific
        • JST for developers in Japan
        • WST for developers in Australia and New Zealand
For more information about iTunes Connect reporting, click here.
▲ Back to top

    • All installs: The number of times that Chartboost receives an initialization call from your app. Often includes installs not received from Chartboost.
    • Bootups: A call from the Chartboost SDK that is logged each time a user launches your app on a device.
    • Uniques: The number of unique devices that launch your app. This number is a unique count of devices per app, per day. Uniques cannot be summed across apps or days because this would duplicate some devices and result in an inflated number. The accuracy of the number of uniques depends on the developer sending 100% of their app’s bootups to Chartboost.
    • Installs delivered: The number of times a user clicked an ad, then initially booted up the promoted app during your publishing campaign.
    • Installs received: The number of times users initially booted up your game after clicking an ad for it in an advertising or cross-promotion campaign.

You might also like…
▲ Back to top