Two kinds of data are stored: performance, which is one row per item per day, and structure, which is the account as it is now.
Performance
Daily reports from the Amazon Ads API. Each tool reads the report at its level.
| Data | Tool | Sponsored Products | Sponsored Brands | Sponsored Display |
|---|---|---|---|---|
| Campaigns | get_campaigns | yes | yes | yes |
| Ad groups | get_ad_groups | yes | yes | yes |
| Keywords and targets | get_keywords | yes | yes | yes |
| Search terms | get_search_terms | yes | yes | no |
| Placements | get_placements | yes | yes | no |
| Advertised products | get_products | yes | no | yes |
| Ads | get_ads | no | yes | no |
| Purchased products | get_purchased_products | yes | yes | yes |
| Matched targets | get_matched_targets | no | no | yes |
| Invalid traffic | get_invalid_traffic | yes | yes | yes |
Where the table says no, Amazon has no such report.
How far back
Amazon keeps each report for a limited time, so that is as far as a first download can reach:
| Ad type | Amazon keeps |
|---|---|
| Sponsored Products | 95 days (search terms: 65 days) |
| Sponsored Brands | 60 days |
| Sponsored Display | 65 days |
From the day a marketplace is on your plan, its days are kept, so the history grows past these limits over time. list_accounts always tells you the first and last day available for each marketplace.
Recent days change
Amazon revises its own figures after the fact. Clicks and impressions can change for about 3 days. Sales and orders are credited to the day of the click, so they keep arriving: Amazon restates them 1, 7 and 28 days later. The last few days of any period are therefore lower than they will end up.
Structure
get_structure returns the account as it was at the last download:
| Type | Sponsored Products | Sponsored Brands | Sponsored Display |
|---|---|---|---|
campaign | yes | yes | yes |
ad_group | yes | yes | yes |
keyword | yes | yes | no |
target | yes | yes | yes |
negatives | ad group and campaign level | ad group level | ad group level |
product_ad | yes | no | yes |
ad | no | yes | no |
portfolio | all ad types |
Paused and archived items are included.
Product history
Amazon reports a product's best-seller rank only as it is today. Adverso records it once a day, together with price and availability, and get_product_history returns the days it has. The record starts on the day a marketplace is connected; earlier days cannot be recovered.
Every field
The tables above say which reports exist. All fields lists every field inside them, with its meaning.
Products
For every product that appears in the ads data, Adverso stores what the Amazon Ads API knows about it: title, main image, brand, category, best-seller rank, price, availability and whether it can be advertised. See product.
Not included yet
These are planned. Their tools are listed in Read and write.
- Hourly data.
- Total and organic sales per product, from Seller Central or Vendor Central.
- Amazon's budget recommendations.
Not included
- Amazon DSP.
- Amazon Marketing Cloud.