Amazon Ads

Sync overview

This source can sync data for the Amazon Advertising API.

Output schema

This source is capable of syncing the following streams:
All the reports are generated for day before relatively to target profile' timezone

Data type mapping

Integration Type
Airbyte Type
Notes
string
string
int, float, number
number
date
date
datetime
datetime
array
array
object
object

Features

Feature
Supported?(Yes/No)
Notes
Full Refresh Sync
yes
Incremental Sync
yes
Namespaces
No

Performance considerations

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

Getting started

Requirements

    client_id
    client_secret
    refresh_token
    scope
    profiles
    region
    start_date (optional)
More how to get client_id and client_secret you can find on AWS docs.
Refresh token is generated according to standard AWS Oauth 2.0 flow
Scope usually has "advertising::campaign_management" value, but customers may need to set scope to "cpc_advertising:campaign_management",
Start date 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 date is used. Date for specific profile is calculated according to its timezone, this parameter should be specified in UTC timezone. Since it have no sense of generate report for current day (metrics could be changed) it generates report for day before (e.g. if start_date is 2021-10-11 it would use 20211010 as reportDate parameter for request).

CHANGELOG

Version
Date
Pull Request
Subject
0.1.2
2021-10-01
#6367
Add option to pull data for different regions. Add option to choose profiles we want to pull data. Add lookback
0.1.1
2021-09-22
#6367
Add seller and vendor filters to profiles stream
0.1.0
2021-08-13
#5023
Initial version
Last modified 25d ago