| Audience | Platform admins who want a historical record of audience membership |
| Prerequisites |
|
Audience snapshots record who was in an audience and when members entered or exited. Hightouch writes this history to your warehouse as a table you can query.
Audience dashboards show membership trends inside Hightouch. Snapshots store audience membership changes in your warehouse, where you can query them directly or join them with other data for reporting and analysis.
How snapshots work
After each successful audience sync, Customer Studio writes membership changes to the snapshot table. Each record includes:
- Audience member ID — The primary key of the audience member.
- Timestamp — When the member entered or exited the audience.
- Event type — Either
enterorexit. - Split group ID — The member's split group when audience experiments are enabled.
The first snapshot records every current audience member as an enter event. Later snapshots record only changes since the previous snapshot:
- an
enterevent when a member joins the audience - an
exitevent when a member leaves the audience
Snapshot table schema
Snapshots are stored in a shared table in the Hightouch Planner schema: hightouch_planner.audience_membership.
| Column | Type | Description |
|---|---|---|
ht_row_id | string | The primary key of the audience member. Hightouch converts the value to a string when needed. |
ht_audience_id | string | The ID of the audience. |
ht_timestamp | timestamp | When the member entered or exited the audience. |
ht_event_type | string | Either enter or exit. |
ht_split_group | string | The split group ID the member belongs to, or null if no split was applied. |
Enable snapshots
Audience snapshots are configured as part of warehouse sync logs and enabled per source:
- Go to your source.
- Open the Sync logs tab.
- Under Warehouse sync logs, enable Audience snapshots.
Hightouch records membership changes automatically after each successful audience sync.
