Setup Guide

This guide will help you set up Facebook Custom Audience as a destination in the RudderStack dashboard. It also lists the configuration settings required to correctly send data from the supported sources to Facebook Custom Audience.

Make sure you have already set up a Reverse ETL source in RudderStack before following the steps in this guide.

Setup

In your RudderStack dashboard, go to Directory > Destinations > Cloud Destinations and search for Facebook Custom Audience.

Connection settings

Configure the following settings to set up Facebook Custom Audience as a destination in RudderStack:

Next steps

• Connect Reverse ETL source to Facebook Custom Audience

Configuration settings

Once you have specified the mappings, configure the below advanced settings to receive the data correctly in Facebook Custom Audience:

FAQ

What are the prerequisites for creating an audience list?

Before creating a new audience list, make sure that:

• You are an admin system user. To check, go to Users > System users in your Facebook business account.

• The ad account under which the audience list is created should be added as an asset for the system user, with manage permissions.
• The app for which you are creating the access token should be added as an asset of the system user with full control.

How do I add an app as a system user asset with manage permissions?

1. Log in to your Facebook Business Manager account.
2. Click Business settings.

3. Under Users, click System users.

4. Choose the system user from the opened list.
5. Click Add Assets for the above user.

6. Under Select asset type, click Apps and choose your app from the Select assets tab.

7. In the right-most App tab, enable the Manage app setting. Then, click Save Changes.

How do I create a new audience list?

1. Log in to your Facebook business account.
2. Click All tools in the left panel.

3. Hover over Create Audience and select Custom Audience.

4. Select Customer List and click Next.

5. Prepare your customer list by selecting and mapping the identifiers. Make sure you have enough identifiers before uploading the list.

6. Upload the CSV file you want to use for your new custom audience. Under the Does your list include a column for customer value? setting, make sure to select No, continue with a customer list that doesn’t include customer value.

You can also download the file template CSV and upload it.

7. Finally, click Import and create to create the audience.

The custom audience you create should have edit permissions. Otherwise, RudderStack will not be able to add or remove users from the list.

How do I check if the custom audience has edit permissions?

To check if the audience has edit permissions enabled, go to the Audiences tab, select your custom audience, and check the Actions dropdown. You should see the Edit option as seen below:

How do I obtain the Ad Account ID?

Go to your Facebook Ads Manager account where you can find the Ad Account ID in the account’s drop-down menu:

You can click on See More Ad Accounts if the required Ad account is not visible.

Where can I find the user Access Token for the application?

To generate the user access token for your application, you must first add it as a system user asset with manage permissions.

Follow these steps to generate a user access token required to use the Facebook Marketing API:

1. Under the system user, click the Generate New Token button and select the app from the dropdown.

2. Choose the Token expiration time.

3. Under Available permissions, select ads_read and ads_management.

4. Click the Generate Token button and copy the token credentials.

Should I use sessionIdAdd or sessionIdDelete before adding or removing users in Custom Audience?

sessionIdAdd and sessionIdDelete helps you track and use a particular session ID while adding or removing users. This is useful when you are sending data in chunks. If you do not include these fields, Facebook creates a session ID itself.

See the Facebook documentation for more information.

Questions? Contact us by email or on Slack