CTV-CTV server-to-server setup for SAN partners

With Adjust's CTV-CTV SAN integrations, you can measure the impact of campaigns you run on self-attributing networks that drive installs of your connected TV (CTV) app.

Here, you can find information about how to connect Adjust to your SAN network partner, and send data server-to-server (S2S).

Before you begin

The following CTV-CTV partners act as self-attributing networks and require server-to-server setup:

  • Amazon Fire TV
  • Roku Endemic Media
  • Vizio

Integration details

Adjust's S2S integration with self-attributing networks cannot be used in conjunction with the Adjust SDK.

Adjust sends self-attributing networks data for all of your app's installs and the SAN self-attributes using their own engagement data. Adjust then checks this data to confirm the source of the last engagement.

Growth solution:
CTV-CTV measurement is only available if you have CTV AdVision on your account. Reach out to your Adjust representative for more information.

1. Add your CTV app

To measure any campaign for your CTV app, you need to first add the app to the Adjust dashboard.

Follow our guide to CTV app setup for detailed instructions on this step.

2. Network setup

When you activate the integration in the Adjust dashboard, Adjust immediately begins to forward activity data to the network for attribution.

To activate the integration, follow these steps in the Adjust dashboard:

  1. Under Campaign Lab, select Partners.
  2. Select New partner.
  3. In the Partner selection screen, choose your network and select Next.
  4. In the App selection screen, choose your app, and select Next.

Then, follow the steps below to set your data sharing options. Once this is done, review your setup and enable the network for your app.

Enable data sharing

Share data with networks to optimize your campaigns. In the Data sharing screen, you need to provide network-specific credentials to enable Adjust to start sharing data. Find out more about the credentials required for each network and your sharing options below.

Amazon Fire
Roku
Vizio
  • Amazon App ID: You can find your App ID in your Amazon Developer Console. Following Amazon's instructions, navigate to Security Profile Management, select the Web Settings tab, and copy the App ID from the full Client ID.
    • Client ID example: amzn1.devportal.mobileapp.1234a5b67c8901d2e3456789012f3456
    • App ID example: 1234a5b67c8901d2e3456789012f3456

Once you enable data sharing, Adjust sends install and reattribution data from all attribution sources, by default. This includes data attributed to Amazon Fire, data attributed to other networks, and organic data. Additionally, you can choose to share the following data with Amazon Fire:

  • Sessions
  • Events

Map events

Under each Adjust-recorded in-app event you will see a field with a drop-down menu. Use the dropdown menu to select a predefined network event that maps to your Adjust event. Custom events cannot be sent.

Amazon Fire
Roku
Vizio
  • Add to cart
  • Ad start
  • Ad finish
  • App engagement
  • App open
  • Banner interaction
  • Cable authentication
  • Email interaction
  • Email load
  • Game interaction
  • Game load
  • In App refferal
  • Install
  • Level achieved
  • Marketing landing page
  • Other
  • Product purchased
  • Purchase button
  • Subscription button
  • Subscription page
  • Subscription restart
  • Subscription start
  • Survey start
  • Survey finish
  • Trial sign up page
  • Trial start
  • Video start
  • Video finish
  • Widget interaction
  • Widget load

3. Server-to-server integration

Warning:
Adjust needs to enable this feature for you. Contact your Technical Account Manager or support@adjust.com to proceed.

With the network set up in the Adjust dashboard, you can now set up server-to server integration with Adjust. This means you only send Adjust in-app session and event data through S2S API calls.

Supported device identifiers

IDID TypeFormat
Amazon FireFIRE_ADIDRaw Amazon Fire advertising IDLowercase, with hyphens
Roku and VizioIDFARaw Apple advertising IDUppercase, with hyphens
GPS_ADIDRaw Google advertising IDLowercase, with hyphens
FIRE_ADIDRaw Amazon Fire advertising IDLowercase, with hyphens
WIN_ADIDRaw Windows advertising IDWithout hyphens
RIDARaw Vizio advertising ID 
  • Users on Vizio devices can reset it at any time or disable it to avoid targeted advertising
Lowercase, with hyphens
OAIDRaw Huawei advertising IDLowercase, with hyphens

Requirements

  • For details on the requirements for your in-app solution, refer to Adjust's server-to-server attribution checklist.
  • All requests to Adjust servers must be made in the same sequential order they occur on the device.
  • Always include the os_name in your request. This can be:
    • android
    • ios
    • fire-tv
    • roku-os
    • tizen
    • smart-cast

Send sessions

Sessions are the base of all attribution and measurement in Adjust. They trigger when a user resumes using an app from the background or when they open the app.

To send Adjust sessions, use our S2S sessions API.

Endpoint: https://s2s.adjust.com/session

Send in-app events

To send Adjust in-app event data, use our S2S events API.

Endpoint: https://s2s.adjust.com/event

4. Export your data

Reporting structure

Amazon Fire
Roku
Vizio
  • Network = Amazon
  • Campaign = campaign_name
  • Adgroup = ad_name
  • Creative = creative_id

To get device-level data sent to your BI system for analysis, set up raw data exports.

Placeholders

You can use the following placeholders to get specific network datapoints in your raw data exports.

Amazon Fire
Roku
Vizio
PlaceholderDescription
{fire_adid}Fire OS advertising identifier

Data not shared from Amazon campaigns

As per our legal agreement with Amazon, Adjust does not provide raw Amazon campaign data on certain activities. This includes data exported via both server callbacks and cloud storage upload. The impacted activities are:

  • Clicks
  • Impressions
  • SAN clicks
  • SAN impressions

The following services are not affected:

  • Adjust’s ability to measure clicks, impressions, SAN clicks, and SAN impressions.
  • Reporting of aggregated clicks and impressions.
  • Pulling aggregated click and impression data via our Report service.
  • Reporting and export of install and post-install raw and aggregated data attributed to Amazon Fire.

If you have any questions, please contact your Amazon representative.