Custom Category Mappings Table
The Custom Category Mappings table assigns individual campaigns to user-defined categories and subcategories. One row per active campaign-to-subcategory mapping. Learn more about Custom Categories for Campaign Organization.
Table GuideWhat You Can Answer With This Table
- Which campaigns are assigned to each category or subcategory? — use
campaign_id,provider_id,sub_category_id- Which channels or categories have the most mapped campaigns? — group by
provider_id,category_id,sub_category_idBefore You Query
- This table is not time-series. No
event_datefilter is needed. Usecreated_atif you want to narrow to when the mapping was created.- A campaign can appear more than once when it is mapped to multiple categories or subcategories.
Key Relationships
Table Join Key Use This Join To Custom Categories sub_category_idGroup mapped campaigns by configured category/subcategory labels and rules. Ads campaign_id,provider_idtochannelRoll campaign-level ad-platform performance up to custom categories.
Dimensions
Dimensions are immutable properties that can be used for grouping data.
| Title | ID | Type | Description |
|---|---|---|---|
| Campaign ID | campaign_id | string | The ID of the campaign.Example value: 1234567890 |
| Campaign Name | campaign_name | string | The name of the campaign.Example values: Catalog Retargeting, US Generic Search, Breakfast of Champions Campaign |
| Category ID | category_id | string | The ID of the category (grouping dimension, e.g., Tactic, Geography, Product).Example value: 09f58489-713a-4866-bce4-1040c9a1ee71 |
| Mapping Created Date | created_at | date | The date the campaign was mapped to the subcategory.Example value: 2025-09-08 |
| Channel | provider_id | string | The channel or platform where the campaign runs.Example values: facebook-ads, google-ads, tiktok-ads |
| Subcategory ID | sub_category_id | string | The ID of the subcategory assigned to the campaign.Example value: 46c71065-5bbb-4ab6-81ee-39078b23cca0 |
Updated 4 days ago