Amazon Ads Connector Reference

84 metrics38 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 122 fields (84 metrics, 38 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.

ID Type Name Description
NUMERIC Sponsored Brands Ad: Total advertising cost of sales (ACoS) Total advertising cost of sales (cost divided by sales)
TEXT Sponsored Brands Ad: Ad Group ID The ID associated with the ad group.
TEXT Sponsored Brands Ad: Ad Group Name The name of the ad group.
TEXT Sponsored Brands Ad: Ad ID The ID associated with the ad.
NUMERIC Sponsored Brands Ad: Branded Searches Number of searches for keywords associated with the brand.
TEXT Sponsored Brands Ad: Campaign ID The ID associated with a campaign.
TEXT Sponsored Brands Ad: Campaign Name The name of the campaign.
TEXT Sponsored Brands Ad: Campaign Status The state of the campaign.
NUMERIC Sponsored Brands Ad: Clicks Total number of ad clicks.
NUMERIC Sponsored Brands Ad: Cost Total cost of ad clicks.
NUMERIC Sponsored Brands Ad: CPC Cost-per-click (CPC)
PERCENT Sponsored Brands Ad: CTR Click-through rate (CTR)
NUMERIC Sponsored Brands Ad: Detail Page Views Number of detail page views attributed to the ad.
NUMERIC Sponsored Brands Ad: Impressions Total number of ad impressions.
TEXT Sponsored Brands Ad: Portfolio ID The identifier of the portfolio the campaign belongs to
TEXT Sponsored Brands Ad: Portfolio name The name of the portfolio the campaign belongs to
NUMERIC Sponsored Brands Ad: Purchases Total number of attributed conversion events occurring within 14 days of an ad click or view.
NUMERIC Sponsored Brands Ad: Return on advertising spend (RoAS) Return on advertising spend (sales divided by cost)
NUMERIC Sponsored Brands Ad: Sales Total 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.

ID Type Name Description
NUMERIC Sponsored Brands Ad Group: Total advertising cost of sales (ACoS) Total advertising cost of sales (cost divided by sales)
TEXT Sponsored Brands Ad Group: Ad Group ID The ID associated with the ad group.
TEXT Sponsored Brands Ad Group: Ad Group Name The name of the ad group.
NUMERIC Sponsored Brands Ad Group: Branded Searches Number of searches for keywords associated with the brand.
TEXT Sponsored Brands Ad Group: Campaign ID The ID associated with a campaign.
TEXT Sponsored Brands Ad Group: Campaign Name The name of the campaign.
NUMERIC Sponsored Brands Ad Group: Clicks Total number of ad clicks.
NUMERIC Sponsored Brands Ad Group: Cost Total cost of ad clicks.
NUMERIC Sponsored Brands Ad Group: CPC Cost-per-click (CPC)
PERCENT Sponsored Brands Ad Group: CTR Click-through rate (CTR)
NUMERIC Sponsored Brands Ad Group: Detail Page Views Number of detail page views attributed to the ad.
NUMERIC Sponsored Brands Ad Group: Impressions Total number of ad impressions.
TEXT Sponsored Brands Ad Group: Portfolio ID The identifier of the portfolio the campaign belongs to
TEXT Sponsored Brands Ad Group: Portfolio name The name of the portfolio the campaign belongs to
NUMERIC Sponsored Brands Ad Group: Purchases Total number of attributed conversion events occurring within 14 days of an ad click or view.
NUMERIC Sponsored Brands Ad Group: Return on advertising spend (RoAS) Return on advertising spend (sales divided by cost)
NUMERIC Sponsored Brands Ad Group: Sales Total 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.

ID Type Name Description
NUMERIC Sponsored Brands Campaign Non Video: Total advertising cost of sales (ACoS) Total advertising cost of sales (cost divided by 14-day sales revenue)
NUMERIC Sponsored Brands Campaign Non Video: Attributed conversions (14 days) Total number of attributed conversion events occurring within 14 days of ad click
PERCENT Sponsored 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)
NUMERIC Sponsored 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
NUMERIC Sponsored Brands Campaign Non Video: Attributed new-to-brand orders share (14 days) The percentage of total orders that are new-to-brand orders
NUMERIC Sponsored Brands Campaign Non Video: Attributed sales (14 days) Aggregate value of attributed sales occurring within 14 days of click on ad
NUMERIC Sponsored 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
PERCENT Sponsored Brands Campaign Non Video: Attributed new-to-brand sales share (14 days) The percentage of total sales of new-to-brand purchases
NUMERIC Sponsored 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
NUMERIC Sponsored 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
NUMERIC Sponsored Brands Campaign Non Video: Attributed units sold (14 days) Number of attributed units sold occurring within 14 days of click on an ad
TEXT Sponsored Brands Campaign Non Video: Campaign The name of the campaign
NUMERIC Sponsored Brands Campaign Non Video: Campaign budget Total budget allotted to the campaign
TEXT Sponsored Brands Campaign Non Video: Campaign budget type One of: daily or lifetime
TEXT Sponsored Brands Campaign Non Video: Campaign status The current status of the campaign
TEXT Sponsored Brands Campaign Non Video: Campaign ad format Campaign ad format
TEXT Sponsored Brands Campaign Non Video: Campaign ID (duplicate) The unique identifier of the campaign. (duplicate)
NUMERIC Sponsored Brands Campaign Non Video: Clicks Total number of ad clicks
NUMERIC Sponsored Brands Campaign Non Video: Cost Total cost of all ad clicks
NUMERIC Sponsored Brands Campaign Non Video: CPC Cost-per-click (CPC)
PERCENT Sponsored Brands Campaign Non Video: CTR Click-through rate (CTR)
NUMERIC Sponsored Brands Campaign Non Video: Impressions Total number of ad impressions
TEXT Sponsored Brands Campaign Non Video: Portfolio ID The identifier of the portfolio the campaign belongs to
TEXT Sponsored Brands Campaign Non Video: Portfolio name The name of the portfolio the campaign belongs to
PERCENT Sponsored Brands Campaign Non Video: Total return on advertising spend (RoAS) Total return on advertising spend (14-day sales revenue divided by cost)
NUMERIC Sponsored Brands Campaign Non Video: Spend (alias for Cost) Alias for Cost
NUMERIC Sponsored Brands Campaign Non Video: Total Cost Alias for Cost

