# Ad Group Performance

- BigQuery table name: `amazon_ads_by_ad_group_by_date`
- Available in: Amazon Ads
- Data scheme index: https://api.datadoe.com/api/v1/spec/data-scheme.md

Performance for ad groups in SPONSORED_BRANDS and SPONSORED_DISPLAY campaigns.

- Source type: `AMAZON_ADS`
- Source ID: `7c1ba29e52b0e7b23d559d1e4647e65a05147374fe70d27b32dcc88177593b66`
- Requires a date period: yes
- Contains PII: no
- Premium table: no
- User-managed: no
- Default dataset: no
- Rows count towards billing: yes
- Hub: https://www.datadoe.com/hub/data-scheme?source=AMAZON_ADS&table=7c1ba29e52b0e7b23d559d1e4647e65a05147374fe70d27b32dcc88177593b66

## Fetch periods

- `INITIAL` (56 days)
- `RECURRING_DAILY` (21 days)
- `RECURRING_MONTHLY` (49 days)

## Related actions

- `AMAZON_ADS_AD_GROUPS_ADD` — writes: writes rows to this table
- `AMAZON_ADS_AD_GROUPS_UPDATE` — writes: writes rows to this table
- `AMAZON_ADS_AD_GROUPS_REMOVE` — writes: writes rows to this table
- `AMAZON_ADS_AD_GROUPS_FIND` — live: reads a fresher live value

## Columns (37)

- `marketplace_id` (`TEXT`, required) — Amazon provided ID that represents a specific country where the Seller or Vendor operates.
- `marketplace_country_code` (`TEXT`, required) — ISO country code for the Amazon marketplace.
- `marketplace_country_name` (`TEXT`, required) — Human-readable country name for the marketplace (derived from marketplace_id).
- `seller_or_vendor_id` (`TEXT`, required) — DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead.
- `seller_or_vendor_name` (`TEXT`, required) — DataDoe connection context display name for the seller or vendor.
- `marketplace_seller_id` (`TEXT`, nullable) — Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID.
- `amazon_ads_profile_id` (`TEXT`, nullable) — Amazon Ads profile identifier.
- `date` (`DATE`, required)
- `ad_group_id` (`TEXT`, required)
- `ad_group_name` (`TEXT`, required)
- `ad_campaign_id` (`TEXT`, required)
- `ad_campaign_name` (`TEXT`, required)
- `ad_add_to_lists_clicks_only` (`NUMBER`, required) — Add-to-list actions attributed to a click. Excludes view-through.
- `ad_branded_searches_clicks_only` (`NUMBER`, required) — Branded searches attributed to a click. Excludes view-through.
- `ad_campaign_budget_amount` (`NUMBER`, required)
- `ad_campaign_budget_type` (`TEXT`, nullable)
- `ad_campaign_budget_currency` (`TEXT`, required)
- `ad_clicks` (`NUMBER`, required)
- `ad_spend` (`NUMBER`, required)
- `ad_impressions` (`NUMBER`, required)
- `ad_detail_page_views_clicks_only` (`NUMBER`, required) — Detail-page views attributed to a click. Excludes view-through.
- `ad_orders` (`NUMBER`, required) — Attributed ad orders (14d for SPONSORED_BRANDS and SPONSORED_DISPLAY, 7d for SPONSORED_PRODUCTS).
- `ad_orders_new_to_brand_14d` (`NUMBER`, required) — First-time orders of the brand in a 12-month lookback, within 14 days of an ad click or view. A count, not a rate. Not available for book vendors.
- `ad_orders_new_to_brand_14d_clicks_only` (`NUMBER`, required) — New-to-brand orders attributed to a click only. Excludes view-through.
- `ad_units_sold` (`NUMBER`, required) — Attributed ad units sold (14d for SPONSORED_BRANDS and SPONSORED_DISPLAY, 7d for SPONSORED_PRODUCTS).
- `ad_units_sold_new_to_brand_14d` (`NUMBER`, required)
- `ad_video_five_second_view_rate` (`NUMBER`, required)
- `ad_video_five_second_views` (`NUMBER`, required)
- `ad_video_complete_views` (`NUMBER`, required)
- `ad_video_first_quartile_views` (`NUMBER`, required)
- `ad_video_midpoint_views` (`NUMBER`, required)
- `ad_video_third_quartile_views` (`NUMBER`, required)
- `ad_video_unmutes` (`NUMBER`, required)
- `ad_viewability_rate` (`NUMBER`, required)
- `ad_campaign_type` (`TEXT`, required)
- `ad_sales` (`NUMBER`, required) — Attributed ad sales (14d for SPONSORED_BRANDS and SPONSORED_DISPLAY, 7d for SPONSORED_PRODUCTS).
- `ad_sales_new_to_brand_14d` (`NUMBER`, required)

---

Query live via DataDoe MCP `exports_source_get` (connected accounts only), or request rows with `exports_create`.