Amazon Sponsored Product Ads
Amazon Sponsored Product ETL connector for data replication
Features | Details |
Release Status | Released |
Source API Version | V2 |
Table Selection | Yes |
Column Selection | Yes |
Edit Integration | Yes |
Replication Type Selection | No |
Authentication Parameters | Login Id and Password |
Replication Type | Full Replication
Key Based Incremental |
Replication Key | Date |
Suggested Replication Frequency | 24 hours |
Supports attribution | Yes |
All the tables that can be supported in Daton for the Amazon Sponsored Product Ads connector are listed below:
Profile | Portfolio |
Store | SponsoredProducts_ProductMetadata |
SponsoredProducts_Campaign | SponsoredProducts_CampaignEx |
SponsoredProducts_AdGroup | SponsoredProducts_AdGroupEx |
SponsoredProducts_BiddableKeyword | SponsoredProducts_BiddableKeywordsEx |
SponsoredProducts_NegativeKeyword | SponsoredProducts_NegativeKeywordEx |
SponsoredProducts_CampaignNegativeKeyword | SponsoredProducts_CampaignNegativeKeywordEx |
SponsoredProducts_ProductAd | SponsoredProducts_ProductAdEx |
SponsoredProducts_TargetingClause | SponsoredProducts_TargetingClauseEx |
SponsoredProducts_KeywordBidRecommendations | SponsoredProducts_TargetBidRecommendations |
SponsoredProducts_SuggestedKeywords | SponsoredProducts_ProductTargetingRecommendations |
SponsoredProducts_NegativeTargetingClause | SponsoredProducts_CampaignsReports |
SponsoredProducts_PlacementCampaignsReport | SponsoredProducts_AdGroupReport |
SponsoredProducts_KeywordReport | SponsoredProducts_SearchTermKeywordReport |
SponsoredProducts_ProductAdsReport | SponsoredProducts_TargetingReport |
SponsoredProducts_SearchTermTargetingReport | SponsoredProducts_AsinsReportWithTargetId |
SponsoredProducts_AsinsReportWithKeywordId | |
The following table represents how Daton maps tables with respect to the reports you see in the Amazon Ad console interface.
Report in Ad console | Report in Daton |
|---|---|
Search term | SponsoredProducts_SearchTermKeywordReport |
Targeting | SponsoredProducts_SearchTermTargetingReport |
Advertised product | SponsoredProducts_ProductAdsReport |
Campaign | SponsoredProducts_CampaignsReport |
Budget | - |
Placement | SponsoredProducts_PlacementCampaignsReport |
Purchased product | SponsoredProducts_AsinsReportWithTargetId
SponsoredProducts_AsinsReportWithKeywordId |
Performance Over Time | - |
Search Term Impression Share | - |
Gross And Invalid Traffic | - |
- 1.Sponsored Product APIs work for 'Seller' type users. Agency users and Attribution accounts will not have access to APIs
- 2.User account used for authentication must have access to Campaign Manager and all Reports
- 1.Sign in to Daton.
- 2.Select Amazon Sponsored Product from the Connectors page.
- 3.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.
- 4.You will be redirected to the Amazon Advertising login page for authorizing Daton to extract data periodically. Log in with your seller account.
- 5.After authentication, you will be prompted to choose from the list of available Amazon Advertising Accounts/ProfileIds.
- 6.After account selection, you'll be prompted to select the Tables/APIs for replication.
- 7.Then select the required fields for each table.
- 8.Submit the integration.
- 1.Integrations would be in configuring state initially. They would be moved to the active state when selected tables are created in the warehouse.
- 2.Users would be able to edit/pause/re-activate/delete integration anytime
- 3.Users can view job status and process logs from the integration details page by clicking on the integration name from the active list.
- 1.Amazon reconciles data and may update metrics for up to 30 days. If you want to use 7-day attribution metrics, then you must select 8-day attribution offset in the configuration. Daton will repeat the report data for a given date depending on the attribution offset selected
- 2.Data would always be fetched for the previous day after 2 AM Seller time
- 3.There can be mismatches of <1% in metrics even with 30-day attribution selection in Daton
- 4.Read more on attribution - [FAQs] (https://docs.sarasanalytics.com/faqs/faqs/amazon-advertising-faqs)
Profile
Purpose: Retrieve all profiles associated with the Amazon Advertising account
Replication Type: Full Load
Replication Key: N/A
Portfolio
Purpose: Retrieve a list of up to 100 portfolios
Replication Type: Full Load
Replication Key: N/A
Store
Purpose: List store information for all registered stores under an advertiser
Replication Type: Full Load
Replication Key: N/A
SponsoredProducts_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 Products, Sponsored Brands, or Sponsored Display advertising campaigns. The Product Selector API is available to Sellers, Vendors, and Authors
Replication Type: Full Load
Replication Key: N/A
FIELDS
Field Name | Data Type |
|---|---|
RequestTime | TIMESTAMP |
fetchDate | DATE |
profileId | STRING |
countryName | STRING |
accountName | STRING |
accountId | STRING |
adId | STRING |
campaignId | STRING |
adGroupId | STRING |
state | STRING |
creationDate | STRING |
lastUpdatedDate | STRING |
servingStatus | STRING |
_daton_user_id | NUMERIC |
_daton_batch_runtime | NUMERIC |
_daton_batch_id | NUMERIC |
SponsoredProducts_Campaign
Purpose: Return a list of Sponsored Products campaigns
Replication Type: Full Load
Replication Key: N/A
FIELDS
Field Name | Datatype |
|---|---|
RequestTime | TIMESTAMP |
countryName | STRING |
accountName | STRING |
accountId | STRING |
fetchDate | DATE |
profileId | STRING |
campaignId | STRING |
name | STRING |
campaignType | STRING |
targetingType | STRING |
state | STRING |
dailyBudget | NUMERIC |
startDate | STRING |
premiumBidAdjustment | BOOLEAN |
bidding | RECORD |
Level 2strategy | STRING |
Level 2adjustments | RECORD |
portfolioId | INTEGER |
tags | STRING |
endDate | STRING |
_daton_user_id | NUMERIC |
_daton_batch_runtime | NUMERIC |
_daton_batch_id | NUMERIC |
SponsoredProducts_CampaignEx
Purpose: Return a list of Sponsored Products campaigns with additional properties
Replication Type: Full Load
Replication Key: N/A
SponsoredProducts_AdGroup
Purpose: Return a list of ad groups
Replication Type: Full Load
Replication Key: N/A
FIELDS
Field Name | Data Type |
|---|---|
RequestTime | TIMESTAMP |
profileId | STRING |
countryName | STRING |
accountName | STRING |
accountId | STRING |
fetchDate | DATE |
adGroupId | STRING |
campaignId | STRING |
name | STRING |
defaultBid | NUMERIC |
state | STRING |
daton_user_id | NUMERIC |
daton_batch_runtime | NUMERIC |
daton_batch_id | NUMERIC |
SponsoredProducts_AdGroupEx
Purpose: Return a list of ad groups with additional properties
Replication Type: Full Load
Replication Key: N/A
SponsoredProducts_BiddableKeyword
Purpose: Return a list of ad group-level biddable keywords
Replication Type: Full Load
Replication Key: N/A
FIELDS
Field Name | Data Type |
|---|---|
RequestTime | TIMESTAMP |
profileId | STRING |
countryName | STRING |
accountName | STRING |
accountId | STRING |
fetchDate | DATE |
targetId | INTEGER |
campaignId | STRING |
adGroupId | STRING |
state | STRING |
keywordText | STRING |
matchType | STRING |
bid | NUMERIC |
nativeLanguageKeyword | STRING |
_daton_user_id | NUMERIC |
_daton_batch_runtime | NUMERIC |
_daton_batch_id | NUMERIC |
SponsoredProducts_BiddableKeywordsEx
Purpose: Return a list of ad group-level biddable keywords with additional properties
Replication Type: Full Load
Replication Key: N/A
FIELDS
Field Name | Data Type |
|---|---|
RequestTime | TIMESTAMP |
profileId | STRING |
countryName | STRING |
accountName | STRING |
accountId | STRING |
fetchDate | DATE |
keywordId | INTEGER |
campaignId | STRING |
adGroupId | STRING |
state | STRING |
keywordText | STRING |
matchType | STRING |
creationDate | STRING |
lastUpdatedDate | STRING |
servingStatus | STRING |
bid | NUMERIC |
nativeLanguageKeyword | STRING |
_daton_user_id | NUMERIC |
_daton_batch_runtime | NUMERIC |
_daton_batch_id | NUMERIC |
SponsoredProducts_NegativeKeyword
Purpose: Return a list of negative ad group-level keywords
Replication Type: Full Load
Replication Key: N/A
FIELDS
Field Name | Data Type |
|---|---|
RequestTime | TIMESTAMP |
profileId | STRING |
countryName | STRING |
accountName | STRING |
accountId | STRING |
fetchDate | DATE |
keywordId | INTEGER |
campaignId | STRING |
adGroupId | STRING |
state | STRING |
keywordText | STRING |
matchType | STRING |
_daton_user_id | NUMERIC |
_daton_batch_runtime | NUMERIC |
_daton_batch_id | NUMERIC |
SponsoredProducts_NegativeKeywordEx
Purpose: Return a list of negative ad group-level keywords with additional properties
Replication Type: Full Load
Replication Key: N/A
SponsoredProducts_CampaignNegativeKeyword
Purpose: Return a list of campaign level negative keywords
Replication: Full Replication
Replication Key: N/A
FIELDS
Field Name | Data Type |
|---|---|
RequestTime | TIMESTAMP |
countryName | STRING |
accountName | STRING |
accountId | STRING |
fetchDate | DATE |
profileId | STRING |
keywordId | INTEGER |
campaignId | STRING |
state | STRING |
keywordText | STRING |
matchType | STRING |
_daton_user_id | NUMERIC |
_daton_batch_runtime | NUMERIC |
_daton_batch_id | NUMERIC |
SponsoredProducts_CampaignNegativeKeywordEx
Purpose: Return a list of campaign level negative keywords with additional properties
Replication Type: Full Load
Replication Key: N/A
SponsoredProducts_ProductAd
Purpose: Return a list of product ads
Replication Type: Full Load
Replication Key: N/A
FIELDS
Field Name | Data Type |
|---|---|
RequestTime | TIMESTAMP |
fetchDate | DATE |
profileId | STRING |
countryName | STRING |
accountName | STRING |
accountId | STRING |
adId | STRING |
campaignId | STRING |
adGroupId | STRING |
state | STRING |
creationDate | STRING |
lastUpdatedDate | STRING |
servingStatus | STRING |
_daton_user_id | NUMERIC |
_daton_batch_runtime | NUMERIC |
_daton_batch_id | NUMERIC |
SponsoredProducts_ProductAdEx
Purpose: Return a list of product ads with additional properties
Replication Type: Full Load
Replication Key: N/A
SponsoredProducts_TargetingClause
Purpose: List targeting expressions
Replication Type: Full Load
Replication Key: N/A
FIELDS
Field Name | Data Type |
|---|---|
RequestTime | TIMESTAMP |
countryName | STRING |
accountName | STRING |
accountId | STRING |
fetchDate | DATE |
profileId | STRING |
targetId | INTEGER |
campaignId | STRING |
adGroupId | STRING |
state | STRING |
resolvedExpression | RECORD |
expression | RECORD |
expressionType | STRING |
bid | NUMERIC |
_daton_user_id | NUMERIC |
_daton_batch_runtime | NUMERIC |
_daton_batch_id | NUMERIC |
SponsoredProducts_TargetingClauseEx
Purpose: List targeting expressions with additional properties
Replication Type: Full Load
Replication Key: N/A
SponsoredProducts_KeywordBidRecommendations
Purpose: Gets a bid recommendation for keywords
Replication Type: Full Load
Replication Key: N/A
FIELDS
RequestTime | TIMESTAMP |
profileId | STRING |
countryName | STRING |
accountName | STRING |
accountId | STRING |
fetchDate | DATE |
adGroupId | STRING |
recommendations | RECORD |
_daton_user_id | NUMERIC |
_daton_batch_runtime | NUMERIC |
_daton_batch_id | auto-targetingNUMERIC |
SponsoredProducts_TargetBidRecommendations
Purpose: Gets a list of bid recommendations for a keyword, product, or auto-targeting expressions
Replication Type: Full Load
Replication Key: N/A
FIELDS
Field Name | Data Type |
|---|---|
RequestTime | TIMESTAMP |
profileId | STRING |
countryName | STRING |
accountName | STRING |
accountId | STRING |
fetchDate | DATE |
adGroupId | STRING |
recommendations | RECORD |
_daton_user_id | NUMERIC |
_daton_batch_runtime | NUMERIC |
_daton_batch_id | NUMERIC |
SponsoredProducts_SuggestedKeywords
Purpose: Gets suggested keywords for a specified list of ASINs
Replication Type: Full Load
Replication Key: N/A
FIELDS
Field Name | Data Type |
|---|---|
RequestTime | TIMESTAMP |
profileId | STRING |
countryName | STRING |
accountName | STRING |
accountId | STRING |
fetchDate | DATE |
keywordText | STRING |
matchType | STRING |
_daton_user_id | NUMERIC |
_daton_batch_runtime | NUMERIC |
_daton_batch_id | NUMERIC |
SponsoredProducts_ProductTargetingRecommendations
Purpose: Gets a list of recommended products for targeting
Replication Type: Full Load
Replication Key: N/A
FIELDS
Field Name | Data Type |
|---|---|
RequestTime | TIMESTAMP |
profileId | STRING |
countryName | STRING |
accountName | STRING |
accountId | STRING |
fetchDate | DATE |
recommendedProducts | RECORD |
_daton_user_id | NUMERIC |
_daton_batch_runtime | NUMERIC |
_daton_batch_id | NUMERIC |
SponsoredProducts_NegativeTargetingClause
Purpose: Gets a list of negative targeting clauses
Replication Type: Full Load
Replication Key: N/A
FIELDS
Field Name | Data Type |
|---|---|
RequestTime | TIMESTAMP |
profileId | STRING |
countryName | STRING |
accountName | STRING |
accountId | STRING |
fetchDate |