Amazon Ads sponsored_brands_campaign_video fields

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

ID Type Name Description
NUMERIC Sponsored Brands Campaign Video: Total advertising cost of sales (ACoS) Total advertising cost of sales (cost divided by sales)
NUMERIC Sponsored Brands Campaign Video: Branded Searches Number of searches that included the name of your brand occurring within 14 days of an ad click or view.
TEXT Sponsored Brands Campaign Video: Campaign The name of the campaign
NUMERIC Sponsored Brands Campaign Video: Campaign budget Amount Total budget allotted to the campaign
TEXT Sponsored Brands Campaign Video: Campaign budget currency code The currency code associated with the campaign.
TEXT Sponsored Brands Campaign Video: Campaign budget type One of: daily or lifetime
TEXT Sponsored Brands Campaign Video: Campaign status The current status of the campaign
TEXT Sponsored Brands Campaign Video: Campaign ad format Campaign ad format
TEXT Sponsored Brands Campaign Video: Campaign ID (duplicate) The unique identifier of the campaign. (duplicate)
NUMERIC Sponsored Brands Campaign Video: Clicks Total number of ad clicks
NUMERIC Sponsored Brands Campaign Video: Cost Total cost of all ad clicks
NUMERIC Sponsored Brands Campaign Video: CPC Cost-per-click (CPC)
PERCENT Sponsored Brands Campaign Video: CTR Click-through rate (CTR)
NUMERIC Sponsored Brands Campaign Video: Detail Page Views Number of detail page views occurring within 14 days of an ad click or view.
NUMERIC Sponsored Brands Campaign Video: Impressions Total number of ad impressions
NUMERIC Sponsored 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
TEXT Sponsored Brands Campaign Video: Portfolio ID The identifier of the portfolio the campaign belongs to
TEXT Sponsored Brands Campaign Video: Portfolio name The name of the portfolio the campaign belongs to
NUMERIC Sponsored Brands Campaign Video: Purchases Number of attributed conversion events occurring within 14 days of an ad click or view.
NUMERIC Sponsored Brands Campaign Video: Return on advertising spend (RoAS) Return on advertising spend (sales divided by cost)
NUMERIC Sponsored Brands Campaign Video: Sales Total value of sales occurring within 14 days of an ad click or view.
NUMERIC Sponsored Brands Campaign Video: Spend (alias for Cost) Alias for Cost
NUMERIC Sponsored Brands Campaign Video: Total Cost Alias for Cost

Amazon Ads sponsored_brands_purchased_product fields

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

ID Type Name Description
TEXT Sponsored Brands Purchased Product: Campaign Budget Currency Code The currency code associated with the campaign budget.
TEXT Sponsored Brands Purchased Product: Campaign ID The ID associated with a campaign.
TEXT Sponsored Brands Purchased Product: Campaign Name The name of the campaign.
NUMERIC Sponsored Brands Purchased Product: Orders (14 days) Total number of attributed orders within 14 days of an ad click.
TEXT Sponsored Brands Purchased Product: Portfolio ID The identifier of the portfolio the campaign belongs to
TEXT Sponsored Brands Purchased Product: Portfolio name The name of the portfolio the campaign belongs to
TEXT Sponsored Brands Purchased Product: Purchased ASIN The ASIN that customers purchased after an ad click or view.
NUMERIC Sponsored Brands Purchased Product: Sales (14 days) Total value of attributed sales occurring within 14 days of an ad click.
NUMERIC Sponsored 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.

