The Custom Category Mappings table stores data about how individual campaigns are assigned to custom-defined categories and subcategories using AI-powered rules or manual overrides. Querying this table lets you analyze campaign performance based on your own custom groupings—such as tactics, geographic regions, product lines, funnel stages, or any other segmentation relevant to your business. Learn more about Custom Categories for Campaign Organization.

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`