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. If you are new to creating authorizations in Lytics, see the Authorizations Dashboard documentation for more information.

  1. Select Facebook from the list of providers.
  2. Select the method for authorization. You may authorize in one of two ways. Both of Facebook's authorization methods support the Export Audiences and Export Audiences (Web Traffic) job types.

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. You will be prompted to login to Facebook and grant permissions. You will then need to enter a description for your authorization. facebook oauth
  2. Enter a Label to identify your authorization.
  3. (Optional) Enter a Description for further context on your authorization.
  4. Complete the configuration steps needed for your authorization.
  5. Click Save Authorization.

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 company's Facebook developer app facebook app 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. Enter a Label to identify your authorization.
  8. (Optional) Enter a Description for further context on your authorization.
  9. Enter the Access Token you created in step six.
  10. Click Save Authorization.