Sync CustomerLabs Audience with Meta (Facebook) Ads

Audiences created in CustomerLabs can be synced with Facebook in two ways:

1. Event Sync (through website custom audience)
2. List Sync (as a customer list)

Prerequisites

Before syncing audiences, ensure you have:

• Integrated Facebook with CustomerLabs by authenticating your Facebook account.
• Audience should be created and active

Tip

• Refer to the Facebook Integration page to connect Meta Ads with CustomerLabs.
• Refer to the Audience Creation page to create audience in CustomerLabs.

Event Sync (Recommended)

You can sync the segment as an event for both anonymous and known users, depending on the availability of external IDs (e.g., Facebook FBP ID). By syncing the segment, a new custom audience is created in Facebook, which updates regularly based on the refresh interval.

Steps to sync an audience via Event Sync:

1. Navigate to the segment created in CustomerLabs that you want to sync.
2. Go to the Event Sync tab.
3. Click on Settings.

4. Configure the Audience Name by selecting one of the following from the dropdown:
   • Segment name: The audience name created in CustomerLabs.
   • Segment ID: A unique identifier automatically generated for the audience.
   • Custom: A custom name to identify the audience on Facebook.

5. Add Retention days and Description as needed.
   • Retention days: The number of days the audience will be retained by Facebook after the last refresh. If audience is refreshed continuously, the retention days will be updated and keep extending set days from the last refresh.
   • Description: You can added description to the audience to identify it in Facebook.

Tip

Retention days matters most for static audiences as this will only be refreshed once and the audience will be retained for the set number of days from that refresh.

6. If this audience is a segment of your existing audience (who are converted), and you intend to add this under “existing customer” segment in Facebook for use in Advantage+ Sales Campaigns, you can check the box Add to Existing Customer Audience.

7. Click Exclude Audience to exclude this specific audience when creating Facebook custom audiences.

8. Click Create Audience.

9. Verify the sync status:

   • Look for the green toggle under the Status column to confirm the audience is active.
   • Check the Logs tab (or Event Sync → Facebook → Show Logs) to view the latest sync updates.

10. The custom audience will be created in Meta Ads Manager → Audiences.

Unlinking or Deleting an Audience

You can manage your synced audiences directly from the interface.

Unlink an Audience

Unlinking stops the regular refresh from CustomerLabs but keeps the audience on Facebook.

1. Go to the Events Sync tab → Click Settings button across that Facebook Destination name.

2. Click the Unlink icon in the top right corner of the custom audience.

3. You will be prompted to enter the name of the custom audience for confirmation. Enter the audience name and click Unlink.

Delete an Audience

Deleting removes the custom audience from Facebook entirely.

1. Click the Delete icon in the top right corner of the custom audience.
   
2. Enter the name of the custom audience to confirm.
3. Click Delete.

List Sync (Customer List)

Important

For syncing anonymous users, use Event Sync. List sync is only for known users (where you have atleast one identifier like email, phone, etc.)

Syncing as a customer list is recommended when you have basic user details (name, email, phone) but lack external IDs (e.g., FBP ID). There are two types of list syncs:

• Normal customer list
• Value-based customer list

Normal Customer List

This method requires at least one main identifier but no value parameter.

1. Navigate to your audience in CustomerLabs and go to the Schema tab.

2. Add the user traits (schema) to be synced. Only added traits can be mapped. Required Identifiers (at least one):

   • Email
   • Phone number
   • Mobile Advertiser ID
   • Facebook App User ID
   • Facebook Page User ID
   • First Name
   • Last Name
   
   

3. Click Update schema.

4. Go to the List Sync tab, locate Facebook, and click Map Schema.

   

5. In the List to sync tab:

   • Choose an existing audience list, OR
   • Select + Create New List and enter a name.
   
   

   Tip

   (Optional) If you see “Error Fetching data”, re-authenticate Facebook in Destinations.

   
   

6. Go to the Schema Mapping tab and map your CustomerLabs schema to the Facebook schema using the + icon.

   

7. Click Save List and Schema in Schema Mapping and List to sync tabs.

   
   

8. Turn on the Status toggle for Facebook.

9. Click Instant Sync to sync immediately, or wait for the refresh interval.

   

10. Configure the Refresh interval in the Configuration tab, if required.

    

Tip

Verify the audience is created/synced in Facebook Ads Manager → Audiences after 10-15 minutes (if Instant Sync was used) or after the scheduled refresh.

Value-based Customer List

This method syncs a customer list with an associated value (e.g., LTV, purchase value) to create Value-Based Audiences with which look-alike audiences can be created in Meta.

1. Ensure your audience source includes a known value field for all users.
2. Navigate to the Schema tab.
3. Add the required identifiers (e.g., Email, Phone).
4. Add the Value schema to map it with Facebook’s value schema.
5. Click Update schema.
   
6. Go to the List Sync tab and click Map Schema for Facebook.
   
7. In List to sync, select an existing value-based list or +Create New Value Based Audience List.
   
8. In Schema Mapping, map the Value schema and other identifiers.
   
   
9. Click Save List and Schema.
10. Turn on the Status toggle and click Instant Sync.
    
11. You can view the audience in Meta under “Value based sources” while creating lookalike audiences.
    
12. Configure the Refresh interval in the Configuration tab, if required.