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 Guide

What 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_id

Before You Query

  • This table is not time-series. No event_date filter is needed. Use created_at if 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

TableJoin KeyUse This Join To
Custom Categoriessub_category_idGroup mapped campaigns by configured category/subcategory labels and rules.
Adscampaign_id, provider_id to channelRoll campaign-level ad-platform performance up to custom categories.

View the full Triple Whale Data Ontology →

Dimensions

Dimensions are immutable properties that can be used for grouping data.

TitleIDTypeDescription
Campaign IDcampaign_idstringThe ID of the campaign.Example value: 1234567890
Campaign Namecampaign_namestringThe name of the campaign.Example values: Catalog Retargeting, US Generic Search, Breakfast of Champions Campaign
Category IDcategory_idstringThe ID of the category (grouping dimension, e.g., Tactic, Geography, Product).Example value: 09f58489-713a-4866-bce4-1040c9a1ee71
Mapping Created Datecreated_atdateThe date the campaign was mapped to the subcategory.Example value: 2025-09-08
Channelprovider_idstringThe channel or platform where the campaign runs.Example values: facebook-ads, google-ads, tiktok-ads
Subcategory IDsub_category_idstringThe ID of the subcategory assigned to the campaign.Example value: 46c71065-5bbb-4ab6-81ee-39078b23cca0