Documentation / Product / Integrations / Facebook

Facebook Authorization

If you have not already done so, you will need to set up a Facebook Ads Manager account before you begin the process described below.

You may authorize in one of two ways:

Note: Regardless of authorization type, before you can build a custom audience in Facebook, you must agree to the Facebook Custom Audience Terms of Service.

Facebook User

Authorizing as a Facebook user will guide you through an Oauth process to authorize access to ad accounts tied to that particular Facebook user. Using Oauth is fast and simple, but can be prone to failure in the long run as authorizations can be canceled if the user changes their password, leaves the organization, and some other authorization invalidating event.

  1. Navigate to the Facebook integration in the Integrations section of Lytics. facebook 215
  2. Navigate to Authorizations.
  3. Click New Authorization.
  4. Select the Facebook User authorization type.
  5. You will be prompted to login to Facebook and grant permissions. You will then need to enter a description for your authorization. facebook oauth description
  6. Click Authorize to save the authorization.

You are now ready to start a workflow with Facebook.

Business Manager System User

Authorizing with a Business Manager System is not tied to a specific user, so it is more reliable in the long-term than the User Oauth, and is valid until revoked in the Business Manager settings. This is the recommended authentication method if possible.

Before creating a system user, your Facebook Business Manager must:

  • Have an admin user.
  • Own a Facebook app. You should claim the app and associate it with a business via API or in Business Manager. To see your apps, visit the Facebook Apps page. Please note that the app must not be listed as "in development". In development apps are not meant for production or live advertising. Your app must also be associated with the Ads Account ID you want to send audiences to. This can be configured under Advanced Settings for your App.

Once you satisfy these requirements, complete the following steps to set up your authorization:

  1. Go to Business Settings in Facebook. Under Users click System Users, then click Add to create a new System User.
  2. Give a name to the system user and select Employee as the role, then click Create System User. Facebook Create System User
  3. Assign Ad Accounts to the System User by selecting Add Assets. Then select the Ad Accounts, choose the Ad Account that you would like to push Lytics Audiences to, and then assign it Admin Access - Manage Ad Account Facebook Ad Account - Manage
  4. Next you'll need to generate a token that will be entered into Lytics to make API calls with. To start this, select Generate New Token.
  5. Select your app image and make sure that ads_management is checked. Facebook Ads Management Then click on Generate Token
  6. The generated token will be only shown once. Copy it, and keep it handy for authorizing in Lytics.
  7. Navigate to Facebook in the Integrations section of Lytics. facebook 215
  8. Navigate to Authorizations.
  9. Click New Authorization.
  10. Select the Business Manager System User authorization type.
  11. You will be prompted to input an Access Token and Description. Enter the Access token you created in step six. Screenshot from 2018-12-03 16-41-31
  12. Click Authorize to save the authorization.

You are now ready to start a workflow with Facebook.