Skip to main content
All CollectionsData SourcesAmazon
Amazon Sponsored Advertising Reports Connector (v3)
Amazon Sponsored Advertising Reports Connector (v3)
Openbridge Support avatar
Written by Openbridge Support
Updated today

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

  1. Profiles

    • Description: Brand profiles are used to look for brand data for an advertiser ID.

    • Path: amazon-ads/amzn_ads_profiles

Sponsored Brands

  1. Ad Groups

    • Description: Organize and manage ads within campaigns for Sponsored Brands.

    • Path: amazon-ads/amzn_ads_sb_adgroups

  2. Ads

    • Description: Custom ads to drive awareness and discovery of Sponsored Brands.

    • Path: amazon-ads/amzn_ads_sb_ads

  3. Campaigns

    • Description: Gain insights across placement types, identify campaigns for bid adjustments.

    • Path: amazon-ads/amzn_ads_sb_campaigns

  4. Gross and Invalids

    • Description: Campaign-level traffic metrics, including invalid impressions and clicks.

    • Path: amazon-ads/amzn_ads_sb_gross_and_invalids

  5. Placements

    • Description: Performance data by ad placement (e.g., Sponsored Brands campaigns).

    • Path: amazon-ads/amzn_ads_sb_placements

  6. Purchased Products

    • Description: Products purchased from Sponsored Brands campaign clicks.

    • Path: amazon-ads/amzn_ads_sb_purchased_products

  7. Search Terms

    • Description: Identify high-performing searches and refine targeting strategies.

    • Path: amazon-ads/amzn_ads_sb_search_terms

  8. Targeting

    • Description: Performance metrics for targeting expressions and keywords.

    • Path: amazon-ads/amzn_ads_sb_targeting

Sponsored Products

  1. Campaigns

    • Description: Campaign performance data for Sponsored Products.

    • Path: amazon-ads/amzn_ads_sp_campaigns

  2. Gross and Invalids

    • Description: Traffic metrics for Sponsored Products campaigns, including invalid clicks.

    • Path: amazon-ads/amzn_ads_sp_gross_and_invalids

  3. Purchased Products

    • Description: Data on non-advertised products bought after Sponsored Products clicks.

    • Path: amazon-ads/amzn_ads_sp_purchased_products

  4. Search Terms

    • Description: Search terms used by customers resulting in ad clicks.

    • Path: amazon-ads/amzn_ads_sp_search_terms

  5. Targeting

    • Description: Insights into the performance of keywords and match types.

    • Path: amazon-ads/amzn_ads_sp_targeting

Sponsored Display

  1. Ad Groups

    • Description: Manage Sponsored Display ad group performance and strategy.

    • Path: amazon-ads/amzn_ads_sd_adgroups

  2. Matched Target

    • Description: High-performing ASINs targeted in Sponsored Display campaigns.

    • Path: amazon-ads/amzn_ads_sd_adgroups_by_matched_target

  3. Advertised Product

    • Description: Sales and performance data for Sponsored Display advertised ASINs.

    • Path: amazon-ads/amzn_ads_sd_advertised_products

  4. Campaigns

    • Description: Summarize Sponsored Display campaign performance and placements.

    • Path: amazon-ads/amzn_ads_sd_campaigns

  5. Purchased Products

    • Description: Metrics for products purchased after Sponsored Display clicks.

    • Path: amazon-ads/amzn_ads_sd_purchased_products

  6. Targeting

    • Description: Performance insights into keyword and match-type targets for Sponsored Display.

    • Path: amazon-ads/amzn_ads_sd_targeting

  7. 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.

Did this answer your question?