Amazon Ads Connector Reference

241 metrics155 dimensions

 

http://connectors.windsor.ai/amazon_ads?fields=date,campaigntype,campaignname,totalcost,clicks&api_key=[your API key]&date_preset=last_7d

The Amazon Ads connector lets you pull Amazon Ads data on a various breakdown levels. If you specify the fields date_from and date_to it will query the data for absolute date ranges.

The Amazon Ads connector exposes 396 fields (241 metrics, 155 dimensions). Every field ID below can be passed to the Windsor.ai API in the fields parameter.


Available actions


Enable Campaign Enable a paused Amazon Sponsored Products campaign. Reversible via pause_campaign.

Enable a paused Amazon Sponsored Products campaign. Reversible via pause_campaign.

Parameters
campaign_idstringRequired
Pause Campaign Pause an active Amazon Sponsored Products campaign. Reversible via enable_campaign.

Pause an active Amazon Sponsored Products campaign. Reversible via enable_campaign.

Parameters
campaign_idstringRequired
Set Campaign Budget Set the daily budget of an Amazon Sponsored Products campaign. The amount is in the account currency major unit (e.g. 50 means 50.00, not cents). Sponsored Products campaigns only support daily budgets.

Set the daily budget of an Amazon Sponsored Products campaign. The amount is in the account currency major unit (e.g. 50 means 50.00, not cents). Sponsored Products campaigns only support daily budgets.

Parameters
campaign_idstringRequiredbudgetnumberRequired

Amazon Ads Fields

Amazon Ads sponsored_brands_ad fields

The sponsored_brands_ad report of the Amazon Ads connector includes 19 fields.

IDTypeNameDescription
NUMERICSponsored Brands Ad: Total advertising cost of sales (ACoS)Total advertising cost of sales (cost divided by sales)
TEXTSponsored Brands Ad: Ad Group IDThe ID associated with the ad group.
TEXTSponsored Brands Ad: Ad Group NameThe name of the ad group.
TEXTSponsored Brands Ad: Ad IDThe ID associated with the ad.
NUMERICSponsored Brands Ad: Branded SearchesNumber of searches for keywords associated with the brand.
TEXTSponsored Brands Ad: Campaign IDThe ID associated with a campaign.
TEXTSponsored Brands Ad: Campaign NameThe name of the campaign.
TEXTSponsored Brands Ad: Campaign StatusThe state of the campaign.
NUMERICSponsored Brands Ad: ClicksTotal number of ad clicks.
NUMERICSponsored Brands Ad: CostTotal cost of ad clicks.
NUMERICSponsored Brands Ad: CPCCost-per-click (CPC)
PERCENTSponsored Brands Ad: CTRClick-through rate (CTR)
NUMERICSponsored Brands Ad: Detail Page ViewsNumber of detail page views attributed to the ad.
NUMERICSponsored Brands Ad: ImpressionsTotal number of ad impressions.
TEXTSponsored Brands Ad: Portfolio IDThe identifier of the portfolio the campaign belongs to
TEXTSponsored Brands Ad: Portfolio nameThe name of the portfolio the campaign belongs to
NUMERICSponsored Brands Ad: PurchasesTotal number of attributed conversion events occurring within 14 days of an ad click or view.
NUMERICSponsored Brands Ad: Return on advertising spend (RoAS)Return on advertising spend (sales divided by cost)
NUMERICSponsored Brands Ad: SalesTotal value of attributed sales occurring within 14 days of an ad click or view.

Amazon Ads sponsored_brands_ad_group fields

The sponsored_brands_ad_group report of the Amazon Ads connector includes 17 fields.

IDTypeNameDescription
NUMERICSponsored Brands Ad Group: Total advertising cost of sales (ACoS)Total advertising cost of sales (cost divided by sales)
TEXTSponsored Brands Ad Group: Ad Group IDThe ID associated with the ad group.
TEXTSponsored Brands Ad Group: Ad Group NameThe name of the ad group.
NUMERICSponsored Brands Ad Group: Branded SearchesNumber of searches for keywords associated with the brand.
TEXTSponsored Brands Ad Group: Campaign IDThe ID associated with a campaign.
TEXTSponsored Brands Ad Group: Campaign NameThe name of the campaign.
NUMERICSponsored Brands Ad Group: ClicksTotal number of ad clicks.
NUMERICSponsored Brands Ad Group: CostTotal cost of ad clicks.
NUMERICSponsored Brands Ad Group: CPCCost-per-click (CPC)
PERCENTSponsored Brands Ad Group: CTRClick-through rate (CTR)
NUMERICSponsored Brands Ad Group: Detail Page ViewsNumber of detail page views attributed to the ad.
NUMERICSponsored Brands Ad Group: ImpressionsTotal number of ad impressions.
TEXTSponsored Brands Ad Group: Portfolio IDThe identifier of the portfolio the campaign belongs to
TEXTSponsored Brands Ad Group: Portfolio nameThe name of the portfolio the campaign belongs to
NUMERICSponsored Brands Ad Group: PurchasesTotal number of attributed conversion events occurring within 14 days of an ad click or view.
NUMERICSponsored Brands Ad Group: Return on advertising spend (RoAS)Return on advertising spend (sales divided by cost)
NUMERICSponsored Brands Ad Group: SalesTotal value of attributed sales occurring within 14 days of an ad click or view.

Amazon Ads sponsored_brands_campaign_non_video fields

The sponsored_brands_campaign_non_video report of the Amazon Ads connector includes 27 fields.

