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:
amzn_ads_profiles
amzn_ads_sb_adgroups
amzn_ads_sb_ads
amzn_ads_sb_campaigns
amzn_ads_sb_placements
amzn_ads_sb_purchased_products
amzn_ads_sb_search_terms
amzn_ads_sb_targeting
amzn_ads_sd_adgroups
amzn_ads_sd_adgroups_by_matched_target
amzn_ads_sd_advertised_products
amzn_ads_sd_campaigns
amzn_ads_sd_campaigns_by_matched_target
amzn_ads_sd_purchased_products
amzn_ads_sd_targeting
amzn_ads_sd_targeting_by_matched_target
amzn_ads_sp_advertised_products
amzn_ads_sp_campaigns
amzn_ads_sp_campaigns_by_adgroup
amzn_ads_sp_campaigns_by_placement
amzn_ads_sp_purchased_products
amzn_ads_sp_search_terms
amzn_ads_sp_targeting
( 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.