ID Type Name Description
NUMERIC Sponsored Brands Search Term: ACoS Advertising cost of sales (cost divided by sales).
TEXT Sponsored Brands Search Term: Ad Group ID The ID associated with an ad group.
TEXT Sponsored Brands Search Term: Ad Group Name The name of the ad group.
TEXT Sponsored Brands Search Term: Keyword Status The current status of the keyword.
TEXT Sponsored Brands Search Term: Campaign Budget Currency Code The currency code associated with the campaign budget.
TEXT Sponsored Brands Search Term: Campaign ID The ID associated with a campaign.
TEXT Sponsored Brands Search Term: Campaign Name The name of the campaign.
NUMERIC Sponsored Brands Search Term: Clicks Total number of ad clicks.
NUMERIC Sponsored Brands Search Term: Cost Total cost of all ad clicks.
NUMERIC Sponsored Brands Search Term: CPC Cost-per-click (CPC).
PERCENT Sponsored Brands Search Term: CTR Click-through rate (CTR).
NUMERIC Sponsored Brands Search Term: Impressions Total number of ad impressions.
TEXT Sponsored Brands Search Term: Keyword ID The ID of the keyword.
TEXT Sponsored Brands Search Term: Keyword Text The keyword text that served the ad.
TEXT Sponsored Brands Search Term: Match Type The match type of the keyword.
NUMERIC Sponsored Brands Search Term: Purchases Number of attributed conversion events within 14 days of an ad click or view.
PERCENT Sponsored Brands Search Term: RoAS Return on advertising spend (sales divided by cost).
NUMERIC Sponsored Brands Search Term: Sales Total value of attributed sales within 14 days of an ad click or view.
TEXT Sponsored Brands Search Term: Search Term The customer search term that resulted in an ad click.
NUMERIC Sponsored Brands Search Term: Spend (alias for Cost) Alias for Cost.
NUMERIC Sponsored Brands Search Term: Total Cost Alias for Cost.

Amazon Ads sponsored_brands_targeting fields

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

ID Type Name Description
NUMERIC Sponsored Brands Targeting: Total advertising cost of sales (ACoS) Total advertising cost of sales (cost divided by sales)
TEXT Sponsored Brands Targeting: Ad Group ID The ID associated with the ad group.
TEXT Sponsored Brands Targeting: Ad Group Name The name of the ad group.
TEXT Sponsored Brands Targeting: Campaign ID The ID associated with a campaign.
TEXT Sponsored Brands Targeting: Campaign Name The name of the campaign.
NUMERIC Sponsored Brands Targeting: Clicks Total number of ad clicks.
NUMERIC Sponsored Brands Targeting: Cost Total cost of all ad clicks.
NUMERIC Sponsored Brands Targeting: Impressions Total number of ad impressions.
TEXT Sponsored Brands Targeting: Keyword or target ID The ID of the keyword or targeting clause.
TEXT Sponsored Brands Targeting: Keyword The keyword text used for bidding on targeted searches.
TEXT Sponsored Brands Targeting: Match type The keyword match type (broad, phrase or exact).
TEXT Sponsored Brands Targeting: Portfolio ID The identifier of the portfolio the campaign belongs to
TEXT Sponsored Brands Targeting: Portfolio name The name of the portfolio the campaign belongs to
NUMERIC Sponsored Brands Targeting: Purchases Number of attributed conversion events occurring within 14 days of an ad click or view.
NUMERIC Sponsored Brands Targeting: Return on advertising spend (RoAS) Return on advertising spend (sales divided by cost)
NUMERIC Sponsored Brands Targeting: Sales Total value of sales occurring within 14 days of an ad click or view.
NUMERIC Sponsored Brands Targeting: Spend (alias for Cost) Alias for Cost.
TEXT Sponsored Brands Targeting: Targeting expression The targeting expression, e.g. a product or category target.
TEXT Sponsored Brands Targeting: Targeting ID The ID of the targeting clause.
TEXT Sponsored Brands Targeting: Targeting text The 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.

ID Type Name Description
NUMERIC Sponsored Display Ad Group: Total advertising cost of sales (ACoS) Total advertising cost of sales (cost divided by sales)
TEXT Sponsored Display Ad Group: Ad Group ID The ID associated with the ad group.
TEXT Sponsored Display Ad Group: Ad Group Name The name of the ad group.
NUMERIC Sponsored Display Ad Group: Branded Searches Number of searches for keywords associated with the brand.
TEXT Sponsored Display Ad Group: Campaign ID The ID associated with a campaign.
TEXT Sponsored Display Ad Group: Campaign Name The name of the campaign.
NUMERIC Sponsored Display Ad Group: Clicks Total number of ad clicks.
NUMERIC Sponsored Display Ad Group: Cost Total cost of ad clicks.
NUMERIC Sponsored Display Ad Group: CPC Cost-per-click (CPC)
PERCENT Sponsored Display Ad Group: CTR Click-through rate (CTR)
NUMERIC Sponsored Display Ad Group: Detail Page Views Number of detail page views attributed to the ad.
NUMERIC Sponsored Display Ad Group: Impressions Total number of ad impressions.
TEXT Sponsored Display Ad Group: Portfolio ID The identifier of the portfolio the campaign belongs to
TEXT Sponsored Display Ad Group: Portfolio name The name of the portfolio the campaign belongs to
NUMERIC Sponsored Display Ad Group: Purchases Total number of attributed conversion events occurring within 14 days of an ad click or view.
NUMERIC Sponsored Display Ad Group: Return on advertising spend (RoAS) Return on advertising spend (sales divided by cost)
NUMERIC Sponsored Display Ad Group: Sales Total value of attributed sales occurring within 14 days of an ad click or view.
NUMERIC Sponsored Display Ad Group: Units Sold Total 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.

