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).
In order to call IAP tracking methods, use the following static method, declared in CBAnalytics.h:
+ (void) trackInAppPurchaseEvent:(NSData *)transactionReceipt
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.)
CB_TEST_MODEenvironment variable before launching your game!