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 need your App ID and App Secret from your Facebook app. You’ll then copy these keys into your ReachFive settings. Follow the instructions provided on this page to use Facebook Login on your application by leveraging the power of ReachFive.

Default values for Facebook

The default public profile values for Facebook are:

  • id

  • first_name

  • last_name

  • middle_name

  • name

  • name_format

  • picture

  • short_name

Create a Facebook application

Prerequisites

  • You must have a Facebook Developer account.

  • You must have the all Facebook features enabled on the ReachFive Console.

    Check with your ReachFive administrator if you are unsure if the features are enabled.

Instructions

  1. Go to Facebook for Developers.

  2. Log in with your account and create a new app.

    If prompted for the application type, choose Consumer.
  3. In Settings  Basic:

    1. Select an App Icon.

    2. Add your Privacy Policy URL.

    3. Add your Terms of Service URL.

    4. Choose the Category that best fits your usec case.

    5. Don’t forget to Save your input.

Set up Facebook login

You must set up Facebook Login in order to integrate ReachFive and Facebook with your application/site.

Prerequisites

  • You must have a Facebook Developer account.

  • You must have the all Facebook features enabled on the ReachFive Console.

    Check with your ReachFive administrator if you are unsure if the features are enabled.

Instructions

  1. Go to your Facebook Developer Dashboard.

  2. Under Products, set up Facebook Login.

    Skip the default Quickstart approach.
  3. Go to Facebook Login  Settings on the sidebar.

  4. Make sure Client OAuth Login is enabled (yes).

  5. Under Valid OAuth Redirect URLs, enter https://<REACHFIVE_DOMAIN>/login/callback.

    <REACHFIVE_DOMAIN> is your ReachFive domain.
  6. Don’t forget to Save your input.

Facebook app validation

Facebook has a streamlined process that selects the permissions and features needed based on App Type.

You select the type of application when you Create a Facebook application. If you need different features and permissions, consider trying a new application type.


Consumer app type

Typically, you will need a Consumer app type when integrating your application/site, Facebook, and ReachFive. See the list below for up-to-date information regarding Consumer apps and their associated permissions and features.

The Consumer app type (may be displayed as Build Connected Experiences in the selection modal) is for apps that integrate consumer-related products like Facebook Login to provide app users with a more personalized experience.

Available Products
  • Analytics

  • App Events

  • App Links

  • Audience Network

  • Facebook Login

  • Facebook Pixel

  • Instagram Basic Display

  • oEmbed for Facebook

  • oEmbed for Instagram

  • Sharing

  • Social Plugins

  • Webhooks

Available Permissions
  • email

  • instagram_graph_user_media

  • instagram_graph_user_profile

  • public_profile

  • user_age_range

  • user_birthday

  • user_friends

  • user_gender

  • user_hometown

  • user_likes

  • user_link

  • user_location

  • user_photos

  • user_posts

  • user_videos

Available Features
  • None

Make the app public

At the top of your App page in Facebook for Developers, toggle from In development to Live.

fb make app public

The grey toggle that displayed In development will turn green and display Live.

Your Facebook application is now live.

Configure Facebook as Provider on ReachFive

Prerequisites

  • You must have a Facebook Developer account.

  • You must have the all Facebook features enabled on the ReachFive Console.

    Check with your ReachFive administrator if you are unsure if the features are enabled.

Instructions

On Facebook for Developers
  1. Go to Settings  Basic.

  2. Copy your App ID and App Secret.

    fb appId appSecret
On your ReachFive Console
  1. Go to Settings  Providers.

  2. Choose Facebook.

  3. Paste your Facebook App ID and App Secret.

    This is labelled as Client ID and Client Secret in the ReachFive Console.
  4. Add at least the following Permissions. See available permissions for more.

    1. public_profile

    2. email

      The data that you collect requires user consent. Users can choose to mask their email address. In this case, you would not get the user’s email address. However, the profile will still be created on ReachFive but with no email address associated with the user.
  5. Activate Facebook as a ReachFive social provider by toggling the Visible slider to Green.

    fb appId appSecret from console
  6. Don’t forget to Save your input.

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.