Description: This article describes how to integrate and check your integration with a number of different app analytic tools. InnovidXP has integrations available for 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 |
Follow the steps for Kochava in our Help Center article: App Integrations. |
|
Branch (formerly Tune) |
Customer SITE ID and CLIENT ID |
Follow the steps in this article. |
|
Singular |
Customer SITE ID and COLLECTOR ID |
Follow the steps in this article. |
|
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 on how to integrate with AppsFlyer.
AppsFlyer AAP Discrepancies
When the AppsFlyer Aggregated Advanced Privacy (AAP) is switched on, the information we receive for 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.
The result of the AAP option being switched on is that we will not be sent 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 getting some data from iOS and all Android users, there will be data available, but iOS users will be undercounted, which can possibly skew the data.
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. 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, and we recommend 3 Attempts.
- Delivery Method: Select your preferred delivery method, and we recommend All.
-
Select Save.
TransUnion (formally 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
After you have integrated the app successfully, we will collect the data and process it 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 for a full 24 hours of data collection to pass before comparing volumes with your integration to ensure we are pulling through the correct volumes of traffic.
You will notice the traffic is classified as direct or out of scope; with our integrations, we only pull through traffic attributable to television and then classify whether it is out of scope based on the country of origin.
This means there are no classification rules which 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.