Tapjoy With Pinch Analytics

If you are an existing Pinch Analytics user looking to switch over to the combined Pinch and Tapjoy library you'll notice that there are quite a few differences in how to use the beacon library. This documentation page will illustrate how to use Pinch Analytics inside the combined library. For information on how to use the Tapjoy specific features on the library please check out the documentation that is distributed with the library.

Instructions

1. Set your application code

   You can retrieve your Pinch application code via this page. Your application code must be added to the TapjoyConnectInterface.m file in order to start using Pinch Analytics. In this file you will see a section for your Pinch ID. Replacing this value with your application code will turn on analytics. No further action is required for basic analytics.

   //Optional: To Record the events at Pinch Media
   -(NSString *) pinchMediaAppId
   {
   	//Your Application's Pinch Id here.
   	return @"REPLACE THIS WITH YOUR OWN APPLICATION CODE";
   }

2. Add sub-beacons to your application (optional)

   To track a simple action inside your application add the following code to where you would like to record the action and change the name. This will provide you data about how many occurrences this action saw, how many sessions this action happened in and additionally how many unique users saw this action.

   [[TapjoyConnect requestTapjoyConnectWithDelegate:nil] startSubBeaconWithName:@" MY APP 
   TEST EVENT " timeSession:NO];

   To time a sub-beacon, add the following code to your application. This will report on the same metrics as above as well as a few duration metrics.

   //Record a time/session bases Action 
   [[TapjoyConnect requestTapjoyConnectWithDelegate:nil] startSubBeaconWithName:@" Test  
   Session " timeSession:YES]; 
    
   //End time/session based Action  
   [[TapjoyConnect requestTapjoyConnectWithDelegate:nil] endSubBeaconWithName:@"Test  
   Session Event"]; 

3. Record location data

   You can record CoreLocation data through the combined library by passing in a CLLocation object which you request independently in your application into the library. This will allow us to aggregate a geo report beyond the country level for beacons which have location data. To use this feature implement the following code.

   [[TapjoyConnect requestTapjoyConnectWithDelegate:nil]] setBeaconLocation:myLocationObject] 

That's it! Once you have finished at least step one your application is ready to send analytics data to our system. Sit back and wait a bit for the aggregated reports to start showing up on the developer site.