Overview

Amazon DSP is a demand-side platform that allows advertisers to programmatically buy display and video ads at scale. Connect Lytics with Amazon DSP to leverage the behavioral scoring, content affinities, and Insights from Lytics to improve your targeting for Amazon ads.

Authorization

If you have not already done so, you will need to set up an Amazon Advertising account before you begin the process described below. Authorizing as an Amazon Advertising user will guide you through an OAuth process to authorize access to ad accounts tied to that particular Amazon Advertising user.

If you are new to creating authorizations in Lytics, see the Authorizations documentation for more information.

Select Amazon DSP from the list of providers.
Select the method for authorization. Note that different methods may support different job types. Amazon DSP supports the following authorization methods:
- Login with Amazon - US
- Login with Amazon - EU
Enter a Label to identify your authorization.
(Optional) Enter a Description for further context on your authorization.
Complete the configuration steps needed for your authorization. These steps will vary by method.
Click Save Authorization.

Login with Amazon - US

Enter your Amazon DSP login credentials in the login popup.
In the Label text box, enter a name for the authorization
(optional) In the Description text box, enter a description for this authorization

Login with Amazon - EU

Enter your Amazon DSP login credentials in the login popup.
In the Label text box, enter a name for the authorization
(optional) In the Description text box, enter a description for this authorization

Amazon Ads: Export Audience

Send Lytics user profiles to Amazon Ads to reach and connect with your customers.

Integration Details

Implementation Type: Client-side Integrations and Server-side Integration
Implementation Technique: JavaScript Tag Integration, REST API Integration, Audience Trigger Integration
Frequency: Real-time Integration
Resulting data: A Lytics audience is exported to Amazon Ads Audience.

This workflow uses the Amazon Ads API to create an audience in the Amazon Ads platform and uploads the Lytics user profiles for matching.

Once the job is created, the job will:

Create an Amazon ads audience for the configured Lytics audience with name format: lytics_{audience_slug}_{current_timestamp}.
Runs the backfill of the audience (if configured) and adds the users in Amazon ads audience.
For each user entering the audience, it will add them in the queue to add them in the Amazon ads audience.
For each user exiting the audience, it will add them in the queue to remove them from the Amazon ads audience.
The queue will be sent to Amazon ads every minute or when the queue reaches 10,000 users.
The job will run continuously repeating steps (3)-(5).

Fields

The export job gives you an option to send following fields to Amazon Ads:

Lytics User Field (configurable)	Description	Amazon Ads PII Field	Type
email	Email Address	Email	string
first_name	First Name	firstname	string
last_name	Last Name	lastname	string
address	Address	address	string
phone	Phone Number	phone	string
city	City	city	string
postal_code	Postal Code	postal	string
state	State	state	string

Configuration

Follow these steps to set up and configure an export to Amazon DSP from Lytics.

Select Amazon DSP from the list of providers.
Select Amazon Ads: Export Audience from the list.
Select the Authorization you would like to use or create a new one.
Enter a Label to identify this job you are creating in Lytics.
(Optional) Enter a Description for further context on your job.
Select the Lytics audience to export.
From the Profile ID input, select the Amazon DSP Profile/region you wish to export to.
In the Advertiser ID text box, enter your Amazon Ads Advertiser ID.
From the Identifier Mappings input, map the value from Lytics field to Amazon Ads PII field. At least one PII field must be mapped. We will hash the field if required according to Amazon's requirements.
From the Country Code input, select the 2 letter country code where the users belong to. This is used to normalize the phone number and address according to Amazon's hashing requirements.
(Optional) Check the Existing Users to immediately send users who currently exist in the selected Lytics audience. Deselecting will only push users as they enter or leave the audience.
Click the Complete button to start the job

Amazon DSP: Sync Cookies/Email

Send Lytics user profiles to Amazon DSP to reach and connect with your customers.

Integration Details
Fields
Configuration

Integration Details

Implementation Type: Client-side Integrations and Server-side Integration
Implementation Technique: JavaScript Tag Integration, REST API Integration, Audience Trigger Integration
Frequency: Real-time Integration
Resulting data: A Lytics audience is exported to Amazon DSP

This workflow uses the Amazon DSP API to create an audience in the Amazon Ads platform and uploads the Lytics user profiles for matching.

Once the job is created, the job will:

Create an Amazon ads audience for the configured Lytics audience with name format: lytics{audience_slug}{current_timestamp}.

Fields

Configuration

Follow these steps to set up and configure an export job for Amazon DSP in the Lytics platform. If you are new to creating jobs in Lytics, see the Jobs Dashboard documentation for more information.

Select Amazon DSP from the list of providers.
Select the export job type from the list.
Select the Authorization you would like to use or create a new one.
Enter a Label to identify this job you are creating in Lytics.
(Optional) Enter a Description for further context on your job.
Select the Lytics audience to export.
From the Profile ID input, select the Amazon DSP Profile/region you wish to export to.
(optional) In the Advertiser ID text box, enter your Amazon DSP Advertiser ID.
(optional) From the Match Method input, select select the match method that was used for this audience. Select Cookie for audiences that have been synced via the JSTAG cookie sync, or Hashed Emails for audiences that have been synced via the Upload Hashed Identifers workflow.
(optional) From the Email Field input, select select the field name that contains the user's email. One of either Email Field or Hashed Email Field is required if Match Method is set to Hashed Emails, and should match the field used in the Upload Hashed Identifiers job.
(optional) From the Hashed Email Field input, select select the field name that contains the user's email, SHA 256 hashed. Make sure to trim whitespace from input email addresses and format them lowercase, with no accents or special characters, per the Amazon documentation. One of either Email Field or Hashed Email Field is required if Match Method is set to Hashed Emails, and should match the field used in the Upload Hashed Identifiers job.
(optional) From the Country Codes input, select select the 2 letter country codes where users in the audience live.
(optional) Select the Existing Users checkbox, to select this to immediately push users who currently exist in the selected Lytics audience. Deselecting will only push users as they leave or enter the audience.
Click the Complete button to start the job.