The WebEngage Knowledge Base Developer Hub

Welcome to the WebEngage Knowledge Base developer hub. You'll find comprehensive guides and documentation to help you start working with WebEngage Knowledge Base as quickly as possible, as well as support if you get stuck. Let's jump right in!

Get Started    

Export Segment to Facebook

A step-by-step guide on how you can seamlessly export users details to your Facebook Business account

Skip the tedious daily data uploads. Configure your one-time Facebook integration and start re-engaging your users on Facebook and Instagram with highly contextual campaigns instantly!

You can choose to integrate multiple Facebook Business Accounts with your WebEngage account. Simply follow the steps listed here, and you'll be good to go in just 5 mins.

This is a great way to leverage the user data (user attributes) and behavioral data (events & event attributes) tracked for your app and website to create highly defined Audiences for Facebook & Instagram campaigns. And, create Lookalike Audiences that help amplify your campaign's visibility to users with matching interests, locations, and gender.

How to Export

Please Note

A segment must include a minimum of 20 users for it to be eligible for export to Facebook Business, as per their guidelines.

You can export a segment to multiple Ad Accounts, through various sections of your dashboard by following these simple steps:

Step 1: Click on the Facebook Icon

Once you have created a Segment in your dashboard, you can choose to export it to an integrated Facebook Business Account through the following sections:

Export through List of Segments

As shown below, click on the overflow menu nested beside a Segment's name in the List of Segments to export it. In doing so, you will be prompted by a pop-up allowing you to customize the export Frequency and create a new Audience.

Click to enlarge

Click to enlarge

Export through Segment Overview

As shown below, click on the Facebook icon on the top panel of a Segment's Overview to export it. In doing so, You will be prompted by a pop-up allowing you to customize the export Frequency and create a new Audience.

Click to enlarge

Click to enlarge

Export through Segment's List of Users

As shown below, click on the Facebook icon placed on the top right of the table to export the List of Users to your Facebook Ad Account. In doing so, you will be prompted by a pop-up allowing you to customize the export Frequency and create a new Audience.

Click to enlarge

Click to enlarge

Step 2: Select Ad Account ID

Click to enlarge

Click to enlarge

As indicated above, you can choose to export a segment to only one Ad Account at a time. You can always repeat the process to export the segment to additional Ad Accounts that have been integrated with your WebEngage account.

Step 3: Select Export Frequency

Click to enlarge

Click to enlarge

As shown above:

  • Select One-time to export details of all the users who are included within the segment at present

  • Select Recurring to sync Facebook Audience with the segment in real-time

Let's quickly elaborate on the implications of export frequency:

One-time & Recurring Export

As discussed under Core Concepts of Segments, all segment created in WebEngage are rolling and dynamic in nature. This means that users are constantly added to / removed from a segment, as per the rules defined by you. This helps ensure that at any given point in time, a segment includes only those users whose actions (events) and attributes match the rules of segmentation specified by you.

Thus, with reference to the context discussed above, here's how each export frequency works:

One-time Export: The segment will be exported only once to the selected Ad Account. This means that if new users are added to the segment, or are removed from it in the future, then you may have to export the list again.

Recurring Export: The segment will be exported as a New Audience by default. This allows us to sync the Facebook Audience in real-time with the Segment. Hence, before each sync cycle, all the users are removed by Facebook from the particular audience and are re-populated with details of the new users that are currently a part of the segment.

Step 4 (If Recurring Export is selected): Specify Frequency

Click to enlarge

Click to enlarge

As shown above, you can select the frequency of a recurring export as Daily, Weekly or Monthly, depending on the rules of segmentation and your re-engagement strategy.

Step 4 (If One-time Export is selected): Specify Audience Type

If you have chosen Recurring Export at Step 2, then the segment will be exported as a New Audience by default. In such cases, this option will be disabled.

Click to enlarge

Click to enlarge

As shown above:

  • Select Create New Audience in Facebook to export the segment as a separate list in your Business Account

  • Select Add to Existing Audience in Facebook to export segment to an existing list

    • In doing so, you will be prompted to select from a list of Existing Audiences (in the selected Ad Account), in the following field

