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.
amzn_stream_adgroups
amzn_stream_ads
amzn_stream_budget_usage
amzn_stream_campaigns
amzn_stream_sb_clickstream
amzn_stream_sb_conversion
amzn_stream_sb_rich_media
amzn_stream_sb_traffic
amzn_stream_sd_conversion
amzn_stream_sd_traffic
amzn_stream_sp_conversion
amzn_stream_sp_traffic
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 |