Facebook Connect

This page explains how to create a Facebook Application and connect it to your ReachFive account.

To use Facebook as a social login provider, you will need an App ID and App Secret from your Facebook app. Then, you’ll need to copy these keys into your ReachFive settings.

Create a Facebook application

Go to https://developers.facebook.com, login with your account and create a new app.
Name your application.
Provide a Display Name and a Contact Email. Choose a Category and click Create App ID.
In Settings Basic, select App Icon, Privacy Policy, Terms of Service URL, Category and Business Use.
Save your changes.

Go back to your dashboard. Scroll down Click on PRODUCTS. Then choose Set Up the Facebook Login Product (left panel).

Go to Facebook Login.

Use the left-hand navigation to go to Settings (do not use the Quickstart you arrive on by default).

You will have access to Client OAuth Settings for Facebook Login.

In the Valid OAuth redirect URIs, enter https://{REACHFIVE_DOMAIN}/login/callback where REACHFIVE_DOMAIN is your ReachFive domain.

Click Save Changes.

Validate your Facebook app - permissions

Before you can ask users to share some of their data, your app must go through the App Review. Specifically, you ask Facebook to grant selected permissions.

During this validation process, you must demonstrate that those data are useful for your business, and used to improve your customers experience.

These permissions are granted by default:

default
email

This permission is mandatory to use Analytics Page Likes and Interests in the ReachFive Console.

To get additional permissions, you must go through the App Review:

user_gender
user_age_range
user_link
user_birthday
user_location
user_hometown
user_friends
user_likes
user_photos
user_videos

You also need "Page Public Content Access" to use Analytics > Page Likes and Interests in the ReachFive Console.

Validate your Facebook app - how-to

Choose a hidden URL from your website to implement our Facebook connect Widget. It must be an externally accessible page.

Add our widget with the following snippet.

(function() {
var g = document.createElement('script'); g.type = 'text/javascript'; g.async = true;
g.src = '//REACHFIVE_DOMAIN/js/og.js'; (1)
var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(g, s);
})();

1	Replace `REACHFIVE_DOMAIN` with your own domain.

Create your scenario of how the data will be used.
Create the associated segments.
Go to Login pop-up, then add a title and toggle the pop-up on.
Go to Recommender, then click New rule.

Set up the rule with your scenario, select the segment, and product to recommend (Link). Add as many rules as you need for each permission.
Screen video for each scenario.

Remember to delete your application in your Facebook account between each video. Go to your Facebook Profile Parameters App, and website then check your application and delete it.
Go to https://developers.facebook.com, then App Review My permissions and Features, then select Add additional permissions and features.
Choose the permissions you want to add, then click Continue.
For each permission, specify the required information, type in your scenario, and upload your screencast.

To submit permissions review while your application is already live, you will have to create a test app to capture the screencast with all the permissions.

Make the app public

Next, look on the top of the page, and click on "OFF" or "DESACTIVÉ".

Then select a category on the pop up and Confirm.

The grey toggle that displayed "off" will turn green and display "on". Your Facebook application is now live.

Configure Facebook as Provider on ReachFive

First, get your Facebook App Id and App Secret : go to Settings > Basic and click to Show to reveal the App Secret.

On the ReachFive Console, go to Settings > Providers. Click on Add provider and Choose Facebook.

Copy your Client ID and Client secret from the Facebook settings page. Click on permissions and add:

public_profile
user_gender
email

Then activate the slider named "Visible“ and hit SAVE.

Wrap-up

That’s all you need to integrate your ReachFive account with your Facebook application.

You only need to have your Facebook Application validated to go live.

If you want to implement your own button instead of the widget, follow the Facebook Guidelines.

For best practices about Login permissions read the Facebook recommendations.