Sync Audience
Last updated: 2026-06-10
Sourcesible Product Documentation · Activation
Overview
The Sync Audience feature lets you export a Sourcesible Audience directly to a connected Destination for paid media activation enabling you to target or suppress matched customers in ad campaigns in near real-time. Before you begin, ensure you have at least one Audience defined under Audiences and a Destination already connected. If your Destination shows a Disconnected status, reconnect it before proceeding.
The final audience size delivered to the ad platform may differ from your Sourcesible audience count. Platforms such as Facebook apply their own identity resolution and matching rules after receiving the data.
Sync Audience Wizard
The Sync Audience wizard has four steps: Select Audiences → Select Destination → Set up Sync → Set Schedule.
Select Audiences
In the left navigation, click Sync under Activation. Click the Sync button in the top-right corner and select Sync Audience from the dropdown. On the Select Audiences screen, click the Audience dropdown and select the audience you want to export. The Export Audience counter updates immediately to show the number of matching customers. To include additional audiences in the same sync, click + Add Audience and repeat the selection. Click Next.
Only audiences with at least one customer will produce a meaningful sync. If the Export Audience counter shows 0 Customers, verify your audience definition and data freshness before continuing.
Select Destination
On the Select Destination screen, review the list of available destinations each row displays Destination Name, Destination Type, Status, Sync count, and Last Update. Select the radio button next to the Destination you want to use. Only destinations showing a Connected status are selectable. Click Next.
If no Destination appears, or the status shows Disconnected, navigate to Destinations to reconnect it before continuing. You cannot proceed past this step without a connected destination.
Set Up Sync
This screen is titled Set up Sync with [Destination Name]. It contains the following sections:
Sync Identity: Enter a unique Sync Name (maximum 50 characters) and an optional Sync Description (maximum 50 characters).
Audience Mode: Choose whether Sourcesible should create a new audience in the destination platform or push data into an existing one.
| Option | When to use | Additional field shown |
|---|---|---|
| Create a new audience | You want Sourcesible to provision a fresh Custom Audience | Audience Name the name the audience will have in the platform |
| Use an existing audience | You want to append or replace members in an audience already created in the platform | Dropdown to select the target existing audience |
The Audience Name you enter must be unique within your ad account. If a name matching an existing Custom Audience already exists, the platform may reject or silently merge the data.
Data Mapping: Configure which Sourcesible Audience fields map to the destination platform's identity fields. Use the Sourcesible Audience dropdowns (left column) to select your source fields. Map at least Email or Phone Number to achieve a meaningful match rate. Mapping both fields significantly increases the matched audience size.
PII Auto-Hashing: Select Yes (default, recommended) to have Sourcesible automatically SHA-256 hash PII values before transmitting them to the destination. Select No only if your source data has already been hashed upstream.
Ad platforms require all PII to be SHA-256 hashed prior to ingestion. Selecting Yes ensures compliance automatically and is strongly recommended.
Set Schedule
Choose the schedule type that best fits your campaign cadence:
| Schedule Type | Description | When to use |
|---|---|---|
| Manual | Trigger the sync on demand from the Sync list page | Ad-hoc campaigns or one-time audience pushes |
| Interval | Run the sync automatically on a recurring interval (e.g., once per hour) | Always-on campaigns where audience membership changes frequently |
If you selected Interval, configure the frequency using the interval options that appear. Click Finish.
For live campaigns that depend on up-to-date suppression lists or high-intent segments, use Interval scheduling to keep the audience continuously refreshed without manual intervention.
Next Steps
After clicking Finish, Sourcesible begins the initial audience export. Monitor and manage the sync from the Sync list page.
Monitor sync status The Status column shows Synced, Disconnected, or Invalid for each sync.
Trigger a manual sync Click into any sync and use the Sync button to push an update on demand.
Edit sync settings Update the Sync Name, audience selection, data mapping, or schedule at any time.
Create additional syncs Repeat this flow to activate other segments to additional destinations.
Tips and Troubleshooting
Destination Shows "Disconnected" on the Select Destination Screen
Symptom: The Destination appears in the list but cannot be selected because its status is Disconnected.
Cause: The OAuth token authorizing Sourcesible's access has expired or been revoked.
Fix: Navigate to Destinations. Locate the affected Destination, click Reconnect, and re-authorize. Return to Sync and retry the sync setup.
Audience Size in the Platform Is Smaller Than the Sourcesible Export Count
Symptom: After the sync completes with a Synced status, the Custom Audience size in the ad platform is significantly lower than the Export Audience count shown in Sourcesible.
Cause: Ad platforms apply their own probabilistic identity matching after receiving hashed data. Only customers whose hashed identifiers correspond to an active profile on the platform are included. Low match rates are most commonly caused by insufficient field mappings or data quality issues.
Fix: Return to the sync settings and ensure both email and phone are mapped. Verify your source data is clean no null values, phone numbers formatted consistently with country code (e.g., +66812345678). Confirm PII Auto-Hashing is set to Yes unless your data is pre-hashed. Allow up to 24 hours after the initial sync for the platform to complete its matching process before evaluating match rate.
Sync Status Shows "Invalid"
Symptom: A sync on the Sync list page displays a red Invalid badge in the Status column.
Cause: The sync configuration references a source or destination that is no longer valid for example, a Sourcesible Audience that was deleted or a destination that was disconnected.
Fix: Click the sync name to open its settings. Review each of the four wizard steps for missing or broken references. Correct each issue and save. If the original Audience was deleted, create a new sync pointing to a valid Audience.
Duplicate Audience Name Conflict
Symptom: After the sync runs, a new Custom Audience does not appear in the ad platform, or an unexpected existing audience has been modified.
Cause: The Audience Name entered during Set up Sync matches the name of an existing Custom Audience in the ad account.
Fix: Open the sync settings and navigate to Set up Sync. Update the Audience Name to a unique value that does not exist in your ad account. Save and re-run the sync. Alternatively, switch to Use an existing audience mode and explicitly select the intended target audience from the dropdown.
"Finish" Button Spinner Does Not Resolve
Symptom: After clicking Finish on the Set Schedule step, the button shows a loading spinner but the page does not redirect to the Sync list.
Cause: The sync save request may have timed out due to a slow network connection, or a transient API error occurred.
Fix: Wait up to 30 seconds before taking any action. If the spinner persists, do not click Back this may result in a duplicate sync being created. Instead, navigate directly to Sync to check whether the sync was created successfully. If the sync does not appear, click Sync → Sync Audience and repeat the wizard from Step 1.