ID Type Name Description
NUMERIC Sponsored Display Advertised Product: Total advertising cost of sales (ACoS) Total advertising cost of sales (cost divided by 14-day sales revenue)
TEXT Sponsored Display Advertised Product: Ad Group ID The ID associated with the ad group.
TEXT Sponsored Display Advertised Product: Ad Group Name The name of the ad group.
TEXT Sponsored Display Advertised Product: Ad ID The ID associated with the ad.
TEXT Sponsored Display Advertised Product: Campaign Budget Currency Code The currency code associated with the campaign budget.
TEXT Sponsored Display Advertised Product: Campaign ID The ID associated with a campaign.
NUMERIC Sponsored Display Advertised Product: Clicks Total number of ad clicks.
NUMERIC Sponsored Display Advertised Product: Cost Total cost of ad clicks.
NUMERIC Sponsored Display Advertised Product: Impressions Total number of ad impressions.
TEXT Sponsored Display Advertised Product: Portfolio ID The identifier of the portfolio the campaign belongs to
TEXT Sponsored Display Advertised Product: Portfolio name The name of the portfolio the campaign belongs to
TEXT Sponsored Display Advertised Product: Promoted ASIN The ASIN being promoted.
TEXT Sponsored Display Advertised Product: Promoted SKU The SKU being promoted.
NUMERIC Sponsored Display Advertised Product: Purchases Total number of attributed conversion events occurring within 14 days of an ad click or view.
NUMERIC Sponsored Display Advertised Product: Return on advertising spend (RoAS) Return on advertising spend (14-day sales revenue divided by cost)
NUMERIC Sponsored Display Advertised Product: Sales Total value of attributed sales occurring within 14 days of an ad click or view.
NUMERIC Sponsored Display Advertised Product: Units Sold Total 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.

ID Type Name Description
NUMERIC Sponsored Display Campaign: Total advertising cost of sales (ACoS) Total advertising cost of sales (cost divided by 14-day sales revenue)
NUMERIC Sponsored Display Campaign: Branded Searches The number of searches that included the name of your brand occurring within 14 days of an ad click or view.
NUMERIC Sponsored Display Campaign: Branded Searches Clicks The number of searches that included the name of your brand occurring within 14 days of an ad click.
NUMERIC Sponsored Display Campaign: Branded Searches Views The 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.
TEXT Sponsored Display Campaign: Campaign Id The ID associated with a campaign.
TEXT Sponsored Display Campaign: Campaign Name The name associated with a campaign.
NUMERIC Sponsored Display Campaign: Clicks Total number of clicks on an ad.
NUMERIC Sponsored Display Campaign: Cost Total cost of ad clicks.
NUMERIC Sponsored Display Campaign: Detail Page Views Number of detail page views occurring within 14 days of an ad click or view.
NUMERIC Sponsored Display Campaign: Detail Page Views Clicks Number of detail page views occurring within 14 days of an ad click.
NUMERIC Sponsored Display Campaign: Impressions Total number of ad impressions.
NUMERIC Sponsored Display Campaign: Impressions Views Number of impressions that met the Media Ratings Council (MRC) viewability standard. See viewability details at https://advertising.amazon.com/library/guides/viewability
NUMERIC Sponsored Display Campaign: KENP read Number of Kindle Edition Normalized Pages (KENP) read within 14 days of an ad click or view. Relevant to Kindle Direct Publishing (KDP) titles only
NUMERIC Sponsored Display Campaign: New To Brand Purchases The 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.
NUMERIC Sponsored Display Campaign: New To Brand Purchases Clicks The number of first-time orders for brand products over a one-year lookback window resulting from an ad click. Not available for book vendors.
NUMERIC Sponsored Display Campaign: New To Brand Sales Clicks Total value of new-to-brand sales occurring within 14 days of an ad click. Not available for book vendors.
NUMERIC Sponsored Display Campaign: New To Brand Units Sold Total 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.
NUMERIC Sponsored Display Campaign: New To Brand Units Sold Clicks Total 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.
TEXT Sponsored Display Campaign: Portfolio ID The identifier of the portfolio the campaign belongs to
TEXT Sponsored Display Campaign: Portfolio name The name of the portfolio the campaign belongs to
NUMERIC Sponsored Display Campaign: Purchases Number of attributed conversion events occurring within 14 days of an ad click or view.
NUMERIC Sponsored Display Campaign: Purchases Clicks Number of attributed conversion events occurring within 14 days of an ad click.
NUMERIC Sponsored Display Campaign: Purchases Promoted Clicks Number of attributed conversion events occurring within 14 days of ad click where the purchased SKU was the same as the SKU advertised.
NUMERIC Sponsored Display Campaign: Return on advertising spend (RoAS) Return on advertising spend (14-day sales revenue divided by cost)
NUMERIC Sponsored Display Campaign: Sales Total value of sales occurring within 14 days of an ad click or view.
NUMERIC Sponsored Display Campaign: Sales Clicks Total value of sales occurring within 14 days of an ad click.
NUMERIC Sponsored Display Campaign: Sales Promoted Clicks Total value of sales occurring within 14 days of ad click where the purchased SKU was the same as the SKU advertised.
NUMERIC Sponsored Display Campaign: Units Sold Number of attributed units sold within 14 days of an ad click or view.
NUMERIC Sponsored Display Campaign: Video Complete Views The number of impressions where the video was viewed to 100%.
NUMERIC Sponsored Display Campaign: Video First Quartile Views The number of impressions where the video was viewed to 25%.
NUMERIC Sponsored Display Campaign: Video Midpoint Views The number of impressions where the video was viewed to 50%.
NUMERIC Sponsored Display Campaign: Video Third Quartile Views The number of impressions where the video was viewed to 75%.
NUMERIC Sponsored Display Campaign: Video Unmutes The 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.

