[Set up connection] in Amazon DSP Pilot

Available with Version

2.169 and up

Available with Version

2.169 and up

Role

System Administrator

External Systems

Amazon DSP Pilot

Challenge

Are you looking forward to setting up the Amazon DSP Pilot integration so that you can receive reporting data from your Advertising Campaigns directly into ADvendio to keep track of your budget and incorporate this information into ADvendio's invoicing system?

Solution

In order to set up the ADvendio Amazon DSP Connection and smoothly manage media buying activities between ADvendio and Amazon DSP, you should follow these steps.

To begin using the Amazon DSP Pilot integration, you need to create a new record type called "Amazon DSP". Here are the steps you should follow:

1. Create an Amazon DSP Connection

  • In the ADvendio main menu (App launcher), navigate to "Connections"

  • Select "New" to create a new Amazon DSP connection.

  • Choose "AMAZONDSP" as the new record type.

  • It will open the "New Connection: AMAZONDSP" window.

  • Enter your username in the "User Name" field.

  • If necessary, provide any additional information in the Description and Access Token fields

  • Tick the "Active" checkbox to activate this connection.

  • Click on the "Save" button.

  • A new connection record for Amazon DSP Pilot will be created.

Bildschirmfoto 2024-02-26 um 10.17.09.png
Creation of an Amazon DSP Connection Record in ADvendio
Amazon Connection Fields values and Description

Possible field values and explanation when creating an Amazon DSP Pilot connection:

Field value

Description

Possible Values

Field value

Description

Possible Values

User name

Enter the user name you use to login to Amazon DSP Pilot

 

Access Token

 

Generate in your connection via the “Generate AdServer OAuth Token” button

 

Additional Username

 

 

Network ID

Defines which Market to use with Amazon DSP. There is a set of predefined choices, by Amazon. Please set a country code, according to the possible values listed here.

For example if you are operating on the US-American market as an agency, you enter ‘US’

If you are planning to operate on multiple markets in Amazon, you will need to create dedicated Connection Records for each one.

countryCode (string)
Possible values: "BR" "CA" "MX" "US" "AE" "BE" "DE" "EG" "ES" "FR" "IN" "IT" "NL" "PL" "SA" "SE" "TR" "UK" "AU" "JP" "SG"

Record Type: AMAZONDSP

“Amazon DSP” record type is shown by default as it’s been previously selected in the set-up process

 

Active

Tick this box to activate the AdServer connection

 

Description

You can enter additional text to describe the login record

 

 

2. Amazon Check Login / Authentication

Creating an Amazon connection with a username and generating a token will allow you to log into your Amazon account.

Connection Value

Description

Connection Value

Description

Username:

Username of your Amazon Account used for the Ads Management

Access Token:

API Token received by Amazon

To generate an OAuth token, follow these steps:

  • Open the Amazon DSP Connection record you just created

  • Click "Generate AdServer OAuth Token" in the upper right corner

 

  • Enter your username and press Submit

  • Press “Link to Ad Server”, this will open the ADvendio Connector in order to generate an access token, based on your user credentials:

  • Log into Amazon, and Copy the token authorization code provided

 

  • Paste your Amazon OAuth token code from authorisation and paste it to the ADvendio Authorisation Code field

  • Press Submit.