Skip to main content

Configure Facebook Advanced Analytics

You can configure the Facebook Advanced Analytics API for LiveRamp to enable report automation and visualization in the LiveRamp Clean Room UI. The end-to-end process will take ~2-3 weeks. See the sections below for more information.

Overall Steps

Perform the following overall steps to configure Facebook Advanced Analytics:

  1. Enable LiveRamp users

  2. Initiate API review and permissions

  3. Update the LiveRamp user and generate an API token

  4. Configure the Facebook token

  5. Create the data connection

For information on performing these steps, see the sections below.

Prerequisites

You must have a Facebook Advanced Analytics instance configured and Conversions API (CAPI) support prior to initiating the API flow. Use the steps below to configure a connection between LiveRamp Clean Room and Facebook Advanced Analytics.

Enable LiveRamp Users

Add the specified LiveRamp users in your Facebook Advanced Analytics instance:

  1. In Facebook, navigate to Business Settings.

  2. Select the instance.

  3. Click Add People.

  4. Select each person.

    1742

  5. Slide the Manage Instance toggle to the right.

  6. Click Assign.

Initiate API Review and Permissions

  • Reach out to your Facebook Advanced Analytics representative requesting API capabilities with LiveRamp to upload and templatize queries. LiveRamp requires the following API permissions:

    • Template API

    • Upload API

Once requested, the Facebook team will complete an API review in your account prior to providing LiveRamp with API permissions. The typical turnaround time for review approval is 5 business days.

Update LiveRamp User and Generate API Token

Procedure. To update the system user and generate an API token:

  1. In Facebook Advanced Analytics, navigate to Business Settings → Accounts → Apps → Add People.

  2. Add the Advanced Analytics system user to the list.

  3. Navigate to Business Settings → Users → System users.

  4. Select the Advanced Analytics system user.

  5. Click Generate new token.

  6. In the Select app list, select Advanced Analytics API

  7. Save the API token for use with your LiveRamp Clean Room configuration.

Configure the Facebook Token in LiveRamp Clean Room

Procedure. To configure the Facebook token in LiveRamp Clean Room:

  1. Navigate to Data Management → Credentials.

  2. Click New Credential.

    creds_add_new.png

  3. On the Add Credential screen:

    1. Enter a name for the credential.

    2. Select Facebook AA Credentials as the credential source.

    3. Enter your FACEBOOK_TOKEN.

    creds_faa.png

  4. Click Add Credential.

    LiveRamp will validate the connection needed to create, submit, and run queries for report generation in the UI.

Create the Data Connection

Procedure. To configure a data connection:

  1. From the LiveRamp Clean Room navigation pane, select Data Management → Data Connections.

  2. From the Data Connections page, click New Data Connection.

    data_cxn_new.png

  3. Select Facebook Advanced Analytics.

    Screenshot 2024-03-28 at 21.32.55.png

  4. Select the credentials you created or generate them here.

    Screenshot 2024-03-28 at 21.35.50.png

  5. Configure the data connection:

    • Name: Enter a name of your choice.

    • Category: Enter a category of your choice.

    • Dataset Type: Select Facebook: Advanced Anayltics Data.

    • Instance Identifier

    • Template ID

    • Version

  6. Review the data connection details and click Save Data Connection.

    Note

    All configured data connections can be seen on the Data Connections page.

Template ID Guidelines

These guidelines only apply to testing your Facebook Advanced Analytics data connection. LiveRamp Clean Room supports all macros and parameters when running queries in a clean room.

Procedure. To validate your data connection:

  1. Use the template ID of a SQL query in Facebook that does not include macros. Using a template ID with SQL code that includes macros will cause your data connection to fail.

  2. Click Save Data Connection.

Queried data is available for 90 days in Facebook Advanced Analytics. After 90 days, the dataset will no longer be available.

In this section: