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_idstring

The ID of the campaign.

Example value: 1234567890

Campaign Namecampaign_namestring

The name of the campaign.

Example values: Catalog Retargeting, US Generic Search, Breakfast of Champions Campaign

Category IDcategory_idstring

The ID of the category (grouping dimension, e.g., Tactic, Geography, Product).

Example value: 09f58489-713a-4866-bce4-1040c9a1ee71

Mapping Created Datecreated_atdate

The date the campaign was mapped to the subcategory.

Example value: 2025-09-08

Channelprovider_idstring

The channel or platform where the campaign runs.

Example values: facebook-ads, google-ads, tiktok-ads

Subcategory IDsub_category_idstring

The ID of the subcategory assigned to the campaign.

Example value: 46c71065-5bbb-4ab6-81ee-39078b23cca0