Skip to main content

Amazon Ads

This page contains the setup guide and reference information for Amazon Ads.

Prerequisites

  • Amazon Ads account login (username and password)
  • Region

Setup guide

Step 1: Set up Amazon Ads

Create an Amazon user with access to Amazon Ads account.

Step 2: Set up the Amazon Ads data source in Daspire

  1. Select Amazon Ads from the Source list.

  2. Enter a Source Name.

  3. Authenticate your Amazon Ads account.

  4. Select Region to pull data from North America (NA), Europe (EU) or Far East (FE). See Amazon docs for more details.

  5. Report Wait Timeout is the maximum number of minutes the connector waits for the generation of a report for streams.

  6. Report Generation Maximum Retries is the maximum number of attempts the connector tries to generate a report for streams.

  7. Start Date (optional) is used for generating reports starting from the specified start date. Should be in YYYY-MM-DD format and not more than 60 days in the past. If not specified today's date is used. The date for a specific profile is calculated according to its timezone, this parameter should be specified in the UTC timezone. Since it doesn't make sense to generate reports for the current day (metrics could be changed), it generates reports for the day before (e.g. if Start Date is 2022-10-11 it would use 20221010 as reportDate parameter for request).

  8. Profile IDs (optional) you want to fetch data for. See Amazon docs for more details.

  9. Attribution Window (optional) is the number of days after the click date that the click is considered to be eligible for attribution. Attribution is the measurement of conversion events, or customer behaviors that occur following an ad interaction. These behaviors measure the success of an ad campaign based on advertiser goals. Learn more.

  10. Click Save & Test.

Supported sync modes

The Amazon Ads data source supports the following sync modes:

  • Full Refresh
  • Incremental

Supported streams

This source is capable of syncing the following streams:

Specific features and highlights

All the reports are generated for the day before relatively to the target profile' timezone.

Performance considerations

Information about expected report generation waiting time you may find here.

Troubleshooting

Max number of tables that can be synced at a time is 6,000. We advise you to adjust your settings if it fails to fetch schema due to max number of tables reached.

Data type mapping

Integration TypeDaspire Type
stringstring
int, float, numbernumber
datedate
datetimedatetime
arrayarray
objectobject