IDTypeNameDescription
NUMERICSponsored Brands Campaign Non Video: Total advertising cost of sales (ACoS)Total advertising cost of sales (cost divided by 14-day sales revenue)
NUMERICSponsored Brands Campaign Non Video: Attributed conversions (14 days)Total number of attributed conversion events occurring within 14 days of ad click
PERCENTSponsored Brands Campaign Non Video: Attributed new-to-brand order rate (14 days)The number of new-to-brand orders relative to the number of clicks (New-to-brand order rate = new-to-brand orders / clicks)
NUMERICSponsored Brands Campaign Non Video: Attributed new-to-brand orders (14 days)The number of first-time orders for products within the brand over a one-year lookback window
NUMERICSponsored Brands Campaign Non Video: Attributed new-to-brand orders share (14 days)The percentage of total orders that are new-to-brand orders
NUMERICSponsored Brands Campaign Non Video: Attributed sales (14 days)Aggregate value of attributed sales occurring within 14 days of click on ad
NUMERICSponsored Brands Campaign Non Video: Attributed new-to-brand sales (14 days)Aggregate value of attributed sales of new-to-brand orders occurring within 7 days of click on ad
PERCENTSponsored Brands Campaign Non Video: Attributed new-to-brand sales share (14 days)The percentage of total sales of new-to-brand purchases
NUMERICSponsored Brands Campaign Non Video: Attributed new-to-brand units ordered (14 days)The number of units from first-time orders for products within the brand over a one-year lookback window
NUMERICSponsored Brands Campaign Non Video: Attributed new-to-brand units ordered share (14 days)The percentage of total units that are units from new-to-brand orders
NUMERICSponsored Brands Campaign Non Video: Attributed units sold (14 days)Number of attributed units sold occurring within 14 days of click on an ad
TEXTSponsored Brands Campaign Non Video: CampaignThe name of the campaign
NUMERICSponsored Brands Campaign Non Video: Campaign budgetTotal budget allotted to the campaign
TEXTSponsored Brands Campaign Non Video: Campaign budget typeOne of: daily or lifetime
TEXTSponsored Brands Campaign Non Video: Campaign statusThe current status of the campaign
TEXTSponsored Brands Campaign Non Video: Campaign ad formatCampaign ad format
TEXTSponsored Brands Campaign Non Video: Campaign ID (duplicate)The unique identifier of the campaign. (duplicate)
NUMERICSponsored Brands Campaign Non Video: ClicksTotal number of ad clicks
NUMERICSponsored Brands Campaign Non Video: CostTotal cost of all ad clicks
NUMERICSponsored Brands Campaign Non Video: CPCCost-per-click (CPC)
PERCENTSponsored Brands Campaign Non Video: CTRClick-through rate (CTR)
NUMERICSponsored Brands Campaign Non Video: ImpressionsTotal number of ad impressions
TEXTSponsored Brands Campaign Non Video: Portfolio IDThe identifier of the portfolio the campaign belongs to
TEXTSponsored Brands Campaign Non Video: Portfolio nameThe name of the portfolio the campaign belongs to
PERCENTSponsored Brands Campaign Non Video: Total return on advertising spend (RoAS)Total return on advertising spend (14-day sales revenue divided by cost)
NUMERICSponsored Brands Campaign Non Video: Spend (alias for Cost)Alias for Cost
NUMERICSponsored Brands Campaign Non Video: Total CostAlias for Cost

Amazon Ads sponsored_brands_campaign_video fields

The sponsored_brands_campaign_video report of the Amazon Ads connector includes 23 fields.

IDTypeNameDescription
NUMERICSponsored Brands Campaign Video: Total advertising cost of sales (ACoS)Total advertising cost of sales (cost divided by sales)
NUMERICSponsored Brands Campaign Video: Branded SearchesNumber of searches that included the name of your brand occurring within 14 days of an ad click or view.
TEXTSponsored Brands Campaign Video: CampaignThe name of the campaign
NUMERICSponsored Brands Campaign Video: Campaign budget AmountTotal budget allotted to the campaign
TEXTSponsored Brands Campaign Video: Campaign budget currency codeThe currency code associated with the campaign.
TEXTSponsored Brands Campaign Video: Campaign budget typeOne of: daily or lifetime
TEXTSponsored Brands Campaign Video: Campaign statusThe current status of the campaign
TEXTSponsored Brands Campaign Video: Campaign ad formatCampaign ad format
TEXTSponsored Brands Campaign Video: Campaign ID (duplicate)The unique identifier of the campaign. (duplicate)
NUMERICSponsored Brands Campaign Video: ClicksTotal number of ad clicks
NUMERICSponsored Brands Campaign Video: CostTotal cost of all ad clicks
NUMERICSponsored Brands Campaign Video: CPCCost-per-click (CPC)
PERCENTSponsored Brands Campaign Video: CTRClick-through rate (CTR)
NUMERICSponsored Brands Campaign Video: Detail Page ViewsNumber of detail page views occurring within 14 days of an ad click or view.
NUMERICSponsored Brands Campaign Video: ImpressionsTotal number of ad impressions
NUMERICSponsored Brands Campaign Video: KENP read (14 days)Number of Kindle Edition Normalized Pages (KENP) read within 14 days of ad click. Relevant to Kindle Direct Publishing (KDP) titles only
TEXTSponsored Brands Campaign Video: Portfolio IDThe identifier of the portfolio the campaign belongs to
TEXTSponsored Brands Campaign Video: Portfolio nameThe name of the portfolio the campaign belongs to
NUMERICSponsored Brands Campaign Video: PurchasesNumber of attributed conversion events occurring within 14 days of an ad click or view.
NUMERICSponsored Brands Campaign Video: Return on advertising spend (RoAS)Return on advertising spend (sales divided by cost)
NUMERICSponsored Brands Campaign Video: SalesTotal value of sales occurring within 14 days of an ad click or view.
NUMERICSponsored Brands Campaign Video: Spend (alias for Cost)Alias for Cost
NUMERICSponsored Brands Campaign Video: Total CostAlias for Cost

Amazon Ads sponsored_brands_purchased_product fields

The sponsored_brands_purchased_product report of the Amazon Ads connector includes 10 fields.

