Amazon Sponsored Brand Ads

Amazon Sponsored Brand Ads ETL connector for data replication

Last updated 10 months ago

Snapshot

Tables/APIs Supported

Reports Mapping

The following table represents how Daton maps tables with respect to the reports you see in the Amazon Ad console interface.

Authentication Credentials

Sponsored Brand APIs work for 'Seller' type users. Agency users and Attribution accounts will not have access to APIs
User account used for authentication must have access to Campaign Manager and all Reports

Integrate Amazon Sponsored Brand Ads with Daton

Sign in to Daton.
Select Amazon Sponsored Brand from the Connectors page.
Provide all required configuration parameters - Integration Name, Replication Frequency, History, Region/Marketplace, and Attribution lookback. The integration name would be used while creating tables in the warehouse and cannot be changed later.
You will be redirected to the Amazon Advertising login page to authorize Daton to extract data periodically. Log in with your seller account.
After authentication, you can choose from the available Amazon Advertising Accounts/ProfileIds list.
After account selection, you'll be prompted to select the Tables/APIs for replication.
Then select the required fields for each table.
Submit the integration.

Workflow

Integrations would be in configuring state initially. They would be moved to the active state when selected tables are created in the warehouse.
Users would be able to edit/pause/re-activate/delete integration anytime.
Users can view job status and process logs from the integration details page by clicking on the integration name from the active list.

Known Issues

