ChangelogBook a demoSign up

Snapshots

AudienceMarketers and platform admins who want a historical record of audience membership to analyze when users entered or exited campaigns.
Prerequisites

Audience snapshots give marketers a historical record of who was in an audience and when. This is useful for evaluating campaign reach, tracking changes in membership over time, and enabling downstream analysis or reporting.


Learning objectives

After reading this article, you'll be able to:

  • Understand how audience snapshots work in Customer Studio
  • Enable snapshotting on your source
  • Access and interpret snapshot data in your warehouse

Overview

After each sync of an audience, Customer Studio saves a snapshot of that audience's membership. These snapshots are written to your data warehouse and include:

  • Only audience member IDs and no other customer data
  • A timestamp for when each member entered or exited the audience
  • The event type (enter or exit)
  • An optional split group ID, if audience splits are enabled
Audience snapshotting requires WRITE permissions to your warehouse. Snapshots are only available for sources using the Lightning sync engine.

Snapshot table schema

Snapshots are stored in a single shared table in your warehouse: hightouch_planner.audience_membership

ColumnTypeDescription
ht_row_idstringThe primary key of the user. Stringified if the original value is not a string.
ht_audience_idstringThe ID of the audience.
ht_timestamptimestampWhen the user entered or exited the audience.
ht_event_typestringEither enter or exit, depending on the change.
ht_split_groupstringThe split group ID the user belongs to (if applicable). null if no split was applied.

Each table row contains the audience member's ID, the timestamp of when the snapshot occurred, and either an enter or exit event type.

An audience's first snapshot records current membership in the form of enter events for every member.

Subsequent snapshots only contain changes to membership—either enter events for new members or exit events for members who aren't present in that snapshot but were in the previous one.

Enable snapshots

To enable snapshots for a given source:

  1. Navigate to your Source
  2. Go to the Sync log tab.
  3. Enable Audience snapshotting using the toggle.

Once enabled, snapshots will be automatically taken after each successful sync.

Enable snapshotting

Ready to get started?

Jump right in or a book a demo. Your first destination is always free.

Book a demoSign upBook a demo

Need help?

Our team is relentlessly focused on your success. Don't hesitate to reach out!

Feature requests?

We'd love to hear your suggestions for integrations and other features.

Privacy PolicyTerms of Service

Last updated: Aug 4, 2025

On this page
  • Learning objectives
  • Overview
  • Snapshot table schema
  • Enable snapshots

Was this page helpful?