IDTypeNameDescription
TEXTSponsored Brands Purchased Product: Attribution TypeAttribution type of the purchase: Promoted when the purchased ASIN is the advertised product, Brand Halo when it is another product of the same brand bought indirectly.
TEXTSponsored Brands Purchased Product: Campaign Budget Currency CodeThe currency code associated with the campaign budget.
TEXTSponsored Brands Purchased Product: Campaign IDThe ID associated with a campaign.
TEXTSponsored Brands Purchased Product: Campaign NameThe name of the campaign.
NUMERICSponsored Brands Purchased Product: Orders (14 days)Total number of attributed orders within 14 days of an ad click.
TEXTSponsored Brands Purchased Product: Portfolio IDThe identifier of the portfolio the campaign belongs to
TEXTSponsored Brands Purchased Product: Portfolio nameThe name of the portfolio the campaign belongs to
TEXTSponsored Brands Purchased Product: Purchased ASINThe ASIN that customers purchased after an ad click or view.
NUMERICSponsored Brands Purchased Product: Sales (14 days)Total value of attributed sales occurring within 14 days of an ad click.
NUMERICSponsored Brands Purchased Product: Units Sold (14 days)Total number of attributed units sold within 14 days of an ad click.

Amazon Ads sponsored_brands_search_term fields

The sponsored_brands_search_term report of the Amazon Ads connector includes 21 fields.

IDTypeNameDescription
NUMERICSponsored Brands Search Term: ACoSAdvertising cost of sales (cost divided by sales).
TEXTSponsored Brands Search Term: Ad Group IDThe ID associated with an ad group.
TEXTSponsored Brands Search Term: Ad Group NameThe name of the ad group.
TEXTSponsored Brands Search Term: Keyword StatusThe current status of the keyword.
TEXTSponsored Brands Search Term: Campaign Budget Currency CodeThe currency code associated with the campaign budget.
TEXTSponsored Brands Search Term: Campaign IDThe ID associated with a campaign.
TEXTSponsored Brands Search Term: Campaign NameThe name of the campaign.
NUMERICSponsored Brands Search Term: ClicksTotal number of ad clicks.
NUMERICSponsored Brands Search Term: CostTotal cost of all ad clicks.
NUMERICSponsored Brands Search Term: CPCCost-per-click (CPC).
PERCENTSponsored Brands Search Term: CTRClick-through rate (CTR).
NUMERICSponsored Brands Search Term: ImpressionsTotal number of ad impressions.
TEXTSponsored Brands Search Term: Keyword IDThe ID of the keyword.
TEXTSponsored Brands Search Term: Keyword TextThe keyword text that served the ad.
TEXTSponsored Brands Search Term: Match TypeThe match type of the keyword.
NUMERICSponsored Brands Search Term: PurchasesNumber of attributed conversion events within 14 days of an ad click or view.
PERCENTSponsored Brands Search Term: RoASReturn on advertising spend (sales divided by cost).
NUMERICSponsored Brands Search Term: SalesTotal value of attributed sales within 14 days of an ad click or view.
TEXTSponsored Brands Search Term: Search TermThe customer search term that resulted in an ad click.
NUMERICSponsored Brands Search Term: Spend (alias for Cost)Alias for Cost.
NUMERICSponsored Brands Search Term: Total CostAlias for Cost.

Amazon Ads sponsored_brands_targeting fields

The sponsored_brands_targeting report of the Amazon Ads connector includes 20 fields.

IDTypeNameDescription
NUMERICSponsored Brands Targeting: Total advertising cost of sales (ACoS)Total advertising cost of sales (cost divided by sales)
TEXTSponsored Brands Targeting: Ad Group IDThe ID associated with the ad group.
TEXTSponsored Brands Targeting: Ad Group NameThe name of the ad group.
TEXTSponsored Brands Targeting: Campaign IDThe ID associated with a campaign.
TEXTSponsored Brands Targeting: Campaign NameThe name of the campaign.
NUMERICSponsored Brands Targeting: ClicksTotal number of ad clicks.
NUMERICSponsored Brands Targeting: CostTotal cost of all ad clicks.
NUMERICSponsored Brands Targeting: ImpressionsTotal number of ad impressions.
TEXTSponsored Brands Targeting: Keyword or target IDThe ID of the keyword or targeting clause.
TEXTSponsored Brands Targeting: KeywordThe keyword text used for bidding on targeted searches.
TEXTSponsored Brands Targeting: Match typeThe keyword match type (broad, phrase or exact).
TEXTSponsored Brands Targeting: Portfolio IDThe identifier of the portfolio the campaign belongs to
TEXTSponsored Brands Targeting: Portfolio nameThe name of the portfolio the campaign belongs to
NUMERICSponsored Brands Targeting: PurchasesNumber of attributed conversion events occurring within 14 days of an ad click or view.
NUMERICSponsored Brands Targeting: Return on advertising spend (RoAS)Return on advertising spend (sales divided by cost)
NUMERICSponsored Brands Targeting: SalesTotal value of sales occurring within 14 days of an ad click or view.
NUMERICSponsored Brands Targeting: Spend (alias for Cost)Alias for Cost.
TEXTSponsored Brands Targeting: Targeting expressionThe targeting expression, e.g. a product or category target.
TEXTSponsored Brands Targeting: Targeting IDThe ID of the targeting clause.
TEXTSponsored Brands Targeting: Targeting textThe human-readable targeting expression.

Amazon Ads sponsored_display_ad_group fields

The sponsored_display_ad_group report of the Amazon Ads connector includes 18 fields.

