Purpose
This article describes how to integrate and check your integration with several different app analytics tools. InnovidXP offers integrations with Adjust, AppsFlyer, Kochava, and Branch. Singular and TransUnion are also possible options; contact them directly for guidance on app integration.
Requirements
Before you begin, note the following:
- The instructions below are updated regularly; however, the app partner's website should be the most up-to-date with any UI alterations they have made since the time of writing.
- Ensure you enable all Postbacks within the App Partner Setup screens.
- We need raw Event Postbacks sent to us. No pre-filtering or attribution methodology should be applied, or results may be skewed or omitted completely.
The following table lists what is required for each tool and where to access the integration instructions:
| App integration tool | What is required (provided) | How to integrate |
Adjust |
Customer SITE ID and COLLECTOR URL |
Follow the steps on the Adjust website. |
AppsFlyer |
Customer SITE ID and COLLECTOR ID |
Follow the steps on the AppsFlyer website. |
Kochava |
App name (name of the customer in the platform), Customer SITE ID, and COLLECTOR ID Note: The integration name in Kochava is now updated to “InnovidXP” (formerly “TVSquared”). Ensure you select InnovidXP. |
Follow the steps for Kochava below. |
Branch (formerly Tune) |
Customer SITE ID and CLIENT ID |
Follow the steps for Branch below. |
Singular |
Customer SITE ID and COLLECTOR ID |
Follow the steps for Singular below. |
TransUnion (formerly Signal) |
- |
Contact InnovidXP Support to integrate with TransUnion. |
Adjust
What you need
Before you start, you will need to know your InnovidXP Site ID and Collector URL. To find these, complete the following:
- Select Data > Responses > Tracker Instructions > Step 1 and copy the values highlighted below. Or you can copy the mandatory fields from Data > Responses > How to Integrate with Adjust.
-
Add tv2track.php to the Collector URL to create the Client Endpoint: https://collector-xxxx.tvsquared.com/tv2track.php
- Go to the following Adjust web page and follow the Basic setup instructions:
https://help.adjust.com/en/integrated-partners/tv-squared
You can then optionally use the Advanced setup instructions to customize what Innovid receives.
AppsFlyer
What you need
Before you start, you will need to know your InnovidXP Site ID and Collector ID. To find these, complete the following:
- Select Data > Responses > InnovidXP Tracker Instructions > Step 1.
- Copy the values highlighted below:
How to integrate
Select the link to find out everything you need to know about how to integrate with AppsFlyer.
AppsFlyer AAP Discrepancies
When the AppsFlyer Aggregated Advanced Privacy (AAP) is enabled, the information we receive from iOS devices is limited. Those users who have opted in only receive a pingback. This ping does not give us any identifiable information, i.e., IP addresses. Since we cannot identify the users, we cannot account for duplications, so these pings are not counted by Innovid.
Users who have not opted in send back IP addresses, which are included in our response data.
Enabling the AAP option means we will not receive ALL in-app event postbacks from iOS users. Therefore, when confirming volumes, we compare with the opt-out subset of iOS traffic only.
Since we are collecting data from iOS and Android users, there will be data available, but iOS users will be undercounted, which could skew the results.
If Advanced IP filtering is switched off in the AppsFlyer UI, numbers will increase significantly.
Kochava
What you need
Before you start, you will need to know your app name - this is the name of your InnovidXP platform.
You will also need your InnovidXP Site ID and Collector ID. To find these, complete the following:
- Select Data > Responses > Tracker Instructions > Step 1.
- Copy the values highlighted below:
How to integrate
You can integrate InnovidXP with Kochava through the Kochava interface.
Note: The integration name in Kochava is now updated to “InnovidXP” (formerly “TVSquared”). Ensure you select InnovidXP.
The steps are as follows:
Create a New Postback Configuration
- Log in to Kochava and select the relevant Account and App.
- Select Apps & Assets > Partner Configuration.
- Select Add a Configuration.
- Select Media Partner.
- Select Go.
Edit Postback
- Complete one of the following:
- For an Install Event Postback, select Install > Postback Tools ( ⋮ ) > Edit.
- Complete the following:
- App Name: the name of your Innovid platform.
- Site ID
- Country Code: Select All.
- Collector ID
- Supply Network Data to Analytics Partner: Select True.
- Deliver Delay: Select Realtime Delivery.
- Retry Attempts: Select your preferred number of retry attempts; we recommend 3.
- Delivery Method: Select your preferred delivery method; we recommend All.
- Select Save.
TransUnion (formerly Signal)
Contact InnovidXP support at support-xp@innovid.com for guidance on this integration.
Branch (formally Tune)
Contact InnovidXP support at support-xp@innovid.com for guidance on this integration.
Singular
Contact InnovidXP support at support-xp@innovid.com for guidance on this integration.
Check your integration
Once you have successfully integrated the app, we will collect and process the data daily. Within the next 24 hours, you will be able to see some of the raw data come through on the Raw Breakdown page ( by navigating to Data > Responses > Raw Breakdown).
Allow a full 24 hours of data collection to pass before comparing volumes with your integration to ensure we are pulling the correct traffic volumes.
You will notice that traffic is classified as direct or out of scope. With our integrations, we pull through traffic attributable to television and classify it as out of scope based on the country of origin.
This means there are no classification rules that apply to the traffic, for example:
Note: If overall data volumes do not meet your expectations, ensure your app integration is set up correctly. Please contact support-xp@innovid.com if you have any questions.
Related content
Getting Started: Integrating with InnovidXP
Setting Up App Response Data