ID Type Name Description
NUMERIC Sponsored Display Targeting: Total advertising cost of sales (ACoS) Total advertising cost of sales (cost divided by 14-day sales revenue)
TEXT Sponsored Display Targeting: Ad Group ID The ID associated with the ad group.
TEXT Sponsored Display Targeting: Ad Group Name The name of the ad group.
TEXT Sponsored Display Targeting: Campaign ID The ID associated with a campaign.
TEXT Sponsored Display Targeting: Campaign Name The name of the campaign.
NUMERIC Sponsored Display Targeting: Clicks Total number of ad clicks.
NUMERIC Sponsored Display Targeting: Cost Total cost of all ad clicks.
NUMERIC Sponsored Display Targeting: Detail Page Views Number of detail page views occurring within 14 days of an ad click or view.
NUMERIC Sponsored Display Targeting: Impressions Total number of ad impressions.
TEXT Sponsored Display Targeting: Portfolio ID The identifier of the portfolio the campaign belongs to
TEXT Sponsored Display Targeting: Portfolio name The name of the portfolio the campaign belongs to
NUMERIC Sponsored Display Targeting: Purchases Number of attributed conversion events occurring within 14 days of an ad click or view.
NUMERIC Sponsored Display Targeting: Return on advertising spend (RoAS) Return on advertising spend (14-day sales revenue divided by cost)
NUMERIC Sponsored Display Targeting: Sales Total value of attributed sales occurring within 14 days of an ad click or view.
NUMERIC Sponsored Display Targeting: Spend (alias for Cost) Alias for Cost.
TEXT Sponsored Display Targeting: Targeting expression The targeting expression, e.g. a product or audience target.
TEXT Sponsored Display Targeting: Targeting ID The ID of the targeting clause.
TEXT Sponsored Display Targeting: Targeting text The human-readable targeting expression.
NUMERIC Sponsored Display Targeting: Units Sold Number 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.

ID Type Name Description
NUMERIC Sponsored Products Advertised Product: Total advertising cost of sales (ACoS) Total advertising cost of sales (cost divided by 14-day sales revenue)
TEXT Sponsored Products Advertised Product: Ad Group ID The ID associated with the ad group.
TEXT Sponsored Products Advertised Product: Ad Group Name The name of the ad group.
TEXT Sponsored Products Advertised Product: Ad ID The ID associated with the product ad.
TEXT Sponsored Products Advertised Product: Advertised ASIN The ASIN that is being advertised.
TEXT Sponsored Products Advertised Product: Advertised SKU The SKU that is being advertised.
TEXT Sponsored Products Advertised Product: Campaign Budget Currency Code The currency code associated with the campaign budget.
TEXT Sponsored Products Advertised Product: Campaign ID The ID associated with a campaign.
TEXT Sponsored Products Advertised Product: Campaign Name The name of the campaign.
TEXT Sponsored Products Advertised Product: Campaign targeting type Campaign targeting type
NUMERIC Sponsored Products Advertised Product: Clicks Total number of ad clicks.
NUMERIC Sponsored Products Advertised Product: Cost Total cost of all ad clicks.
NUMERIC Sponsored Products Advertised Product: Impressions Total number of ad impressions.
TEXT Sponsored Products Advertised Product: Portfolio ID The identifier of the portfolio the campaign belongs to
TEXT Sponsored Products Advertised Product: Portfolio name The name of the portfolio the campaign belongs to
NUMERIC Sponsored Products Advertised Product: Purchases (14 days) Total number of attributed conversion events occurring within 14 days of an ad click.
NUMERIC Sponsored Products Advertised Product: Purchases (1 day) Total number of attributed conversion events occurring within 24 hours of an ad click.
NUMERIC Sponsored Products Advertised Product: Purchases (30 days) Total number of attributed conversion events occurring within 30 days of an ad click.
NUMERIC Sponsored Products Advertised Product: Purchases (7 days) Total number of attributed conversion events occurring within 7 days of an ad click.
NUMERIC Sponsored Products Advertised Product: Return on advertising spend (RoAS) Return on advertising spend (14-day sales revenue divided by cost)
NUMERIC Sponsored Products Advertised Product: Sales (14 days) Total value of attributed sales occurring within 14 days of an ad click.
NUMERIC Sponsored Products Advertised Product: Sales (1 day) Total value of attributed sales occurring within 24 hours of an ad click.
NUMERIC Sponsored Products Advertised Product: Sales (30 days) Total value of attributed sales occurring within 30 days of an ad click.
NUMERIC Sponsored Products Advertised Product: Sales (7 days) Total value of attributed sales occurring within 7 days of an ad click.
NUMERIC Sponsored Products Advertised Product: Units Sold Clicks (14 days) Total number of attributed units sold within 14 days of an ad click.
NUMERIC Sponsored Products Advertised Product: Units Sold Clicks (1 day) Total number of attributed units sold within 24 hours of an ad click.
NUMERIC Sponsored Products Advertised Product: Units Sold Clicks (30 days) Total number of attributed units sold within 30 days of an ad click.
NUMERIC Sponsored 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.

