Facebook Audiences

Introduction

This guide explains how to setup Facebook for use with Cyclr, as well as installing a Facebook Audiences Connector.

Setup & Authentication

Overview

Facebook Audiences API uses OAuth 2.0. You should sign up for an application on Facebook first and get an OAuth client ID and client secret.

The process of having your app approved by Facebook may take around 5 business days.

Remote Setup - performed by Cyclr Partner

Log into your Facebook account.
Create a Facebook Developer account if you don’t already have one: https://developers.facebook.com
Go to My Apps: https://developers.facebook.com/apps
Click Create App, and select “Business” as the app type.
Complete the following sections:
- App Display Name This is the name your users will see when they grant consent to access their data.
- App Purpose (set to Clients.)
Click Create App (You will then be asked to enter your password).
You should be faced with a screen titled Add Products to Your App.
Under Marketing API, select Set Up.
This should now be added.
In the menu on the left, select Facebook Login > Settings.
Under Valid OAuth Redirect URIs enter the Callback URL of your Cyclr Partner Console and click Save Changes.
The URL is in this format: https://{Your Cyclr Service Domain}/connector/callback
Under Settings, Basic on the left menu, you'll be able to complete any missing sections, and copy your App ID and App Secret.

Once your app has been approved by Facebook, you'll be able to use these to authenticate your App in Cyclr.

Partner Setup in Cyclr Console

Having created an OAuth app within Facebook to obtain a Client ID and a Client Secret, go into your Cyclr Partner Console:

Go to Connectors > Application Connector Library.
Use the search box to locate the Facebook Audiences Connector entry.
Select the Pencil button.
Select the Settings tab.
Enter the below values:

Property	Description
Client ID	The App ID of your Facebook app.
Client Secret	The App Secret of your Facebook app.

Select Save Changes.

Additional Information

Roles and Test Users

If your application hasn’t been approved by Facebook, you can set the users that can interact with the application from the Facebook developer console.

To create a test user, select the menu on the left side of the screen, and select Roles > Test Users.

Official Facebook Documentation

Register - Meta App Development - Documentation - Meta for Developers