The Custom Categories table stores data about custom-defined grouping types (categories) and their subcategories, including the AI rules used for automatic classification. Querying this table lets you define, manage, and analyze campaign segments based on your business logic. Learn more about Custom Categories for Campaign Organization.

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`
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`