IDTypeNameDescription
NUMERICSponsored Display Ad Group: Total advertising cost of sales (ACoS)Total advertising cost of sales (cost divided by sales)
TEXTSponsored Display Ad Group: Ad Group IDThe ID associated with the ad group.
TEXTSponsored Display Ad Group: Ad Group NameThe name of the ad group.
NUMERICSponsored Display Ad Group: Branded SearchesNumber of searches for keywords associated with the brand.
TEXTSponsored Display Ad Group: Campaign IDThe ID associated with a campaign.
TEXTSponsored Display Ad Group: Campaign NameThe name of the campaign.
NUMERICSponsored Display Ad Group: ClicksTotal number of ad clicks.
NUMERICSponsored Display Ad Group: CostTotal cost of ad clicks.
NUMERICSponsored Display Ad Group: CPCCost-per-click (CPC)
PERCENTSponsored Display Ad Group: CTRClick-through rate (CTR)
NUMERICSponsored Display Ad Group: Detail Page ViewsNumber of detail page views attributed to the ad.
NUMERICSponsored Display Ad Group: ImpressionsTotal number of ad impressions.
TEXTSponsored Display Ad Group: Portfolio IDThe identifier of the portfolio the campaign belongs to
TEXTSponsored Display Ad Group: Portfolio nameThe name of the portfolio the campaign belongs to
NUMERICSponsored Display Ad Group: PurchasesTotal number of attributed conversion events occurring within 14 days of an ad click or view.
NUMERICSponsored Display Ad Group: Return on advertising spend (RoAS)Return on advertising spend (sales divided by cost)
NUMERICSponsored Display Ad Group: SalesTotal value of attributed sales occurring within 14 days of an ad click or view.
NUMERICSponsored Display Ad Group: Units SoldTotal number of attributed units sold occurring within 14 days of an ad click or view.

Amazon Ads sponsored_display_advertised_product fields

The sponsored_display_advertised_product report of the Amazon Ads connector includes 17 fields.

IDTypeNameDescription
NUMERICSponsored Display Advertised Product: Total advertising cost of sales (ACoS)Total advertising cost of sales (cost divided by 14-day sales revenue)
TEXTSponsored Display Advertised Product: Ad Group IDThe ID associated with the ad group.
TEXTSponsored Display Advertised Product: Ad Group NameThe name of the ad group.
TEXTSponsored Display Advertised Product: Ad IDThe ID associated with the ad.
TEXTSponsored Display Advertised Product: Campaign Budget Currency CodeThe currency code associated with the campaign budget.
TEXTSponsored Display Advertised Product: Campaign IDThe ID associated with a campaign.
NUMERICSponsored Display Advertised Product: ClicksTotal number of ad clicks.
NUMERICSponsored Display Advertised Product: CostTotal cost of ad clicks.
NUMERICSponsored Display Advertised Product: ImpressionsTotal number of ad impressions.
TEXTSponsored Display Advertised Product: Portfolio IDThe identifier of the portfolio the campaign belongs to
TEXTSponsored Display Advertised Product: Portfolio nameThe name of the portfolio the campaign belongs to
TEXTSponsored Display Advertised Product: Promoted ASINThe ASIN being promoted.
TEXTSponsored Display Advertised Product: Promoted SKUThe SKU being promoted.
NUMERICSponsored Display Advertised Product: PurchasesTotal number of attributed conversion events occurring within 14 days of an ad click or view.
NUMERICSponsored Display Advertised Product: Return on advertising spend (RoAS)Return on advertising spend (14-day sales revenue divided by cost)
NUMERICSponsored Display Advertised Product: SalesTotal value of attributed sales occurring within 14 days of an ad click or view.
NUMERICSponsored Display Advertised Product: Units SoldTotal number of attributed units sold occurring within 14 days of an ad click or view.

Amazon Ads sponsored_display_campaign fields

The sponsored_display_campaign report of the Amazon Ads connector includes 33 fields.

IDTypeNameDescription
NUMERICSponsored Display Campaign: Total advertising cost of sales (ACoS)Total advertising cost of sales (cost divided by 14-day sales revenue)
NUMERICSponsored Display Campaign: Branded SearchesThe number of searches that included the name of your brand occurring within 14 days of an ad click or view.
NUMERICSponsored Display Campaign: Branded Searches ClicksThe number of searches that included the name of your brand occurring within 14 days of an ad click.
NUMERICSponsored Display Campaign: Branded Searches ViewsThe number of times a branded keyword was searched on Amazon based on the brands associated to the featured ASINs in your campaign, attributed to an ad view.
TEXTSponsored Display Campaign: Campaign IdThe ID associated with a campaign.
TEXTSponsored Display Campaign: Campaign NameThe name associated with a campaign.
NUMERICSponsored Display Campaign: ClicksTotal number of clicks on an ad.
NUMERICSponsored Display Campaign: CostTotal cost of ad clicks.
NUMERICSponsored Display Campaign: Detail Page ViewsNumber of detail page views occurring within 14 days of an ad click or view.
NUMERICSponsored Display Campaign: Detail Page Views ClicksNumber of detail page views occurring within 14 days of an ad click.
NUMERICSponsored Display Campaign: ImpressionsTotal number of ad impressions.
NUMERICSponsored Display Campaign: Impressions ViewsNumber of impressions that met the Media Ratings Council (MRC) viewability standard. See viewability details at https://advertising.amazon.com/library/guides/viewability
NUMERICSponsored Display Campaign: KENP readNumber of Kindle Edition Normalized Pages (KENP) read within 14 days of an ad click or view. Relevant to Kindle Direct Publishing (KDP) titles only
NUMERICSponsored Display Campaign: New To Brand PurchasesThe number of first-time orders for brand products over a one-year lookback window resulting from an ad click or view. Not available for book vendors.
NUMERICSponsored Display Campaign: New To Brand Purchases ClicksThe number of first-time orders for brand products over a one-year lookback window resulting from an ad click. Not available for book vendors.
NUMERICSponsored Display Campaign: New To Brand Sales ClicksTotal value of new-to-brand sales occurring within 14 days of an ad click. Not available for book vendors.
NUMERICSponsored Display Campaign: New To Brand Units SoldTotal number of attributed units ordered as part of new-to-brand sales occurring within 14 days of an ad click or view. Not available for book vendors.
NUMERICSponsored Display Campaign: New To Brand Units Sold ClicksTotal number of attributed units ordered as part of new-to-brand sales occurring within 14 days of an ad click. Not available for book vendors.
TEXTSponsored Display Campaign: Portfolio IDThe identifier of the portfolio the campaign belongs to
TEXTSponsored Display Campaign: Portfolio nameThe name of the portfolio the campaign belongs to
NUMERICSponsored Display Campaign: PurchasesNumber of attributed conversion events occurring within 14 days of an ad click or view.
NUMERICSponsored Display Campaign: Purchases ClicksNumber of attributed conversion events occurring within 14 days of an ad click.
NUMERICSponsored Display Campaign: Purchases Promoted ClicksNumber of attributed conversion events occurring within 14 days of ad click where the purchased SKU was the same as the SKU advertised.
NUMERICSponsored Display Campaign: Return on advertising spend (RoAS)Return on advertising spend (14-day sales revenue divided by cost)
NUMERICSponsored Display Campaign: SalesTotal value of sales occurring within 14 days of an ad click or view.
NUMERICSponsored Display Campaign: Sales ClicksTotal value of sales occurring within 14 days of an ad click.
NUMERICSponsored Display Campaign: Sales Promoted ClicksTotal value of sales occurring within 14 days of ad click where the purchased SKU was the same as the SKU advertised.
NUMERICSponsored Display Campaign: Units SoldNumber of attributed units sold within 14 days of an ad click or view.
NUMERICSponsored Display Campaign: Video Complete ViewsThe number of impressions where the video was viewed to 100%.
NUMERICSponsored Display Campaign: Video First Quartile ViewsThe number of impressions where the video was viewed to 25%.
NUMERICSponsored Display Campaign: Video Midpoint ViewsThe number of impressions where the video was viewed to 50%.
NUMERICSponsored Display Campaign: Video Third Quartile ViewsThe number of impressions where the video was viewed to 75%.
NUMERICSponsored Display Campaign: Video UnmutesThe number of impressions where a customer unmuted the video.

