Available with Version | 2.169 and up |
|---|---|
Role | System Administrator |
External Systems | Amazon DSP Pilot |
| Table of Contents | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|
|
Challenge
Are you looking for a powerful platform that allows you to advertise online, customize your ad campaigns, control your budget, target potential customers, and evaluate the performance of your ads without being constrained by a minimum spending requirementforward 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 Pilot". Here are the steps you should follow:
1. Create an Amazon DSP Connection
In the ADvendio main menu (App launcher), search for navigate to "Connections".Click on the
Select "Connections" tab.Create New" to create a new connection record by selecting "New"Amazon DSP connection.
Choose "AMAZONDSP" as the new record type.
...
It will open the "New Connection: AMAZONDSP" window.
Enter your username in the required "User Name" field.
Use If necessary, provide any additional information in the Description and Access Token fields to add any additional information if necessary.
Tick “Active” the "Active" checkbox to activate this connection.
Click on the "Save" button.
A new connection record for Amazon DSP Pilot will be created.
...
2- Generate an OAuth token to complete the connection process
To generate an OAuth token, follow these steps:
Open the new Connection record you just created
In the right upper corner Click “Generate AdServer OAuth Token”
...
Enter your Amazon DSP username
You will see “Link to Ad Server” opposite “Generate Authorization Code”, proceed with that to
...
Log into Amazon DSP Pilot, Log in to Amazon DSP Pilot and authenticate.
Copy the token code from Amazon DSP and paste it in the ADvendio field.
...
click the Submit button in Advendio Connections to finish the process.
...
Amazon Connection Fields values and Description
Possible field values and explanation when creating a an Amazon DSP Pilot connection:
Field value | Description | Possible Values | |||||
|---|---|---|---|---|---|---|---|
User name | Enter the user name you use to login to Amazon DSP Pilot | ||||||
Additional Password | The OAuth token code will be stored here | ||||||
This is a developer token belonging to the Amazon DSP Pilot manager account. It can be found in Amazon DSP tools and settings - API centre - API Access
| Record Type: Amazon DSP 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) | |||||
Record Type: AMAZONDSP | “Amazon DSP” record type is shown by default as it’s been previously selected in the set-up processNetwork ID | ||||||
Enter the Network ID relevant to this login.
| Active |
| |||||
Description | You can enter additional text to describe the login record |
4- Data to import from Amazon DSP Pilot
After obtaining the authentication token and establishing a connection with Amazon DSP, we highly recommend using the "Transfer to ADvendio" feature. Importing Amazon DSP Pilot data into ADvendio will allow seamless media advertising and buying activities.
...
By using this feature you can select the information you want to import into ADvendio:
| Tip |
|---|
We would recommend importing the following information from the platform:
|
| Info |
|---|
This can be implemented at a later stage but is recommended to perform sooner to have the access to all capacities of the feature. |
5- Advertiser Account Mapping for Salesforce and Amazon DSP Integration
To connect Salesforce accounts with Amazon DSP, it's important to perform Advertiser Account Mapping.
For a detailed guide on how to map these accounts, refer to Chapter 2.1.4.5 How ADvendio matches your Salesforce Accounts with Advertisers, Agencies or Buyers in an external System?
Setup
| Info |
|---|
For advice on permissions and rights to use ADvendio Connect refer to 7.3.17 Which permissions and rights are needed for a user to access ADvendio Connect and the integration of third-party systems? |
For a smooth Amazon DSP integration with ADvendio it is recommended to perform the previously described steps:
...
Create Amazon DSP Connection with ADvendio
...
Import data from the Amazon DSP platform
...
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 |
|---|---|
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.