LogoLogo
  • 🦩Overview
  • 💾Datasets
    • Overview
    • Core Concepts
      • Columns & Annotations
      • Type & Property Mappings
      • Relationships
    • Basic Datasets
      • dbt Integration
      • Sigma Integration
      • Looker Integration
    • SaaS Datasets
    • CSV Datasets
    • Streaming Datasets
    • Entity Resolution
    • AI Columns
      • AI Prompts Recipe Book
    • Enrichment Columns
      • Quick Start
      • HTTP Request Enrichments
    • Computed Columns
    • Version Control
  • 📫Syncs
    • Overview
    • Triggering & Scheduling
    • Retry Handling
    • Live Syncs
    • Audience Syncs
    • Observability
      • Current Sync Run Overview
      • Sync History
      • Sync Tracking
      • API Inspector
      • Sync Alerts
      • Observability Lake
      • Datadog Integration
      • Warehouse Writeback
      • Sync Lifecycle Webhooks
      • Sync Dry Runs
    • Structuring Data
      • Liquid Templates
      • Event Syncs
      • Arrays and Nested Objects
  • 👥Audience Hub
    • Overview
    • Creating Segments
      • Segment Priorities
      • Warehouse-Managed Audiences
    • Experiments and Analysis
      • Audience Match Rates
    • Activating Segments
    • Calculated Columns
    • Data Preparation
      • Profile Explorer
      • Exclusion Lists
  • 🧮Data Sources
    • Overview
    • Available Sources
      • Amazon Athena
      • Amazon Redshift
      • Amazon S3
      • Azure Synapse
      • ClickHouse
      • Confluent Cloud
      • Databricks
      • Elasticsearch
      • Kafka
      • Google AlloyDB
      • Google BigQuery
      • Google Cloud SQL for PostgreSQL
      • Google Pub/Sub
      • Google Sheets
      • Greenplum
      • HTTP Request
      • HubSpot
      • Materialize
      • Microsoft Fabric
      • MotherDuck
      • MySQL
      • PostgreSQL
      • Rockset
      • Salesforce
      • SingleStore
      • Snowflake
      • SQL Server
      • Trino
  • 🛫Destinations
    • Overview
    • Available Destinations
      • Accredible
      • ActiveCampaign
      • Adobe Target
      • Aha
      • Airship
      • Airtable
      • Algolia
      • Amazon Ads DSP (AMC)
      • Amazon DynamoDB
      • Amazon EventBridge
      • Amazon Pinpoint
      • Amazon Redshift
      • Amazon S3
      • Amplitude
      • Anaplan
      • Antavo
      • Appcues
      • Apollo
      • Asana
      • AskNicely
      • Attentive
      • Attio
      • Autopilot Journeys
      • Azure Blob Storage
      • Box
      • Bloomreach
      • Blackhawk
      • Braze
      • Brevo (formerly Sendinblue)
      • Campaign Monitor
      • Canny
      • Channable
      • Chargebee
      • Chargify
      • ChartMogul
      • ChatGPT Retrieval Plugin
      • Chattermill
      • ChurnZero
      • CJ Affiliate
      • CleverTap
      • ClickUp
      • Constant Contact
      • Courier
      • Criteo
      • Crowd.dev
      • Customer.io
      • Databricks
      • Delighted
      • Discord
      • Drift
      • Drip
      • Eagle Eye
      • Emarsys
      • Enterpret
      • Elasticsearch
      • Facebook Ads
      • Facebook Product Catalog
      • Freshdesk
      • Freshsales
      • Front
      • FullStory
      • Gainsight
      • GitHub
      • GitLab
      • Gladly
      • Google Ads
        • Customer Match Lists (Audiences)
        • Offline Conversions
      • Google AlloyDB
      • Google Analytics 4
      • Google BigQuery
      • Google Campaign Manager 360
      • Google Cloud Storage
      • Google Datastore
      • Google Display & Video 360
      • Google Drive
      • Google Search Ads 360
      • Google Sheets
      • Heap.io
      • Help Scout
      • HTTP Request
      • HubSpot
      • Impact
      • Insider
      • Insightly
      • Intercom
      • Iterable
      • Jira
      • Kafka
      • Kevel
      • Klaviyo
      • Kustomer
      • Labelbox
      • LaunchDarkly
      • LinkedIn
      • LiveIntent
      • Loops
      • Mailchimp
      • Mailchimp Transactional (Mandrill)
      • Mailgun
      • Marketo
      • Meilisearch
      • Microsoft Advertising
      • Microsoft Dynamics
      • Microsoft SQL Server
      • Microsoft Teams
      • Mixpanel
      • MoEngage
      • Mongo DB
      • mParticle
      • MySQL
      • NetSuite
      • Notion
      • OneSignal
      • Optimizely
      • Oracle Database
      • Oracle Eloqua
      • Oracle Fusion
      • Oracle Responsys
      • Orbit
      • Ortto
      • Outreach
      • Pardot
      • Partnerstack
      • Pendo
      • Pinterest
      • Pipedrive
      • Planhat
      • PostgreSQL
      • PostHog
      • Postscript
      • Productboard
      • Qualtrics
      • Radar
      • Reddit Ads
      • Rokt
      • RollWorks
      • Sailthru
      • Salesforce
      • Salesforce Commerce Cloud
      • Salesforce Marketing Cloud
      • Salesloft
      • Segment
      • SendGrid
      • Sense
      • SFTP
      • Shopify
      • Singular
      • Slack
      • Snapchat
      • Snowflake
      • Split
      • Sprig
      • Statsig
      • Stripe
      • The Trade Desk
      • TikTok
      • Totango
      • Userflow
      • Userpilot
      • Vero Cloud
      • Vitally
      • Webhooks
      • Webflow
      • X Ads (formerly Twitter Ads)
      • Yahoo Ads (DSP)
      • Zendesk
      • Zoho CRM
      • Zuora
    • Custom & Partner Destinations
  • 📎Misc
    • Credits
    • Census Embedded
    • Data Storage
      • Census Store
        • Query Census Store from Snowflake
        • Query Census Store locally using DuckDB
      • General Object Storage
      • Bring Your Own Bucket
        • Bring your own S3 Bucket
        • Bring your own GCS Bucket
        • Bring your own Azure Bucket
    • Developers
      • GitLink
      • Dataset API
      • Custom Destination API
      • Management API
    • Security & Privacy
      • Login & SSO Settings
      • Workspaces
      • Role-based Access Controls
      • Network Access Controls
      • SIEM Log Forwarding
      • Secure Storage of Customer Credentials
      • Digital Markets Act (DMA) Consent for Ad Platforms
    • Health and Usage Reporting
      • Workspace Homepage
      • Product Usage Dashboard
      • Observability Toolkit
      • Alerts
    • FAQs