Amazon Ads sponsored_display_targeting fields

The sponsored_display_targeting report of the Amazon Ads connector includes 19 fields.

IDTypeNameDescription
NUMERICSponsored Display Targeting: Total advertising cost of sales (ACoS)Total advertising cost of sales (cost divided by 14-day sales revenue)
TEXTSponsored Display Targeting: Ad Group IDThe ID associated with the ad group.
TEXTSponsored Display Targeting: Ad Group NameThe name of the ad group.
TEXTSponsored Display Targeting: Campaign IDThe ID associated with a campaign.
TEXTSponsored Display Targeting: Campaign NameThe name of the campaign.
NUMERICSponsored Display Targeting: ClicksTotal number of ad clicks.
NUMERICSponsored Display Targeting: CostTotal cost of all ad clicks.
NUMERICSponsored Display Targeting: Detail Page ViewsNumber of detail page views occurring within 14 days of an ad click or view.
NUMERICSponsored Display Targeting: ImpressionsTotal number of ad impressions.
TEXTSponsored Display Targeting: Portfolio IDThe identifier of the portfolio the campaign belongs to
TEXTSponsored Display Targeting: Portfolio nameThe name of the portfolio the campaign belongs to
NUMERICSponsored Display Targeting: PurchasesNumber of attributed conversion events occurring within 14 days of an ad click or view.
NUMERICSponsored Display Targeting: Return on advertising spend (RoAS)Return on advertising spend (14-day sales revenue divided by cost)
NUMERICSponsored Display Targeting: SalesTotal value of attributed sales occurring within 14 days of an ad click or view.
NUMERICSponsored Display Targeting: Spend (alias for Cost)Alias for Cost.
TEXTSponsored Display Targeting: Targeting expressionThe targeting expression, e.g. a product or audience target.
TEXTSponsored Display Targeting: Targeting IDThe ID of the targeting clause.
TEXTSponsored Display Targeting: Targeting textThe human-readable targeting expression.
NUMERICSponsored Display Targeting: Units SoldNumber of attributed units sold within 14 days of an ad click or view.

Amazon Ads sponsored_products_advertised_product fields

The sponsored_products_advertised_product report of the Amazon Ads connector includes 28 fields.