ID Type Name Description
NUMERIC Sponsored Products Campaign: Total advertising cost of sales (ACoS) Total advertising cost of sales (cost divided by 14-day sales revenue)
NUMERIC Sponsored Products Campaign: Ad Network Conversions The Ad Network Reported Conversions (alias for Attributed conversions for 1 day)
NUMERIC Sponsored Products Campaign: Ad Network Revenue The Ad Network Reported Revenue (alias for Attributed sales for 1 day)
NUMERIC Sponsored Products Campaign: Attributed conversions (14 days) Total number of attributed conversion events occurring within 14 days of ad click
NUMERIC Sponsored Products Campaign: Attributed conversions (1 day) Total number of attributed conversion events occurring within 24 hours of ad click
NUMERIC Sponsored Products Campaign: Attributed conversions (30 days) Total number of attributed conversion events occurring within 30 days of ad click
NUMERIC Sponsored Products Campaign: Attributed conversions (7 days) Total number of attributed conversion events occurring within 7 days of ad click
NUMERIC Sponsored Products Campaign: Attributed sales (14 days) Aggregate value of attributed sales occurring within 14 days of click on ad
NUMERIC Sponsored Products Campaign: Attributed sales (1 day) Aggregate value of attributed sales occurring within 24 hours of click on ad
NUMERIC Sponsored Products Campaign: Attributed sales (30 days) Aggregate value of attributed sales occurring within 30 days of click on ad
NUMERIC Sponsored Products Campaign: Attributed sales (7 days) Aggregate value of attributed sales occurring within 7 days of click on ad
NUMERIC Sponsored Products Campaign: Attributed units ordered (14 days) Total number of attributed units ordered within 14 days of ad click
NUMERIC Sponsored Products Campaign: Attributed units ordered (1 day) Total number of attributed units ordered within 24 hours of ad click
NUMERIC Sponsored Products Campaign: Attributed units ordered (30 days) Total number of attributed units ordered within 30 days of ad click
NUMERIC Sponsored Products Campaign: Attributed units ordered (7 days) Total number of attributed units ordered within 7 days of ad click
TEXT Sponsored Products Campaign: Campaign The name of the campaign
NUMERIC Sponsored Products Campaign: Campaign budget Total budget allotted to the campaign
TEXT Sponsored Products Campaign: Campaign status The current status of the campaign
TEXT Sponsored Products Campaign: Campaign bidding strategy Campaign bidding strategy
NUMERIC Sponsored Products Campaign: Campaign daily budget Total daily budget for the campaign
TEXT Sponsored Products Campaign: Campaign ID (duplicate) The unique identifier of the campaign. (duplicate)
TEXT Sponsored Products Campaign: Campaign targeting type Campaign targeting type
NUMERIC Sponsored Products Campaign: Clicks Total number of ad clicks
NUMERIC Sponsored Products Campaign: Cost Total cost of all ad clicks
NUMERIC Sponsored Products Campaign: CPC Cost-per-click (CPC)
PERCENT Sponsored Products Campaign: CTR Click-through rate (CTR)
NUMERIC Sponsored Products Campaign: Impressions Total number of ad impressions
NUMERIC Sponsored 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
TEXT Sponsored Products Campaign: Portfolio ID The identifier of the portfolio the campaign belongs to
TEXT Sponsored Products Campaign: Portfolio name The name of the portfolio the campaign belongs to
PERCENT Sponsored Products Campaign: Total return on advertising spend (RoAS) Total return on advertising spend (14-day sales revenue divided by cost)
NUMERIC Sponsored Products Campaign: Spend (alias for Cost) Alias for Cost
NUMERIC Sponsored Products Campaign: Total Cost Alias for Cost

Amazon Ads sponsored_products_placement fields

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

