4.6 KiB
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:
- Profiles
- Sponsored Brands Campaigns
- Sponsored Brands Ad groups
- Sponsored Brands Keywords
- Sponsored Display Campaigns
- Sponsored Display Ad groups
- Sponsored Display Product Ads
- Sponsored Display Targetings
- Sponsored Products Campaigns
- Sponsored Products Ad groups
- Sponsored Products Keywords
- Sponsored Products Negative keywords
- Sponsored Products Ads
- Sponsored Products Targetings
- Brands Reports
- Brand Video Reports
- Display Reports
- Products Reports
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 |