Track CTV app campaigns on Amazon Fire TV

With Adjust's Amazon SAN integration, you can measure the impact of campaigns you run on Amazon Fire TVs that drive installs of your connected TV (CTV) app.

Here, you can find information about how to connect Adjust to Amazon in the Adjust dashboard, and send Adjust data server-to-server (S2S).

Before you begin

Requirement

  • An Amazon App ID
    • This is 32 characters long and only includes numbers and lowercase letters.

Integration details

Adjust's S2S integration with Amazon cannot be used in conjunction with the Adjust SDK.

Amazon is a self-attributing network. This means that Adjust sends Amazon data for all of your app's installs and Amazon self-attributes using their own engagement data. Adjust then checks this data to confirm the source of the last engagement.

Supported device identifier

IDID TypeFormat
FIRE_ADIDRaw Amazon Fire advertising IDLowercase, with hyphens

View your Amazon campaign data in Adjust

Here's how Amazon campaign data is reported in Adjust:

  • Network = Amazon
  • Campaign = campaign_name
  • Adgroup = ad_name
  • Creative = creative_id

Dashboard setup

When you activate the Amazon module integration, Adjust immediately begins to forward activity data to Amazon for attribution.

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

  1. Find your app and select your app options caret (^).
  2. Select Partner Setup.
  3. Select ADD PARTNERS and select Add (+ icon) beside Amazon Fire.
  4. Enter your Amazon App ID.
  5. Select SAVE.

Adjust will now send Amazon callbacks for the following activites:

  • Installs
  • In-app events

Manage event linking

To link your Adjust events to Amazon events, follow these steps:

  1. Find your app and select your app options caret (^).
  2. Select Partner Setup.
  3. Enter Amazon Fire.
  4. Select Event Linking.

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

  • 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
  1. Select SAVE.

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 Amazon module enabled 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.

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
    • vizio

Send sessions

Sessions are the base of all attribution and tracking 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

Export your data

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 Amazon datapoints in your raw data exports.

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 callbacks and CSV 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 KPI 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.