ID Type Name Description
NUMERIC Sponsored Products Placement: Total advertising cost of sales (ACoS) Total advertising cost of sales (cost divided by 14-day sales revenue)
NUMERIC Sponsored Products Placement: Ad Network Conversions The Ad Network Reported Conversions (alias for Attributed conversions for 1 day)
NUMERIC Sponsored Products Placement: Ad Network Revenue The Ad Network Reported Revenue (alias for Attributed sales for 1 day)
NUMERIC Sponsored Products Placement: Attributed conversions (14 days) Total number of attributed conversion events occurring within 14 days of ad click
NUMERIC Sponsored Products Placement: Attributed conversions (1 day) Total number of attributed conversion events occurring within 24 hours of ad click
NUMERIC Sponsored Products Placement: Attributed conversions (30 days) Total number of attributed conversion events occurring within 30 days of ad click
NUMERIC Sponsored Products Placement: Attributed conversions (7 days) Total number of attributed conversion events occurring within 7 days of ad click
NUMERIC Sponsored Products Placement: Attributed sales (14 days) Aggregate value of attributed sales occurring within 14 days of click on ad
NUMERIC Sponsored Products Placement: Attributed sales (1 day) Aggregate value of attributed sales occurring within 24 hours of click on ad
NUMERIC Sponsored Products Placement: Attributed sales (30 days) Aggregate value of attributed sales occurring within 30 days of click on ad
NUMERIC Sponsored Products Placement: Attributed sales (7 days) Aggregate value of attributed sales occurring within 7 days of click on ad
NUMERIC Sponsored Products Placement: Attributed units ordered (14 days) Total number of attributed units ordered within 14 days of ad click
NUMERIC Sponsored Products Placement: Attributed units ordered (1 day) Total number of attributed units ordered within 24 hours of ad click
NUMERIC Sponsored Products Placement: Attributed units ordered (30 days) Total number of attributed units ordered within 30 days of ad click
NUMERIC Sponsored Products Placement: Attributed units ordered (7 days) Total number of attributed units ordered within 7 days of ad click
TEXT Sponsored Products Placement: Campaign The name of the campaign
TEXT Sponsored Products Placement: Campaign ID The unique identifier of the campaign.
NUMERIC Sponsored Products Placement: Clicks Total number of ad clicks
NUMERIC Sponsored Products Placement: Cost Total cost of all ad clicks
NUMERIC Sponsored Products Placement: CPC Cost-per-click (CPC)
PERCENT Sponsored Products Placement: CTR Click-through rate (CTR)
NUMERIC Sponsored Products Placement: Impressions Total number of ad impressions
TEXT Sponsored Products Placement: Placement Ad placement classification, one of: Top of Search, Product Pages, Other
PERCENT Sponsored Products Placement: Total return on advertising spend (RoAS) Total return on advertising spend (14-day sales revenue divided by cost)
NUMERIC Sponsored Products Placement: Spend (alias for Cost) Alias for Cost
NUMERIC Sponsored Products Placement: Total Cost Alias for Cost

Amazon Ads sponsored_products_search_term fields

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

ID Type Name Description
NUMERIC Sponsored Products Search Term: ACoS Advertising cost of sales (cost divided by 14-day sales).
TEXT Sponsored Products Search Term: Ad Group ID The ID associated with an ad group.
TEXT Sponsored Products Search Term: Ad Group Name The name of the ad group.
TEXT Sponsored Products Search Term: Keyword Status The current status of the keyword or target.
TEXT Sponsored Products Search Term: Campaign Budget Currency Code The currency code associated with the campaign budget.
TEXT Sponsored Products Search Term: Campaign ID The ID associated with a campaign.
TEXT Sponsored Products Search Term: Campaign Name The name of the campaign.
NUMERIC Sponsored Products Search Term: Clicks Total number of ad clicks.
NUMERIC Sponsored Products Search Term: Cost Total cost of all ad clicks.
NUMERIC Sponsored Products Search Term: CPC Cost-per-click (CPC).
PERCENT Sponsored Products Search Term: CTR Click-through rate (CTR).
NUMERIC Sponsored Products Search Term: Impressions Total number of ad impressions.
TEXT Sponsored Products Search Term: Keyword ID The ID of the keyword or target. Null for some auto-targeting rows.
TEXT Sponsored Products Search Term: Keyword Text The keyword text, or the auto-targeting expression (e.g. loose-match) for auto campaigns.
TEXT Sponsored Products Search Term: Keyword Type The type of the keyword or target.
TEXT Sponsored Products Search Term: Match Type The match type of the keyword or target.
NUMERIC Sponsored Products Search Term: Purchases (14 days) Number of attributed conversion events within 14 days of an ad click.
NUMERIC Sponsored Products Search Term: Purchases (1 day) Number of attributed conversion events within 24 hours of an ad click.
NUMERIC Sponsored Products Search Term: Purchases (30 days) Number of attributed conversion events within 30 days of an ad click.
NUMERIC Sponsored Products Search Term: Purchases (7 days) Number of attributed conversion events within 7 days of an ad click.
PERCENT Sponsored Products Search Term: RoAS Return on advertising spend (14-day sales divided by cost).
NUMERIC Sponsored Products Search Term: Sales (14 days) Total value of attributed sales within 14 days of an ad click.
NUMERIC Sponsored Products Search Term: Sales (1 day) Total value of attributed sales within 24 hours of an ad click.
NUMERIC Sponsored Products Search Term: Sales (30 days) Total value of attributed sales within 30 days of an ad click.
NUMERIC Sponsored Products Search Term: Sales (7 days) Total value of attributed sales within 7 days of an ad click.
TEXT Sponsored Products Search Term: Search Term The customer search term that resulted in an ad click.
NUMERIC Sponsored Products Search Term: Spend (alias for Cost) Alias for Cost.
TEXT Sponsored Products Search Term: Targeting The targeting expression that served the ad.
NUMERIC Sponsored Products Search Term: Total Cost Alias for Cost.
NUMERIC Sponsored Products Search Term: Units Sold Clicks (14 days) Number of attributed units sold within 14 days of an ad click.
NUMERIC Sponsored Products Search Term: Units Sold Clicks (1 day) Number of attributed units sold within 24 hours of an ad click.
NUMERIC Sponsored Products Search Term: Units Sold Clicks (30 days) Number of attributed units sold within 30 days of an ad click.
NUMERIC Sponsored 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 26 fields.