Amazon reconciles data and may update metrics for up to 30 days. If you want to use 7-day attribution metrics, select 8-day attribution offset in the configuration. Daton will repeat the report data for a given date depending on the attribution offset selected
Data would always be fetched for the previous day after 2 AM Seller time
There can be mismatches of <1% in metrics even with 30-day attribution selection in Daton
Read more on attribution - [FAQs] (https://docs.sarasanalytics.com/faqs/faqs/amazon-advertising-faqs)

AmazonAds Data

TABLES

Profile

Purpose: Retrieve all profiles associated with the Amazon Advertising account

Source API Documentation: Amazon Sponsored Brand Ads - Profile

Replication Type: Full Load

Replication Key: N/A

Portfolio

Purpose: Retrieve a list of up to 100 portfolios

Source API Documentation: Amazon Sponsored Brand Ads - Portfolio

Replication Type: Full Load

Replication Key: N/A

Store

Purpose: List store information for all registered stores under an advertiser

Source API Documentation: Amazon Sponsored Brand Ads - Store

Replication Type: Full Load

Replication Key: N/A

SponsoredBrands_ProductMetadata

Purpose: The Amazon Product Selector API allows integrators to receive product metadata such as inventory status, price, eligibility status and product details for SKUS or ASINs in their Product Catalog in order to launch, manage or optimize Sponsored Brand, Sponsored Brands or Sponsored Display advertising campaigns. The Product Selector API is available to Sellers, Vendors, and Authors

Source API Documentation: Amazon Sponsored Brand Ads - Product Metadata

Replication Type: Full Load

Replication Key: N/A

FIELDS

SponsoredBrands_Campaign

Purpose: Return a list of Sponsored Brands campaigns

Source API Documentation: Amazon Sponsored Brand Ads - Campaign

Replication Type: Full Load

Replication Key: N/A

FIELDS

SponsoredBrands_AdGroup

Purpose: Return a list of ad groups

Source API Documentation: Amazon Sponsored Brand Ads - Ad Group

Replication Type: Full Load

Replication Key: N/A

FIELDS

SponsoredBrands_Keywords

Purpose: Gets an array of keywords

Source API Documentation: Amazon Sponsored Brand Ads - Keywords

Replication Type: Full Load

Replication Key: N/A

FIELDS

SponsoredBrands_Drafts

Purpose: Gets an array of all draft campaigns associated with the client identifier passed in the authorization header, filtered by specified criteria. Returns both product collection and video draft campaigns by default

Source API Documentation: Amazon Sponsored Brand Ads - Drafts

Replication Type: Full Load

Replication Key: N/A

FIELDS

SponsoredBrands_StoresAssets

Purpose: For sellers or vendors, gets an array of assets associated with the specified brand entity identifier

Source API Documentation: Amazon Sponsored Brand Ads - Stores

Replication Type: Full Load

Replication Key: N/A

FIELDS

SponsoredBrands_NegativeKeywords

Purpose: Return a list of negative ad group-level keywords

Source API Documentation: Amazon Sponsored Brand Ads - Negative Keywords

Replication Type: Full Load

Replication Key: N/A

FIELDS

SponsoredBrands_Targets

Purpose: Gets a list of product targets associated with the client identifier

Source API Documentation: Amazon Sponsored Brand Ads - Targets

Replication Type: Full Load

Replication Key: N/A

FIELDS

SponsoredBrands_NegativeTargets

Purpose: Gets a list of product negative targets associated with the client identifier

Source API Documentation: Amazon Sponsored Brand Ads - Negative Targets

Replication: Full Replication

Replication Key: N/A

FIELDS

SponsoredBrands_TargetingRecommendations

Purpose: Gets a list of recommended products for targeting. Recommendations are based on the ASINs that are passed in the request.

Source API Documentation: Amazon Sponsored Brand Ads - Targeting Recommendations

Replication Type: Full Load

Replication Key: N/A

FIELDS

SponsoredBrands_BidRecommendations

Purpose: Get a list of bid recommendation objects for a specified list of keywords or products.

Source API Documentation: Amazon Sponsored Brand Ads - Bid Recommendations

Replication Type: Full Load

Replication Key: N/A

FIELDS

REPORTS

SponsoredBrands_CampaignsReports

Purpose: Retrieves campaigns performance report

Source API Documentation: Amazon Sponsored Brand Ads - Reports

ReportName in Seller Central: Campaign

Replication Type: Key Based Replication

Replication Key: Date

FIELDS

SponsoredBrands_PlacementCampaignsReport

Purpose: Retrieves campaigns performance report with 'placement' segmentation

Source API Documentation: Amazon Sponsored Brand Ads - Reports

ReportName in Seller Central: Campaign Placement

Replication Type: Key Based Replication

Replication Key: Date

FIELDS

SponsoredBrands_AdGroupsReport

Purpose: Retrieves ad-group performance report

Source API Documentation: Amazon Sponsored Brand Ads - Reports

ReportName in Seller Central: None

Replication Type: Key Based Replication

Replication Key: Date

FIELDS

SponsoredBrands_KeywordsReport

Purpose: Retrieves keyword performance report

Source API Documentation: Amazon Sponsored Brand Ads - Reports

ReportName in Seller Central: Keyword

Replication Type: Key Based Replication

Replication Key: Date

FIELDS

SponsoredBrands_PlacementKeywordsReport

Purpose: Retrieves keyword performance report with 'placement' segmentation

Source API Documentation: Amazon Sponsored Brand Ads - Reports

ReportName in Seller Central: Keyword Placement

Replication Type: Key Based Replication

Replication Key: Date

FIELDS

SponsoredBrands_SearchTermKeywordsReport

Purpose: Retrieves keyword performance report with 'query' segmentation

Source API Documentation: Amazon Sponsored Brand Ads - Reports

ReportName in Seller Central: Search term

Replication Type: Key Based Replication

Replication Key: Date

Please note that, for the "Search Term Keywords Report" table, the data for match type "-" corresponds to product-targeted campaigns which is not supported by Amazon Ads API and this limitation is not an issue caused by Daton.

SponsoredBrands_TargetReport

Purpose: Retrieves performance report for targets

Source API Documentation: Amazon Sponsored Brand Ads - Reports

ReportName in Seller Central: None

Replication Type: Key Based Replication

Replication Key: Date

FIELDS

SponsoredBrands_HeadlineSearchReport

Purpose:

Source API Documentation: Amazon Sponsored Brand Ads - Reports

ReportName in Seller Central: None

Replication Type: Key Based Replication

Replication Key: Date

FIELDS

SponsoredBrands_SearchTermHeadlineSearchReport

Purpose:

Source API Documentation: Amazon Sponsored Brand Ads - Reports

ReportName in Seller Central: None

Replication Type: Key Based Replication

Replication Key: Date

FIELDS

SponsoredBrands_KeywordsVideoReport

Purpose: Retrieves video performance report for Keywords

Source API Documentation: Amazon Sponsored Brand Ads - Reports

ReportName in Seller Central: Keywords Video

Replication Type: Key Based Replication

Replication Key: Date

FIELDS

SponsoredBrands_AdGroupsVideoReport

Purpose: Retrieves video performance report for AdGroups

ReportName in Seller Central: None

Source API Documentation: Amazon Sponsored Brand Ads - Reports

Replication Type: Key Based Replication

Replication Key: Date

FIELDS

SponsoredBrands_CampaignsVideoReport

Purpose: Retrieves video performance report for Campaigns

ReportName in Seller Central: Campaigns Video

Source API Documentation: Amazon Sponsored Brand Ads - Reports

Replication Type: Key Based Replication

Replication Key: Date

FIELDS

SponsoredBrands_PlacementCampaignsVideoReport

Purpose: Retrieves video performance report for Campaigns with 'placement' segmentation

ReportName in Seller Central: Campaigns placement video

Source API Documentation: Amazon Sponsored Brand Ads - Reports

Replication Type: Key Based Replication

Replication Key: Date

FIELDS

SponsoredBrands_SearchTermKeywordsVideoReport

Purpose: Retrieves video performance report for Keywords with 'query' segmentation

ReportName in Seller Central: Search term video

Source API Documentation: Amazon Sponsored Brand Ads - Reports

Replication Type: Key Based Replication

Replication Key: Date

Please note that, for the "Search Term Keywords Video Report" table, the data for match type "-" corresponds to product-targeted campaigns which is not supported by Amazon Ads API and this limitation is not an issue caused by Daton.

FIELDS

SponsoredBrands_PlacementKeywordsVideoReport

Purpose: Retrieves video performance report for Keywords with 'placement' segmentation

ReportName in Seller Central: None

Source API Documentation: Amazon Sponsored Brand Ads - Reports

Replication Type: Key Based Replication

Replication Key: Date

FIELDS

SponsoredBrands_TargetVideoReport

Purpose: Retrieves video performance report for Targets

ReportName in Seller Central: None

Source API Documentation: Amazon Sponsored Brand Ads - Reports

Replication Type: Key Based Replication

Replication Key: Date

FIELDS

SponsoredBrands_UnifiedAdGroupsReport

Purpose: Retrieves ad-group performance report

Source API Documentation: Amazon Sponsored Brand Ads - Reports

FIELDS

SponsoredBrands_UnifiedKeywordsReport

Purpose: Retrieves performance report for Keywords

Source API Documentation: Amazon Sponsored Brand Ads - Reports

FIELDS

SponsoredBrands_UnifiedTargetReport

Purpose: Retrieves performance report for targets

Source API Documentation: Amazon Sponsored Brand Ads - Reports

FIELDS

SponsoredBrands_UnifiedPlacementCampaignsReport

Purpose: Retrieves campaign's performance report with 'placement' segmentation

Source API Documentation: Amazon Sponsored Brand Ads - Reports

FIELDS

SponsoredBrands_UnifiedPlacementKeywordsReport

Purpose: Retrieves keyword performance report with 'placement' segmentation

Source API Documentation: Amazon Sponsored Brand Ads - Reports

Note: The API reports don't return the data for match type "-" i.e. auto-targeting data

FIELDS

SponsoredBrands_UnifiedCampaignsReport

Purpose: Retrieves campaigns performance report

Source API Documentation: Amazon Sponsored Brand Ads - Reports

FIELDS

SponsoredBrands_UnifiedSearchTermKeywordsReport

Purpose: Retrieves keyword performance report with 'query' segmentation

Source API Documentation: Amazon Sponsored Brand Ads - Reports

Please note that, for the "Unified Search Term Keywords Report" table, the data for match type "-" corresponds to product-targeted campaigns which is not supported by Amazon Ads API and this limitation is not an issue caused by Daton.