Post-Install Analytics Integration for iOS

Last Update:

Post-Install Analytics Integration for iOS


Before you get started, you'll need to:

Declaring a Chartboost Singleton

The header CBAnalytics.h contains the public methods that track IAP events. This class will only be usable if the session has been initialized (calling the startWithAppId method of the Chartboost class; see this page).

IAP Tracking

In order to call IAP tracking methods, use the following static method, declared in CBAnalytics.h:

API Methods

+ (void) trackInAppPurchaseEvent:(NSData *)transactionReceipt 
product:(SKProduct *)product;

The Product object contains information about the item purchased, and the receipt will let us validate the transaction with Apple. (For more information, see Apple's SKProduct class documentation.)

Testing Your PIA Setup

After completing the PIA integration, you can enable a sandbox mode to test your work, before submitting your game for App Store approval.

To do this, you'll need to enable a test mode flag in the Chartboost SDK via an environment variable in Xcode. Here's how:

1. Open the scheme section at the top-left corner of Xcode and pick Edit Scheme from the drop-down menu:

2. Click Run in the left-side menu and switch to the Arguments tab:

3. Click the + symbol in the Environment Variables section and type CB_TEST_MODE in the Name field that appears:

4. Double click the space beneath the Value title and enter on in the field that appears:

After that, click OK, run your project, and make a purchase in development mode – you should see the app appear in the Post-Install Analytics dashboard within a few minutes, if you've already integrated PIA in a different game. (If this is your first PIA app, please allow up to one day to gain access to the PIA dashboard.)

(Note that – because sandbox mode is enabled – you will not see any IAP data in the dashboard.)

Be sure to remove the CB_TEST_MODE environment variable before launching your game!