Powered by GitBook
On this page
  • Data Models
  • Dataset Definitions
  • Finalize Setup
  • FAQ

Was this helpful?

  1. Audience Hub
  2. Creating Segments

Warehouse-Managed Audiences

Manage audiences programmatically from your data warehouse.

PreviousSegment PrioritiesNextExperiments and Analysis

Last updated 3 months ago

Was this helpful?

Warehouse-Managed Audiences enable data teams to manage audiences programmatically from the warehouse, while taking full advantage of all the features that come with Audience Hub.

Data Models

To get started with Warehouse-Managed Audiences, you'll need to define three datasets in Census that map to tables in your warehouse:

  1. Audiences: A list of all audiences you plan to model in your warehouse.

    1. Required columns: id and name

    2. Optional columns: description

  2. People: Also known as contacts, customers, users, etc., this is a list of all people belonging to every audience you plan to model in your warehouse.

    1. Required columns: id

    2. Optional columns: other user attributes (email, phone, first/last name, IDFA, GAID, etc.)

  3. Audience Memberships: A join table that tells Census which people are in each audience. Each row must include a unique pair of person and audience identifiers.

    1. Required columns: person_id and audience_id

Example Data

Audiences

id
name
description

201

VIP Customers

A list of all VIP customers.

202

All Customers (US)

Customers in the US only.

203

All Customers (EU)

Customers in the EU only.

204

Webinar Attendees

From webinar on Feb 22.

People

id
email
phone

101

michaelorr@stanley-dunlap.com

762-947-7170

102

brendasmith@hotmail.com

619-362-2778

103

kevin12@gmail.com

612-550-3366

104

jerryrichardson@young.com

258-830-6056

105

shane87@gmail.com

505-903-2266

Audience Membership (Join Table)

person_id
audience_id

101

201

101

203

102

201

103

204

Dataset Definitions

This process should be done with the help of your Census representative, who can talk through any questions during setup.

Part 1: Datasets

Next, create a dataset for each of the three tables. This will allow you to provide some additional metadata to help Census understand the shape of your data and how its related.

Audiences model -> Create an Audience type dataset:

Person model -> Create a Person type dataset:

Audience Membership model -> Create a Join Table type dataset:

Part 2: Dataset relationships

Finally, specify how these datasets relate to each other by setting up relationships between them.

Connect the Person dataset to the Audience Membership dataset with a One-to-Many relationship:

Connect the Audience dataset to the Audience Membership dataset with a One-to-Many relationship:

Finalize Setup

Once your datasets are set up, your Census representative can finalize your configuration. You should see your imported audience segments populate in Census. You can distinguish them from audiences defined in the UI based on the "Managed" tag that appears next to the segment name.

FAQ

How do I update the membership of an audience?

Audience membership information lives in the audience membership dataset (join table). Any time a Warehouse-Managed Audience is queried in Census, we make a just-in-time query to this table. Thus, adding and removing rows from the audience membership dataset will update the membership of an audience.

How often are audiences refreshed by Census?

To determine the list of Warehouse-Managed Audiences shown in the Census UI (see below), Census runs a background job every 15 minutes which looks at your Audiences model and creates/updates/deletes the audiences accordingly.

Census determines which people are members of those audiences by querying your Audience membership table in real-time. Thus, if you preview a Warehouse-Managed Audience or run a sync based on one, Census will always be looking at the most current data in the data warehouse.

What happens if a row is added/updated/deleted from my audiences table?

Any changes to the Audiences table will be reflected in the respective audiences during the audience refresh:

  • Row was added: A new audience will be created on the next refresh

  • Row was updated: The matching audience will be renamed in Census on the next refresh. This will not impact the name of any audiences in your downstream destinations.

  • ⚠️ Row was removed: The matching audience will be marked as invalid on the next refresh. Any related syncs will begin to fail. You will have the option to manually delete the audience in Census, or re-add the row (if it was removed by mistake).

What happens if I delete my Person/Audience/Join Table dataset?

Any audience segments managed by the Warehouse-Managed Audience feature will no longer be considered valid. Refreshes may not work properly.

What happens if I modify my Person/Audience/Join Table relationships?

Any audiences managed by the Warehouse-Managed Audience feature will no longer be considered valid. Refreshes may not work properly.

Can I delete audiences managed by this feature?

You are not able to manually delete managed audiences through the Census UI. If you’d like to remove all of your managed audiences and disable this feature, please reach out to a Census representative.

Can I use <X> feature with Warehouse-Managed Audiences?

Any feature that is available for audiences built in the Census UI is available for Warehouse-Managed Audiences.

How can I turn off Warehouse-Managed Audiences and opt back out of this feature?

Reach out to your Census account manager, or email support@getcensus.com.

👥