iOS Integration

1. Using CocoaPods

Our sdk is distribuited with CocoaPods

pod 'InstalAdvertiserSDK', :git => 'https://bitbucket.org/tbdsrl/instal-advertiser-sdk-ios-distr.git'

2. Manual integration

Download zip package and include it in your project.

You will need to include Apple's AdSupport.framework in you project.

3. Tracking Install

In your AppDelegeate.m file please include following header:

#import "InstalAdvertiserSDK.h"

And in your application: didFinishLaunchingWithOptions: add following line:

[[InstalAdvertiserSDK sharedInstance] trackInstallWithApiKey:@"{{ api_key|default:"APIKEY" }}" appStoreId:@"{{store_id|default:"STOREID"}}"];

4. How to submit your application with IDFA

After April 11, 2014 the IDFA policy on iTunes has changed to allow developers to have a better and more precise analytics Apple guidelines update.

To have your application published you have to check the following options on iTunes:

  • “Attribute this app installation to a previously served advertisement”
  • “Attribute an action taken within this app to a previously served advertisement”

5. Tracking Events

To track an event you need to call

[[InstalAdvertiserSDK sharedInstance] trackEvent:@"Event Name"];

If you want to add numeric value to your event use passing NSNubmer object as value.

[[InstalAdvertiserSDK sharedInstance] trackEvent:@"Event Name" value:@(12.3)];

6. Troubleshooting

If you are getting an "Undefined symbol for architecture" compile error it means you forgot to include AdSupport.framework in you project

7. Test

For testing if the integration is working correctly for iOS it is enought to uninstall and reinstall the application from the device than you should see the last conversion registered updated.