IDTypeNameDescription
NUMERICSponsored Products Advertised Product: Total advertising cost of sales (ACoS)Total advertising cost of sales (cost divided by 14-day sales revenue)
TEXTSponsored Products Advertised Product: Ad Group IDThe ID associated with the ad group.
TEXTSponsored Products Advertised Product: Ad Group NameThe name of the ad group.
TEXTSponsored Products Advertised Product: Ad IDThe ID associated with the product ad.
TEXTSponsored Products Advertised Product: Advertised ASINThe ASIN that is being advertised.
TEXTSponsored Products Advertised Product: Advertised SKUThe SKU that is being advertised.
TEXTSponsored Products Advertised Product: Campaign Budget Currency CodeThe currency code associated with the campaign budget.
TEXTSponsored Products Advertised Product: Campaign IDThe ID associated with a campaign.
TEXTSponsored Products Advertised Product: Campaign NameThe name of the campaign.
TEXTSponsored Products Advertised Product: Campaign targeting typeCampaign targeting type
NUMERICSponsored Products Advertised Product: ClicksTotal number of ad clicks.
NUMERICSponsored Products Advertised Product: CostTotal cost of all ad clicks.
NUMERICSponsored Products Advertised Product: ImpressionsTotal number of ad impressions.
TEXTSponsored Products Advertised Product: Portfolio IDThe identifier of the portfolio the campaign belongs to
TEXTSponsored Products Advertised Product: Portfolio nameThe name of the portfolio the campaign belongs to
NUMERICSponsored Products Advertised Product: Purchases (14 days)Total number of attributed conversion events occurring within 14 days of an ad click.
NUMERICSponsored Products Advertised Product: Purchases (1 day)Total number of attributed conversion events occurring within 24 hours of an ad click.
NUMERICSponsored Products Advertised Product: Purchases (30 days)Total number of attributed conversion events occurring within 30 days of an ad click.
NUMERICSponsored Products Advertised Product: Purchases (7 days)Total number of attributed conversion events occurring within 7 days of an ad click.
NUMERICSponsored Products Advertised Product: Return on advertising spend (RoAS)Return on advertising spend (14-day sales revenue divided by cost)
NUMERICSponsored Products Advertised Product: Sales (14 days)Total value of attributed sales occurring within 14 days of an ad click.
NUMERICSponsored Products Advertised Product: Sales (1 day)Total value of attributed sales occurring within 24 hours of an ad click.
NUMERICSponsored Products Advertised Product: Sales (30 days)Total value of attributed sales occurring within 30 days of an ad click.
NUMERICSponsored Products Advertised Product: Sales (7 days)Total value of attributed sales occurring within 7 days of an ad click.
NUMERICSponsored Products Advertised Product: Units Sold Clicks (14 days)Total number of attributed units sold within 14 days of an ad click.
NUMERICSponsored Products Advertised Product: Units Sold Clicks (1 day)Total number of attributed units sold within 24 hours of an ad click.
NUMERICSponsored Products Advertised Product: Units Sold Clicks (30 days)Total number of attributed units sold within 30 days of an ad click.
NUMERICSponsored Products Advertised Product: Units Sold Clicks (7 days)Total number of attributed units sold within 7 days of an ad click.

Amazon Ads sponsored_products_campaign fields

The sponsored_products_campaign report of the Amazon Ads connector includes 33 fields.

IDTypeNameDescription
NUMERICSponsored Products Campaign: Total advertising cost of sales (ACoS)Total advertising cost of sales (cost divided by 14-day sales revenue)
NUMERICSponsored Products Campaign: Ad Network ConversionsThe Ad Network Reported Conversions (alias for Attributed conversions for 1 day)
NUMERICSponsored Products Campaign: Ad Network RevenueThe Ad Network Reported Revenue (alias for Attributed sales for 1 day)
NUMERICSponsored Products Campaign: Attributed conversions (14 days)Total number of attributed conversion events occurring within 14 days of ad click
NUMERICSponsored Products Campaign: Attributed conversions (1 day)Total number of attributed conversion events occurring within 24 hours of ad click
NUMERICSponsored Products Campaign: Attributed conversions (30 days)Total number of attributed conversion events occurring within 30 days of ad click
NUMERICSponsored Products Campaign: Attributed conversions (7 days)Total number of attributed conversion events occurring within 7 days of ad click
NUMERICSponsored Products Campaign: Attributed sales (14 days)Aggregate value of attributed sales occurring within 14 days of click on ad
NUMERICSponsored Products Campaign: Attributed sales (1 day)Aggregate value of attributed sales occurring within 24 hours of click on ad
NUMERICSponsored Products Campaign: Attributed sales (30 days)Aggregate value of attributed sales occurring within 30 days of click on ad
NUMERICSponsored Products Campaign: Attributed sales (7 days)Aggregate value of attributed sales occurring within 7 days of click on ad
NUMERICSponsored Products Campaign: Attributed units ordered (14 days)Total number of attributed units ordered within 14 days of ad click
NUMERICSponsored Products Campaign: Attributed units ordered (1 day)Total number of attributed units ordered within 24 hours of ad click
NUMERICSponsored Products Campaign: Attributed units ordered (30 days)Total number of attributed units ordered within 30 days of ad click
NUMERICSponsored Products Campaign: Attributed units ordered (7 days)Total number of attributed units ordered within 7 days of ad click
TEXTSponsored Products Campaign: CampaignThe name of the campaign
NUMERICSponsored Products Campaign: Campaign budgetTotal budget allotted to the campaign
TEXTSponsored Products Campaign: Campaign statusThe current status of the campaign
TEXTSponsored Products Campaign: Campaign bidding strategyCampaign bidding strategy
NUMERICSponsored Products Campaign: Campaign daily budgetTotal daily budget for the campaign
TEXTSponsored Products Campaign: Campaign ID (duplicate)The unique identifier of the campaign. (duplicate)
TEXTSponsored Products Campaign: Campaign targeting typeCampaign targeting type
NUMERICSponsored Products Campaign: ClicksTotal number of ad clicks
NUMERICSponsored Products Campaign: CostTotal cost of all ad clicks
NUMERICSponsored Products Campaign: CPCCost-per-click (CPC)
PERCENTSponsored Products Campaign: CTRClick-through rate (CTR)
NUMERICSponsored Products Campaign: ImpressionsTotal number of ad impressions
NUMERICSponsored Products Campaign: KENP read (14 days)Number of Kindle Edition Normalized Pages (KENP) read within 14 days of ad click. Relevant to Kindle Direct Publishing (KDP) titles only
TEXTSponsored Products Campaign: Portfolio IDThe identifier of the portfolio the campaign belongs to
TEXTSponsored Products Campaign: Portfolio nameThe name of the portfolio the campaign belongs to
PERCENTSponsored Products Campaign: Total return on advertising spend (RoAS)Total return on advertising spend (14-day sales revenue divided by cost)
NUMERICSponsored Products Campaign: Spend (alias for Cost)Alias for Cost
NUMERICSponsored Products Campaign: Total CostAlias for Cost

Amazon Ads sponsored_products_placement fields

The sponsored_products_placement report of the Amazon Ads connector includes 26 fields.

