All Collections
Data Sources
Amazon
Amazon Marketing Stream Connector
Amazon Marketing Stream Connector
Openbridge Support avatar
Written by Openbridge Support
Updated over a week ago

Ensure Eligibility

Amazon's Marketing Stream is limited to brands, agencies, and direct advertisers. If you fall into these categories, you can proceed with the setup process [1].

Getting Started

Amazon Marketing Stream (AMS) works differently than all other Amazon Ads services. Amazon requires that Marketing Stream events are sent to an Amazon Web Services SQS (Simple Queue Service) endpoint. This endpoint is where Openbridge will process your campaign data sets [1] and load them to your configured data destination.

IMPORTANT: To set up AMS, you must complete the activation step on AWS. We have simplified and automated this process for you. See our guide to get this first step completed.

Supported Datasets

Amazon Marketing Stream supports datasets that offer different performance metrics and campaign metadata. Below are the Openbridge-supported datasets.

  1. amzn_stream_adgroups

  2. amzn_stream_ads

  3. amzn_stream_budget_usage

  4. amzn_stream_campaigns

  5. amzn_stream_sb_clickstream

  6. amzn_stream_sb_conversion

  7. amzn_stream_sb_rich_media

  8. amzn_stream_sb_traffic

  9. amzn_stream_sd_conversion

  10. amzn_stream_sd_traffic

  11. amzn_stream_sp_conversion

  12. amzn_stream_sp_traffic

  13. amzn_stream_targets

Reporting Data

Amazon Marketing Stream reporting includes an advertiser’s processed (non-raw, summarized) performance data, including traffic and conversions, sent hourly, and data dimensions necessary for analytics.

Messaging data

Amazon Marketing Stream messaging sends notifications on entity state changes and other events in near real-time. Currently, this messaging includes budget consumption and will notify you whenever your budget allotment changes by 5% or more.

Timing

Amazon Marketing Stream delivers data aggregated at the hourly level. Any changes to your data due to the click or conversion invalidation process are sent separately as deltas.

Since Amazon Marketing Stream delivers an advertiser-owned AWS destination in near real-time, Openbridge is not requesting data from an API. Amazon is "pushing" data streams to you. As a result, there are no historical data requests. This means Openbridge can not request data for a date in the past. We only can process what Amazon has "pushed" to SQS for processing.

Data Freshness

Sponsored Products

Initial click data is available within 12 hours of the ad click. As part of the traffic validation process, clicks can be invalidated within 72 hours post the initial report. Amazon Marketing Stream will automatically deliver any adjustments to your queue. Data will be delivered to your queue in a burst every hour. It is not necessarily at the top of the hour but once per hour.

Sponsored Products Conversions

Conversions for Sponsored product campaigns are reported based on the hour when the click they are attributed to occurred. Conversion data is reported daily, weekly, and monthly, and you should expect to receive revisions to conversion data up to sixty days after the initial click. Data will be delivered to your queue in a burst every hour. It is not necessarily at the top of the hour but once per hour.

Sponsored ads budget usage

Amazon Marketing Stream pushes budget usage updates in near real-time. You should receive a notification soon after your budget usage increases by 5%. Due to Amazon’s traffic validation process, you may receive the same notification twice. For example, invalidating a click may reduce your budget usage under the 5% threshold.

Sponosred Display Traffic

Initial click data is available within 12 hours of the ad click. As part of the traffic validation process, clicks can be invalidated within 72 hours post the initial report. Amazon Marketing Stream will automatically deliver any adjustments to your queue.

Sponsored Display Conversions

Conversions for Sponsored Display campaigns are reported based on the hour when the click they are attributed to occurred. Conversion data is reported daily, weekly, and monthly, and you should expect to receive revisions to conversion data up to sixty days after the initial click.

Campaign, AdGroup, Ads, and Targets

A notification in near real-time for every change in the configuration is sent. It is important to note that only changes/updates are sent. As a result, these datasets will not reflect the total of all campaigns, ads, ad groups, or targets, only those that had an update.

How To Query

See Amazon sample queries to provide starting points for using your data.

Limitations

Amazon Marketing Stream is currently in open beta, and we are planning to add more features as we continue working with partners and advertisers to gather feedback. Some high-level limitations at this stage include:

  • Campaign type: Conversion and traffic data available for Sponsored Products and Sponsored Displays only.

  • Region: Sponsored Products and Sponsored Display data are available in all marketplaces supported by the Amazon Ads API. Budget usage data is available in all marketplaces except India.

  • Data type: Available for advertising data only. Retail data is not available in Amazon Marketing Stream.

  • Queues: Amazon Marketing Stream only allows simple SQS. FIFO Queues are not supported.

Availability

Amazon Marketing Stream is available for advertisers worldwide. The marketplace of the advertiser determines which AWS region you should use when creating queues and subscribing to datasets. Use the table below to understand the countries supported and which API endpoint and AWS region to use for each.

Marketplace

Region

API endpoint

AWS region

United Arab Emirates (AE), Germany (DE), Egypt (EG), Spain (ES), France (FR), Belgium (BE), United Kingdom (UK), India (IN), Italy (IT), Netherlands (NL), Poland (PL), Saudi Arabia (SA), Sweden (SE), Turkey (TR)

EU

eu-west-1

Brazil (BR), United States (US), Canada (CA), Mexico (MX)

NA

us-east-1

Singapore (SG), Australia (AU), Japan (JP)

FE

us-west-2


Did this answer your question?