Custom Categories Table
The Custom Categories table defines your custom ad campaign groupings, such as tactic, geography, funnel stage, or product line. One row per active subcategory, with its classification rule and provider scope. Learn more about Custom Categories for Campaign Organization.
Table GuideWhat You Can Answer With This Table
- How are my custom ad campaign groups organized? — use
category_name,sub_category_name,created_at- Which rules and platform scopes define each campaign subcategory? — use
ai_rule,include_providers,exclude_providersBefore You Query
- This table is not time-series. No
event_datefilter is needed. Usecreated_atif you want to narrow to a creation-date range.Key Relationships
Table Join Key Use This Join To Custom Category Mappings sub_category_idGroup and compare Ads performance by custom category/subcategory.
Dimensions
Dimensions are immutable properties that can be used for grouping data.
| Title | ID | Type | Description |
|---|---|---|---|
| AI Rule | ai_rule | string | The AI rule used to classify campaigns into subcategories.Example values: customers aged 18-24, campaigns targeting South America, branded search ads, influencer collaborations |
| Category ID | category_id | string | The ID of the category (grouping dimension, e.g., Tactic, Geography, Product).Example value: 09f58489-713a-4866-bce4-1040c9a1ee71 |
| Category Name | category_name | string | The name of the category (grouping dimension).Example values: Geography, Tactic, Funnel |
| Subcategory Created Date | created_at | date | The date the subcategory was created.Example value: 2025-09-08 |
| Exclude Providers | exclude_providers | repeated string | The providers excluded from the subcategory.Example values: facebook-ads, google-ads, tiktok-ads |
| Include Providers | include_providers | repeated string | The providers included in the subcategory.Example values: facebook-ads, google-ads, tiktok-ads |
| Subcategory ID | sub_category_id | string | The ID of the subcategory.Example value: 46c71065-5bbb-4ab6-81ee-39078b23cca0 |
| Subcategory Name | sub_category_name | string | The name of the subcategory (specific group within a category).Example values: 18-24, Peru, Meta Prospecting, Google PMAX |
Updated 4 days ago