IDTypeNameDescription
NUMERICSponsored Products Placement: Total advertising cost of sales (ACoS)Total advertising cost of sales (cost divided by 14-day sales revenue)
NUMERICSponsored Products Placement: Ad Network ConversionsThe Ad Network Reported Conversions (alias for Attributed conversions for 1 day)
NUMERICSponsored Products Placement: Ad Network RevenueThe Ad Network Reported Revenue (alias for Attributed sales for 1 day)
NUMERICSponsored Products Placement: Attributed conversions (14 days)Total number of attributed conversion events occurring within 14 days of ad click
NUMERICSponsored Products Placement: Attributed conversions (1 day)Total number of attributed conversion events occurring within 24 hours of ad click
NUMERICSponsored Products Placement: Attributed conversions (30 days)Total number of attributed conversion events occurring within 30 days of ad click
NUMERICSponsored Products Placement: Attributed conversions (7 days)Total number of attributed conversion events occurring within 7 days of ad click
NUMERICSponsored Products Placement: Attributed sales (14 days)Aggregate value of attributed sales occurring within 14 days of click on ad
NUMERICSponsored Products Placement: Attributed sales (1 day)Aggregate value of attributed sales occurring within 24 hours of click on ad
NUMERICSponsored Products Placement: Attributed sales (30 days)Aggregate value of attributed sales occurring within 30 days of click on ad
NUMERICSponsored Products Placement: Attributed sales (7 days)Aggregate value of attributed sales occurring within 7 days of click on ad
NUMERICSponsored Products Placement: Attributed units ordered (14 days)Total number of attributed units ordered within 14 days of ad click
NUMERICSponsored Products Placement: Attributed units ordered (1 day)Total number of attributed units ordered within 24 hours of ad click
NUMERICSponsored Products Placement: Attributed units ordered (30 days)Total number of attributed units ordered within 30 days of ad click
NUMERICSponsored Products Placement: Attributed units ordered (7 days)Total number of attributed units ordered within 7 days of ad click
TEXTSponsored Products Placement: CampaignThe name of the campaign
TEXTSponsored Products Placement: Campaign IDThe unique identifier of the campaign.
NUMERICSponsored Products Placement: ClicksTotal number of ad clicks
NUMERICSponsored Products Placement: CostTotal cost of all ad clicks
NUMERICSponsored Products Placement: CPCCost-per-click (CPC)
PERCENTSponsored Products Placement: CTRClick-through rate (CTR)
NUMERICSponsored Products Placement: ImpressionsTotal number of ad impressions
TEXTSponsored Products Placement: PlacementAd placement classification, one of: Top of Search, Product Pages, Other
PERCENTSponsored Products Placement: Total return on advertising spend (RoAS)Total return on advertising spend (14-day sales revenue divided by cost)
NUMERICSponsored Products Placement: Spend (alias for Cost)Alias for Cost
NUMERICSponsored Products Placement: Total CostAlias for Cost

Amazon Ads sponsored_products_search_term fields

The sponsored_products_search_term report of the Amazon Ads connector includes 33 fields.

IDTypeNameDescription
NUMERICSponsored Products Search Term: ACoSAdvertising cost of sales (cost divided by 14-day sales).
TEXTSponsored Products Search Term: Ad Group IDThe ID associated with an ad group.
TEXTSponsored Products Search Term: Ad Group NameThe name of the ad group.
TEXTSponsored Products Search Term: Keyword StatusThe current status of the keyword or target.
TEXTSponsored Products Search Term: Campaign Budget Currency CodeThe currency code associated with the campaign budget.
TEXTSponsored Products Search Term: Campaign IDThe ID associated with a campaign.
TEXTSponsored Products Search Term: Campaign NameThe name of the campaign.
NUMERICSponsored Products Search Term: ClicksTotal number of ad clicks.
NUMERICSponsored Products Search Term: CostTotal cost of all ad clicks.
NUMERICSponsored Products Search Term: CPCCost-per-click (CPC).
PERCENTSponsored Products Search Term: CTRClick-through rate (CTR).
NUMERICSponsored Products Search Term: ImpressionsTotal number of ad impressions.
TEXTSponsored Products Search Term: Keyword IDThe ID of the keyword or target. Null for some auto-targeting rows.
TEXTSponsored Products Search Term: Keyword TextThe keyword text, or the auto-targeting expression (e.g. loose-match) for auto campaigns.
TEXTSponsored Products Search Term: Keyword TypeThe type of the keyword or target.
TEXTSponsored Products Search Term: Match TypeThe match type of the keyword or target.
NUMERICSponsored Products Search Term: Purchases (14 days)Number of attributed conversion events within 14 days of an ad click.
NUMERICSponsored Products Search Term: Purchases (1 day)Number of attributed conversion events within 24 hours of an ad click.
NUMERICSponsored Products Search Term: Purchases (30 days)Number of attributed conversion events within 30 days of an ad click.
NUMERICSponsored Products Search Term: Purchases (7 days)Number of attributed conversion events within 7 days of an ad click.
PERCENTSponsored Products Search Term: RoASReturn on advertising spend (14-day sales divided by cost).
NUMERICSponsored Products Search Term: Sales (14 days)Total value of attributed sales within 14 days of an ad click.
NUMERICSponsored Products Search Term: Sales (1 day)Total value of attributed sales within 24 hours of an ad click.
NUMERICSponsored Products Search Term: Sales (30 days)Total value of attributed sales within 30 days of an ad click.
NUMERICSponsored Products Search Term: Sales (7 days)Total value of attributed sales within 7 days of an ad click.
TEXTSponsored Products Search Term: Search TermThe customer search term that resulted in an ad click.
NUMERICSponsored Products Search Term: Spend (alias for Cost)Alias for Cost.
TEXTSponsored Products Search Term: TargetingThe targeting expression that served the ad.
NUMERICSponsored Products Search Term: Total CostAlias for Cost.
NUMERICSponsored Products Search Term: Units Sold Clicks (14 days)Number of attributed units sold within 14 days of an ad click.
NUMERICSponsored Products Search Term: Units Sold Clicks (1 day)Number of attributed units sold within 24 hours of an ad click.
NUMERICSponsored Products Search Term: Units Sold Clicks (30 days)Number of attributed units sold within 30 days of an ad click.
NUMERICSponsored Products Search Term: Units Sold Clicks (7 days)Number of attributed units sold within 7 days of an ad click.

