Pipelining Data to Kochava
Configuring data pipelining is easy and requires no SDK updates or any other updates to the app code itself. Sending data to Kochava requires copying and pasting 2 keys from the Kochava dashboard into SOOMLA Dashboard. The full details can be found inside the SOOMLA dashboard or in the rest of the article below.
Data Delay
3 days - Kochava API cannot accept adjustments to revenue per user backwards
Special Limitations
N/A
Integration Steps
- Click on one of your apps -> Click IntegrationsIf your app is not live, you will be automatically redirected to Integrations page
- Go to the “Data Pipelining” tab and click on Kochava logo
- You will need to supply the Event Name and the App Id in the SOOMLA dashboard. Let's see how to get them in Kochava dashboard:
- Go to Kochava dashboard
- In the main view expand the desired app and find the App Id - record it for later
- Find the 3 vertical dots to the right of the app name and click on them
- Click on Event Manager from the sub menu
- Add a new event and name it as a custom event
- After the event is set up, click the 3 vertical dots and mark the "Is Revenue" option for this event
- Copy the Event Name
- Put the Event Name you just generated and the App Id for the package name you want to activate
The fields will be saved when you click "Enter" or when you click somewhere outside of them. Make sure you see a small loader that indicates that the field was saved.
Verify the data shows up in Kochava
To see the data in Adjuat follow these steps:
- Click on the 3 vertical dots of the relevant app
- From the sub menu choose "Analytics"
- In the Analytics screen choose the "Event Volume" view
- You should be able to see the event shows up in this view
Once you verified the ad revenue shows up, you might want to see the ad revenue as part of the LTV view or in the Cost&ROI view.
Q&A
Question: There's nowhere to put the credentials
Answer: Your app is not live with SOOMLA yet. On the day after you went live with SOOMLA you will see a list of package names and you can set the credentials for one of them.
Question: Why is the data sent with delay.
Answer: The revenue from ad-networks is often being updated retroactively. This can happen due to late conversions as well as due to refunds on the advertiser side. Due to a limitation on Kochava Server to Server events API there is no way to delete, overwrite or fix data retroactively. From this reason, SOOMLA has to wait a few days for the advertising revenue to be finalized. The 3 day delay is a compromise between the need to post revenue as soon as possible and the need to have final revenue presented.
Question: What is the format of the event SOOMLA sends to Kochava
Answer: This is the event format:
{
"data": {
"device_ids": {
"idfa": <the user's iOS advertising identifier>,
"adid": <the user's Android advertising identifier>
},
"event_name": <the event name you choose>,
"origination_ip": <user's generic country ip>,
"event_data": {
"revenue": <the Ad Revenue>
}
},
"action": "event",
"kochava_app_id": <your app id>
}