Kochava

This integration makes your Kochava attribution data available in Xtremepush for the purpose of analytics and segmentation. With the integration enabled you will be able to see your users' install sources and send them on customised journeys, target specific audiences, and view analytics over time.

📘

The integration to get attribution data is an additional feature and also requires a subscription with the third party. If you wish to use this feature and to discuss pricing please get in touch with your account manager.

Create a connection to Kochava

Select the Kochava card in the Integrations marketplace tab and click Request. Requesting a Kochava integration will create a support ticket. Our support team will be in contact regarding enabling the integration.

Collecting advertising IDs

Advertising platforms such as Google and Facebook identify installs using the advertising IDs for each mobile device. You must be collecting these IDs from your mobile app using the Xtremepush SDK in order to use this integration.

Android

For your Android apps, you need to add Play Services Ad Support to your build.gradle file.

compile 'com.google.android.gms:play­-services-ads:11.8.0'

Update your Android Manifest file by adding the following code.
YOUR_PACKAGE_NAME is replaced with your app's package name.

<receiver android:name="ie.imobile.extremepush.receivers.ReferrerReceiver"> 
<intentfilter>
  <action android:name="com.android.vending.INSTALL_REFERRER" />
  <category android:name="YOUR_PACKAGE_NAME" /> 
</intentfilter>
</receiver>

Call the setAttributionsEnabled method when initialising the Xtremepush SDK by modifying your existing implementation when initialising the push connector as shown in this example:

mPushConnector = new PushConnector.Builder("XPUSH_APP_KEY", "GOOGLE_SENDER_ID")
    // Add the following line to your existing implementation
    .setAttributionsEnabled(true)
    .create(this);

iOS

For iOS, use the Adsupport.framework in your apps.

Call the setAttributionsEnabled method before the call to applicationDidFinishLaunching by modifying your existing implementation as shown in this example:

func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {    
    XPush.setAppKey("XPUSH_APP_KEY")
    // Add the following line to your existing implementation
    XPush.setAttributionsEnabled(true)
    XPush.applicationDidFinishLaunching(options: launchOptions)    
    return true
}

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
{
    [XPush setAppKey: @"XPUSH_APP_KEY"];
    // Add the following line to your existing implementation
    [XPush setAttributionsEnabled: YES];
    [XPush applicationDidFinishLaunchingWithOptions:launchOptions];
}

Set up a sync for a new integration

If you have created a connection with Kochava and you want to define a new time window for the installs sync for that connection, go to Settings > Integrations > Marketplace > Configured Integrations, and select the integration. This takes you to the Overview tab.

Click on the Actions button and select Sync installs. You will be asked to select the time window you want the sync to run for. Click Start sync to confirm.

View logs

Select the integration you want to view install logs for at Settings > Integrations > Marketplace > Configured Integrations, this takes you to the Overview tab.

Install synchronisations between Kochava and Xtremepush are run every hour.

In the Sync history table you can search for a specific sync by date, task, info, or status.

Click on the Details icon for a specific sync task to open the Task details. You will find specific details for this sync, such as the number of Installs processed and Installs attributed. Click the download icon to export a CSV file containing all data from the sync task.

Create an additional connection

To create an additional Kochava connection, select the Kochava card in the Integrations Marketplace tab found at Settings > Integrations > Marketplace. Click Connect New and repeat the integration steps outlined in the above section.

Update an existing connection

Select the integration you want to update at Settings > Integrations > Marketplace > Configured Integrations. Go to the Settings tab to update the Name of the connection, API Key, or App GUID. Click Save to confirm any changes.

Deactivate or delete a connection

Select the integration you want to update at Settings > Integrations > Marketplace > Configured Integrations. Go to the Settings tab and click the Actions button. You will be presented with the option to either Deactivate or Delete the integration. Clicking either of them opens a confirmation dialog.