# Ad Groups (raw)

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

Snapshots of Amazon Ads ad group configuration and settings. Rows are identified by ad group and ad product. Includes archived, enabled, and paused ad groups. Snapshots are refreshed every 72 hours. Live entity state can be obtained using Actions.

- Source type: `AMAZON_ADS`
- Source ID: `4ce1ac7e86bf8900ebeb2fd716e8538184fb75794ba3072136beb43be515a256`
- Requires a date period: no
- 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=4ce1ac7e86bf8900ebeb2fd716e8538184fb75794ba3072136beb43be515a256

## Fetch periods

- `CONTINUOUS`

## 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 (21)

- `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.
- `ad_group_id` (`TEXT`, required)
- `ad_group_name` (`TEXT`, nullable)
- `ad_campaign_id` (`TEXT`, required)
- `ad_group_type` (`TEXT`, required) — SPONSORED_DISPLAY / SPONSORED_PRODUCTS / SPONSORED_BRANDS
- `ad_group_creative_type` (`TEXT`, nullable)
- `ad_group_updated_at_utc` (`DATE`, required)
- `ad_group_created_at_utc` (`DATE`, required)
- `ad_group_state` (`TEXT`, required) — Entity state from Amazon Ads Universal Exports API. Enum values: ARCHIVED / ENABLED / PAUSED.
- `ad_group_delivery_status` (`TEXT`, required) — Whether Amazon is delivering the ad group. Not ad_group_state (ENABLED, PAUSED, ARCHIVED).
- `ad_group_delivery_reasons` (`JSON`, nullable) — Same as JSON payload from Amazon Ads API.
- `ad_group_default_bid` (`NUMBER`, nullable)
- `ad_group_bid_currency_code` (`TEXT`, nullable)
- `ad_group_optimization_goal` (`TEXT`, nullable)
- `ad_group_optimization_kpi` (`TEXT`, nullable)

---

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