Skip to content

Facebook Custom Audiences

The Facebook Custom Audiences modules enable you to create a custom audience and add emails or users to the custom audience in your Facebook Ad account.

Getting Started With Facebook Custom Audiences

Prerequisites

In order to use Facebook Offline Conversions with Ibexa Connect, it is necessary to have a Facebook account and a Facebook Business Manager account.

Note

The module dialog fields that are displayed in bold (in the Ibexa Connect scenario, not in this documentation article) are mandatory!

Connecting Facebook to Ibexa Connect

  1. To connect your Facebook account to Ibexa Connect, follow the general instructions for Connecting to services.

    61f26c5ebb613.png

  2. After you click the Continue button, Ibexa Connect will redirect you to the Facebook website where you will be prompted to grant Ibexa Connect access to your account.

    61f26c5fe60fb.png

  3. Confirm the dialog by clicking the OK button.

Actions

Create a Custom Audience

Creates a custom audience.

Note

If the following error is returned, you will need to go to the URL provided and accept the Custom Audiences Terms.

61f26c61076fa.png

Business Manager Select the Business Manager that contains the ad account you want to use.
Ad Account Select the ad account where you want to create a custom audience.
Name Enter a name for the new custom audience.
Description Enter the description of the custom audience.

Add Emails to a Custom Audience

Adds users with email matches to a custom audience.

Business Manager Select the Business Manager that contains the ad account you want to use.
Ad Account Select the ad account where you want to create a custom audience.
Custom Audience Select the custom audience you want to add the users' emails to.
Emails Add emails to the custom audience.

Add Users to a Custom Audience

Adds users with multiple details to the custom audience.

Note

You can add an unlimited number of records to an audience, but there is a maximum of 10,000 at a time. It may take up to 1 hour before Facebook adds users to an audience.

Business Manager

Select the Business Manager that contains the ad account you want to use.

Ad Account

Select the ad account where you want to create a custom audience.

Custom Audience

Select the custom audience you want to add users to.

Data

Add user data to the custom audience. Each added item represents one user.

Email

Enter the email address.

Phone

Remove symbols, letters, and any leading zeroes. You should add the country code prefix if the Country field is not specified (below).

Gender

Select the gender of the user.

Birth year

Enter the birth year in the YYYY format, from 1900 to the current year.

Birth month

Enter the birth month in the MM format (01 - 12).

Birth day

Enter the birth date in the DD format (01 - 31).

First name

Enter the first name. Use a-z only. No punctuation. Special characters in UTF-8 format.

Last name

Enter the last name. Use a-z only. No punctuation. Special characters in UTF-8 format.

First name initial

Enter initials of first name. Use a-z only. Special characters in UTF-8 format.

State

Enter the 2-character ANSI abbreviation code. Specify states outside the U.S. in lowercase, with no punctuation, no special characters, and no white space.

City

Enter the user's city. Use a-z only. No punctuation. No special characters.

ZIP

Enter the ZIP code. Use only the first 5 digits for U.S. Use Area/District/Sector format for the UK.

Country

Enter the 2-letter country code (lowercase) in ISO 3166-1 alpha-2 format.

Mobile advertiser ID

Enter the mobile advertising ID. (Apple's Advertising Identifier/IDFA, Android's Advertising ID, Facebook App User IDs).

External ID

Enter the custom identifier.

Troubleshooting

Failed to Add/Update a Custom Audience - Error "2650"

Issues: While adding users using the Add Emails/Users to a Custom Audience module, it returns the following error:

  • Error "2650"

  • Failed to Update Custom Audience

  • (#2650) Failed to update the custom audience: This audience was created from data source FILE_IMPORTED.MULTI_HASHES, which does not support data source FILE_IMPORTED.HASHES_OR_USER_IDS. (2650, OAuthException )

61f26c621b935.png

Reason: Facebook Custom Audiences won't let Ibexa Connect add emails or users unless the Custom Audience were created by Ibexa Connect. This error indicates that the selected Custom Audience wasn't created by Ibexa Connect, but by another platform or via manual upload.

Solution:

  1. Create a custom audience from Ibexa Connect using Create Custom Audience or other modules using a scenario.

  2. Now go back to your previous scenario, and add your member to that newly created custom audience.

If you continue to receive this response, you may need to accept Facebook Custom Audience Terms and Condition in each of your ad accounts. You can follow the steps below.

Facebook Ad Account:

1. Open your Facebook’s Custom Audiences Terms.

2. Select your Ad Account under the Account dropdown.

3. Click Accept.

4. Open your Facebook’s Business Tools Terms.

5. Select your Ad Account under the Account dropdown.

6. Click Accept.

Business Manager Account:

1. Find your ad account ID. Check this guide, as Facebook provides instructions on how to locate the account ID.

2. Once you copy the ID, add it to the end of the following URL after the equal sign, and open it in your browser: https://business.facebook.com/ads/manage/customaudiences/tos/?act=

3. Click Accept.

4. Repeat steps 1-3 for any other ad accounts.