Step 5: Select Existing Audience / Name New Audience

If you have chosen Create New Audience, then give it a unique name that helps you instantly identify it's purpose and user properties in your Facebook Ad Account

If you have chosen Add to Existing Audience, the select the name of the Facebook Audience to which you'd like to add the user details.

Next, click Export to Facebook and start working on a solid Facebook-Instagram re-targeting strategy :) Here are a few ideas to get you started.

User Details Exported to Facebook

Facebook allows third-party integrations like WebEngage, to export to a limited pool of details to any Business Ad Account, in a specified format. For the same reason, the format of the user details listed below could be different from the User Attributes shown under a User Profile or other sections of your dashboard.

  • For all the user details listed below, if the corresponding information is missing or not available at the moment for a user, then the field will remain blank (value will be set to Null).

  • Further, if you have passed a user's email address and phone number as an encrypted value or hashed data, then it will not have any impact on the details being exported. Facebook will internally decrypt and match the hashed values against their database to identify the users and populate their respective details in your Ad Account's Audience.

Here's a list of all the user details that are exported to your Facebook Audience:

User Details
What It Means

FIRST_NAME

User's first name

LAST_NAME

User's last name

GENDER

User's gender

EMAIL

User's registered email address

PHONE

User's registered phone number

MOBILE_AD_ID

This filed includes:

  • Advertising ID for Android users
  • Vendor ID for iOS users
  • Is blank for Web users

DOB_YEAR

The year of birth, as tracked against the system user attribute, birth_date

DOB_MONTH

The month of birth, as tracked against the system user attribute, birth_date

DOB_DATE

The date on which the user was born, as tracked against the system user attribute, birth_date

CITY

City, as per user's current location

STATE

State, as per user's current location

COUNTRY

Country, as per the user's current location

ZIP

Postal code/ ZIP code of the user's current location

EXTERNAL_ID

Indicates the LUID or unique ID assigned to a user in your WebEngage account

FAQs

Here are a few additional pieces of information to help you seamlessly manage your Facebook Ad Account integrations with WebEngage:

What happens after a Segment is Exported to Facebook?

Depending on the number of users included within the segment, it may take up to a few minutes to complete the process. As shown below, you can track the progress and sync status of all exported segments through Channel < Facebook, nested under Integrations in your dashboard.

Click to enlarge

Click to enlarge

As shown above:

  • You can choose to delete an integrated Ad Account or modify the integration's name anytime you like through the overflow menu placed on its right.
  • You can choose to Edit the rules of segmentation or Pause a recurring export anytime you like, using the Actions menu nested beside each exported segment.
  • Once the export is complete, you will be able to see the exact number of users that have been found on Facebook under the column, Audience Size in Facebook.
    • This number is updated daily at 12 pm UTC and 12 am UTC.
    • However, in cases where the audience strength is less than 1,000 users, you will simply see <1,000 against the segment.

Where can I find my Facebook Ad Account ID to integrate it with WebEngage?

You can find your Ad Account ID in the Business Manager section of your Facebook Business account.

Click to enlarge

Click to enlarge

As shown above, the Business Manager shows a list of all the ad accounts that belong to your business. Simply copy the Ad Account ID for the account that you want to integrate with WebEngage and follow these steps :)

Why is the status of my Facebook integration, Inactive?

Whenever you add your Facebook Ad Account to WebEngage, by default, the integration is in an Inactive state. This is so because when you add your Facebook Ad Account in WebEngage, WebEngage sends a request to your Facebook Business account for access to a few permissions. Once WebEngage has access to these permissions, you be able to export segments to Facebook.

Click to enlarge

Click to enlarge

To grant access to WebEngage, please click on the Activate link in your WebEngage dashboard for the Facebook ad account integration that is currently in an Inactive state. Once you click this link, you will be directed to your Facebook Business account page where you can approve the access to the relevant permissions.

We hope this has enabled you to successfully export segments to your Facebook Business Account. Please feel free to drop in a few lines at [email protected] in case you have any further queries or related feedback. We're always just an email away!

Updated about a month ago

Export Segment to Facebook


A step-by-step guide on how you can seamlessly export users details to your Facebook Business account

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.