Collecting data from Facebook Ads

Follow this guide to collect data from Facebook Ads and preview the data.

Understanding Datastreams and Authorizations

When you connect to Facebook Ads through Adverity, you authorize Adverity to access your account. Adverity stores this authorization information in an Authorization, and stores the data collection configuration in a Datastream.

You can create several Datastreams using the same Authorization. The Datastreams collect information from the same source, with the same login credentials, with different configurations.


Before you start collecting data from Facebook Ads, perform all of the following actions:

Ensure that the account you use to connect to Facebook Ads has the correct roles and permissions to collect the data. Edit these roles and permissions in Facebook Business Manager. For more information, see the Facebook documentation.

  • Add the Employee or higher business manager role to the account.

  • For an ad account, add the View performance permission.

  • Add the View Page performance permission to the classic page.

Depending on your specific configuration, the following additional permissions may be required:

  • Leads Access or Manage Page: To access lead form results.

  • Manage catalogue: To obtain metadata for advertised catalog objects.

  • Manage line of business: To retrieve data specific for attribution reports.

Alternatively, if you do not use Facebook Business Manager, configure the roles and permissions on the page level. For more information, see the Facebook documentation.

Creating Facebook Ads Datastream

Connecting to Facebook Ads

To connect to Facebook Ads, follow these steps:

  1. Click the Connect element and select the Workspace you work with in Connect, Enrich & Transfer.

  1. In the top right corner, click + Add new datastream.

  2. Search for and click Facebook Ads.

  1. Click Next.

  1. Choose one of the following options:

    • Click Setup a new Authorization and set up the new Authorization with your own login credentials.

    • Choose an existing Authorization.

  1. Click Next.

Choosing what data to collect

To choose what data to collect and customize the Facebook Ads Datastream configuration, follow these steps:

  1. Click Custom Configuration.

  1. (Optional) Rename your Datastream.

  1. In Businesses, Accounts, and Campaigns, select the businesses, accounts, and campaigns for which to collect data. If you do not select any items in a drop-down list, Adverity collects data for all items in the drop-down list.

  1. In Fields, change the list of fields that you want to see in your Data Extract.

  1. Click Next.

Choosing where to transfer your data

To choose where to transfer your data, follow these steps:

  1. To assign Destinations to your Datastream, select their checkboxes. For more information on Destinations and their configuration settings, see Introduction to transferring data.

  1. Click Next.

Collecting initial data

To collect the initial data, follow these steps:

  1. Choose the time period for which data is collected.

  1. Click Run Fetch.

Previewing data collected from Facebook Ads

The fetch collects data from Facebook Ads which takes some time. The Overview page of the newly created Datastream is now displayed. To preview the collected data, follow these steps:

  1. In the All tasks tab, find the task at the top of the list, and click Show extracts.

  2. Click the top hyperlink.

  3. The Data Extract is displayed in a table containing the data that you have fetched.

Additional information

This guide does not cover the whole functionality of the Facebook Ads Connector. For more information on all features of the Facebook Ads Connector, see Facebook Ads Connector reference.

For more information on the data fields that you can import from Facebook Ads, see List of supported fields.

For more information on rate limiting, see the Facebook documentation.

What’s next?

After collecting data from Facebook Ads, harmonize your data so that it conforms with Adverity's unified naming and formatting conventions.