Adjust

Pipelining Data to Adjust

Configuring data pipelining is easy and requires no SDK updates or any other updates to the app code itself. Sending data to adjust requires copying and pasting 2 keys from the adjust 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 - Adjust API cannot accept adjustments to revenue per user backwards

Special Limitations

Adjust API will not allow revenue events to be sent with a date before the last revenue event. Therefore, if a user made an in-app-purchase and ad revenue event was sent for the day before it will be ignored.

Integration Steps

1. Click on one of your apps -> Click Integrations
   If your app is not live, you will be automatically redirected to Integrations page
2. Go to the “Data Pipelining” tab and click on Adjust logo
3. You will need to supply the event token in the SOOMLA dashboard. Let's create one in the Adjust dashboard:
   
   1. Go to Adjust dashboard
   2. Go to App Settings
   3. Click on Events
   4. Add a new one
   5. Copy the Event Token
4. Put the Event Token you just generated and the adjust App Token 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 Adjust

To see the data in Adjust follow these steps:

1. Click on the relevant app
2. Select “Cohorts” from the top left menu
3. To see ad revenue - you need to add the events to the view
1. Open the right panel by clicking on the filter symbol on the right
2. Find the parameter “base” and select “SoomlaAdRevenue” (note the actual event name is what you configured when you created the event token)
3. Go to the “KPI Selection” and check the “Total” checkbox under “Revenue”.
4. You will be able to see the ad-revenue broken down to channels and aggregated as a cohort with d1, d2, …, d30 ad revenue accumulation.

Once you verified the ad revenue shows up, you might want to see the ad revenue as part of the total revenue. To do that, simply go back to the regular configuration.

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 Adjust 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 adjust

Answer: This is the event format:

{
    app_token:   "<the app token from adjust dashboard>",
    event_token: "<the event token from adjust dashboard>",
    s2s:         1,
    created_at:  "<the day of the data>",
    revenue:     <the actual ad revenue>,
    currency:    "USD",
    environment: "production",
    idfa:        "<advertising identifier of the user>"
}