ID Type Name Description
NUMERIC Sponsored Products Targeting: Total advertising cost of sales (ACoS) Total advertising cost of sales (cost divided by 14-day sales revenue)
TEXT Sponsored Products Targeting: Ad Group ID The ID associated with the ad group.
TEXT Sponsored Products Targeting: Ad Group Name The name of the ad group.
TEXT Sponsored Products Targeting: Campaign ID The ID associated with a campaign.
TEXT Sponsored Products Targeting: Campaign Name The name of the campaign.
NUMERIC Sponsored Products Targeting: Clicks Total number of ad clicks.
NUMERIC Sponsored Products Targeting: Cost Total cost of all ad clicks.
NUMERIC Sponsored Products Targeting: Impressions Total number of ad impressions.
TEXT Sponsored Products Targeting: Keyword The keyword text used for bidding on targeted searches.
TEXT Sponsored Products Targeting: Keyword or target ID The ID of the keyword or targeting clause.
TEXT Sponsored Products Targeting: Targeting type The type of the targeting clause (keyword or product target).
TEXT Sponsored Products Targeting: Portfolio ID The identifier of the portfolio the campaign belongs to
TEXT Sponsored Products Targeting: Portfolio name The name of the portfolio the campaign belongs to
NUMERIC Sponsored Products Targeting: Purchases (14 days) Total number of attributed conversion events occurring within 14 days of an ad click.
NUMERIC Sponsored Products Targeting: Purchases (1 day) Total number of attributed conversion events occurring within 24 hours of an ad click.
NUMERIC Sponsored Products Targeting: Purchases (30 days) Total number of attributed conversion events occurring within 30 days of an ad click.
NUMERIC Sponsored Products Targeting: Purchases (7 days) Total number of attributed conversion events occurring within 7 days of an ad click.
NUMERIC Sponsored Products Targeting: Return on advertising spend (RoAS) Return on advertising spend (14-day sales revenue divided by cost)
NUMERIC Sponsored Products Targeting: Sales (14 days) Total value of attributed sales occurring within 14 days of an ad click.
NUMERIC Sponsored Products Targeting: Sales (1 day) Total value of attributed sales occurring within 24 hours of an ad click.
NUMERIC Sponsored Products Targeting: Sales (30 days) Total value of attributed sales occurring within 30 days of an ad click.
NUMERIC Sponsored Products Targeting: Sales (7 days) Total value of attributed sales occurring within 7 days of an ad click.
NUMERIC Sponsored Products Targeting: Spend (alias for Cost) Alias for Cost.
TEXT Sponsored Products Targeting: Targeting expression The targeting expression, e.g. a product ASIN or category target.
PERCENT Sponsored Products Targeting: Top-of-search impression share Share of top-of-search impressions the keyword or target received out of all available top-of-search impressions.
NUMERIC Sponsored 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.

ID Type Name Description Report
account_id TEXT Account ID The Account ID
account_name TEXT Account Name The Account Name
ad_type TEXT Ad type One of: Sponsored Brands, Sponsored Display, Sponsored Products
data_fetched_at TIMESTAMP Data fetched at UTC 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.
datasource TEXT Data Source The name of the Windsor connector returning the row
date DATE Date Date
day_of_month TEXT Day of month Day of the month
marketplace TEXT Marketplace Amazon marketplace (country) name
month TEXT Month Number of the month
now TIMESTAMP Now Current timestamp
profileid TEXT Profile ID Amazon Advertising profile ID
source TEXT Source The name of the Windsor connector returning the row
today DATE Today Today's date
week TEXT Week Week (Sun-Sat).
week_day TEXT Day of week and day number Weekday number and name combined (Sun-Sat).Numbered from 0 Sunday to 6 Saturday.
week_day_iso TEXT Day of week and day number, ISO Weekday number and name combined, ISO format (Mon-Sun).Numbered from 1 Monday to 7
week_iso TEXT Week ISO Week, ISO format (Mon-Sun).
year TEXT Year Year
year_month TEXT Yearmonth Year and month, e.g. 2024|3
year_month_name TEXT Year month name Year and month with the month name written out, e.g. "Jan 2025".
year_of_week TEXT Year of week The year that contains first day of the week (Sun-Sat).
year_of_week_iso TEXT Year of week, ISO The year that contains first day of the ISO week (Mon-Sun).
year_week TEXT Year week Year and week for US weeks (Sun-Sat), e.g. 2024|15
year_week_iso TEXT Year week ISO Year and week for ISO weeks (Mon-Sun), e.g. 2024|20