Amazon Ads sponsored_products_targeting fields

The sponsored_products_targeting report of the Amazon Ads connector includes 28 fields.

IDTypeNameDescription
NUMERICSponsored Products Targeting: Total advertising cost of sales (ACoS)Total advertising cost of sales (cost divided by 14-day sales revenue)
TEXTSponsored Products Targeting: Ad Group IDThe ID associated with the ad group.
TEXTSponsored Products Targeting: Ad Group NameThe name of the ad group.
TEXTSponsored Products Targeting: Keyword StatusThe current status of the keyword or target.
TEXTSponsored Products Targeting: Campaign IDThe ID associated with a campaign.
TEXTSponsored Products Targeting: Campaign NameThe name of the campaign.
NUMERICSponsored Products Targeting: ClicksTotal number of ad clicks.
NUMERICSponsored Products Targeting: CostTotal cost of all ad clicks.
NUMERICSponsored Products Targeting: ImpressionsTotal number of ad impressions.
TEXTSponsored Products Targeting: KeywordThe keyword text used for bidding on targeted searches.
TEXTSponsored Products Targeting: Keyword or target IDThe ID of the keyword or targeting clause.
TEXTSponsored Products Targeting: Targeting typeThe type of the targeting clause (keyword or product target).
TEXTSponsored Products Targeting: Match TypeThe match type of the keyword or target.
TEXTSponsored Products Targeting: Portfolio IDThe identifier of the portfolio the campaign belongs to
TEXTSponsored Products Targeting: Portfolio nameThe name of the portfolio the campaign belongs to
NUMERICSponsored Products Targeting: Purchases (14 days)Total number of attributed conversion events occurring within 14 days of an ad click.
NUMERICSponsored Products Targeting: Purchases (1 day)Total number of attributed conversion events occurring within 24 hours of an ad click.
NUMERICSponsored Products Targeting: Purchases (30 days)Total number of attributed conversion events occurring within 30 days of an ad click.
NUMERICSponsored Products Targeting: Purchases (7 days)Total number of attributed conversion events occurring within 7 days of an ad click.
NUMERICSponsored Products Targeting: Return on advertising spend (RoAS)Return on advertising spend (14-day sales revenue divided by cost)
NUMERICSponsored Products Targeting: Sales (14 days)Total value of attributed sales occurring within 14 days of an ad click.
NUMERICSponsored Products Targeting: Sales (1 day)Total value of attributed sales occurring within 24 hours of an ad click.
NUMERICSponsored Products Targeting: Sales (30 days)Total value of attributed sales occurring within 30 days of an ad click.
NUMERICSponsored Products Targeting: Sales (7 days)Total value of attributed sales occurring within 7 days of an ad click.
NUMERICSponsored Products Targeting: Spend (alias for Cost)Alias for Cost.
TEXTSponsored Products Targeting: Targeting expressionThe targeting expression, e.g. a product ASIN or category target.
PERCENTSponsored Products Targeting: Top-of-search impression shareShare of top-of-search impressions the keyword or target received out of all available top-of-search impressions.
NUMERICSponsored Products Targeting: Units Sold Clicks (14 days)Total number of attributed units sold within 14 days of an ad click.

Amazon Ads other fields

The Amazon Ads connector has 24 fields that do not belong to a named report, or belong to a report with only one or two fields.

IDTypeNameDescriptionReport
account_idTEXTAccount IDThe Account ID
account_nameTEXTAccount NameThe Account Name
ad_typeTEXTAd typeOne of: Sponsored Brands, Sponsored Display, Sponsored Products
data_fetched_atTIMESTAMPData fetched atUTC timestamp (second precision) of when the connector request that pulled the row started. Freshly pulled rows show this request's start time; cache hits keep the start time of the request that filled the cache. Selecting this field disables aggregation, so rows are returned individually (each keeping its own fetch time) instead of being summed.
datasourceTEXTData SourceThe name of the Windsor connector returning the row
dateDATEDateDate
day_of_monthTEXTDay of monthDay of the month
marketplaceTEXTMarketplaceAmazon marketplace (country) name
monthTEXTMonthNumber of the month
nowTIMESTAMPNowCurrent timestamp
profileidTEXTProfile IDAmazon Advertising profile ID
sourceTEXTSourceThe name of the Windsor connector returning the row
todayDATETodayToday's date
weekTEXTWeekWeek (Sun-Sat).
week_dayTEXTDay of week and day numberWeekday number and name combined (Sun-Sat).Numbered from 0 Sunday to 6 Saturday.
week_day_isoTEXTDay of week and day number, ISOWeekday number and name combined, ISO format (Mon-Sun).Numbered from 1 Monday to 7
week_isoTEXTWeek ISOWeek, ISO format (Mon-Sun).
yearTEXTYearYear
year_monthTEXTYearmonthYear and month, e.g. 2024|3
year_month_nameTEXTYear month nameYear and month with the month name written out, e.g. "Jan 2025".
year_of_weekTEXTYear of weekThe year that contains first day of the week (Sun-Sat).
year_of_week_isoTEXTYear of week, ISOThe year that contains first day of the ISO week (Mon-Sun).
year_weekTEXTYear weekYear and week for US weeks (Sun-Sat), e.g. 2024|15
year_week_isoTEXTYear week ISOYear and week for ISO weeks (Mon-Sun), e.g. 2024|20