The Amazon Ads API provides several reporting data feeds to help advertisers understand and optimize their campaign performance. Amazon Sponsored Advertising (V3) report types Amazon Ads Reporting API for the above report types.
Important: Amazon has significantly changed the V3 and V2 reporting APIs. Please see Amazon Advertising: Reporting API V2 to V3 Migration for information about this migration and the potential impacts on reports, metrics, and how Amazon is rolling out these changes.
The following Amazon Sponsored Advertising (V3) report types are included:
Profiles
Profiles
Description: Brand profiles are used to look for brand data for an advertiser ID.
Path:
amazon-ads/amzn_ads_profiles
Sponsored Brands
Ad Groups
Description: Organize and manage ads within campaigns for Sponsored Brands.
Path:
amazon-ads/amzn_ads_sb_adgroups
Ads
Description: Custom ads to drive awareness and discovery of Sponsored Brands.
Path:
amazon-ads/amzn_ads_sb_ads
Campaigns
Description: Gain insights across placement types, identify campaigns for bid adjustments.
Path:
amazon-ads/amzn_ads_sb_campaigns
Gross and Invalids
Description: Campaign-level traffic metrics, including invalid impressions and clicks.
Path:
amazon-ads/amzn_ads_sb_gross_and_invalids
Placements
Description: Performance data by ad placement (e.g., Sponsored Brands campaigns).
Path:
amazon-ads/amzn_ads_sb_placements
Purchased Products
Description: Products purchased from Sponsored Brands campaign clicks.
Path:
amazon-ads/amzn_ads_sb_purchased_products
Search Terms
Description: Identify high-performing searches and refine targeting strategies.
Path:
amazon-ads/amzn_ads_sb_search_terms
Targeting
Description: Performance metrics for targeting expressions and keywords.
Path:
amazon-ads/amzn_ads_sb_targeting
Sponsored Products
Campaigns
Description: Campaign performance data for Sponsored Products.
Path:
amazon-ads/amzn_ads_sp_campaigns
Gross and Invalids
Description: Traffic metrics for Sponsored Products campaigns, including invalid clicks.
Path:
amazon-ads/amzn_ads_sp_gross_and_invalids
Purchased Products
Description: Data on non-advertised products bought after Sponsored Products clicks.
Path:
amazon-ads/amzn_ads_sp_purchased_products
Search Terms
Description: Search terms used by customers resulting in ad clicks.
Path:
amazon-ads/amzn_ads_sp_search_terms
Targeting
Description: Insights into the performance of keywords and match types.
Path:
amazon-ads/amzn_ads_sp_targeting
Sponsored Display
Ad Groups
Description: Manage Sponsored Display ad group performance and strategy.
Path:
amazon-ads/amzn_ads_sd_adgroups
Matched Target
Description: High-performing ASINs targeted in Sponsored Display campaigns.
Path:
amazon-ads/amzn_ads_sd_adgroups_by_matched_target
Advertised Product
Description: Sales and performance data for Sponsored Display advertised ASINs.
Path:
amazon-ads/amzn_ads_sd_advertised_products
Campaigns
Description: Summarize Sponsored Display campaign performance and placements.
Path:
amazon-ads/amzn_ads_sd_campaigns
Purchased Products
Description: Metrics for products purchased after Sponsored Display clicks.
Path:
amazon-ads/amzn_ads_sd_purchased_products
Targeting
Description: Performance insights into keyword and match-type targets for Sponsored Display.
Path:
amazon-ads/amzn_ads_sd_targeting
Gross and Invalids
Description: Invalid clicks and impressions in Sponsored Display campaigns.
Path:
amazon-ads/amzn_ads_sd_gross_and_invalids
( Note: The Sponsored Ad type is defined in the name of the data feed. _sp_ = Sponsored Products, _sb_ = Sponsored Brands, _sd_ = Sponsored Display). The reports are provided at a DAILY interval as defined and made available by Amazon.
Impressions, costs, and clicks data from sponsored ads campaigns are typically available using the API within 24 hours. However, data may fluctuate significantly for 48-72 hours from the current date. Why? Amazon validates every click to make sure advertisers are not charged unnecessarily. This validation process can take up to three days; during this period, fluctuation in performance data will occur.
LOOKBACKS
Per Amazon, performance data can be back-updated. For example, if today is 9/30, Amazon may back update the 9/2 report date.
"Initial conversion data is available within 24 hours but may change as part of the restatement process. Restatements of conversion data occur 1, 7, and 28 days after the conversion event. Because conversions are reported on the date of the ad interaction, restatement includes all dates in your attribution window. For example, if your attribution window is 14 days, restatement can update attribution up to 42 days (14 plus 28) after the report date."
Each day, Openbridge will collect data on a rolling 60-day window. The collection window looks back 1, 3, 7, 14, 30, and 59 days in the past. For example, on July 1, we will collect data for June 30th, 28th, 25th, 18th, and so forth. The LOOKBACK timing aligns with observed time periods where Amazon will settle data in its systems.
We execute this rolling LOOKBACK window daily to follow Amazon's attribution and sync patterns. This also ensures we are not over-saturating the Amazon API and hitting API limits. There are many reports, and Amazon limits the volume of requests. Amazon also can take a while to deliver a report after a request, sometimes over an hour per report.