Facebook Ads: Setup guide#
This guide explains how to collect data from Facebook Ads.
Introduction#
For a list of the fields that you can collect from Facebook Ads, see Facebook Ads.
This video guide explains how to create and configure a datastream to collect your ad performance data from Facebook Ads.
Prerequisites#
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 a datastream to collect data from Facebook Ads#
The basics of creating a datastream to collect data from any data source are explained in our guide to Collecting data in Adverity. This guide contains information about the specific steps to create a datastream to fetch data from Facebook Ads.
Configuration: Choose the data you want to collect from Facebook Ads#
Note
This connector reports data in the timezone of the authorized ad account.
To choose what data to collect and customize the Facebook Ads datastream configuration, follow these steps:
(Optional) Rename your datastream.
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.
In Fields, change the list of fields that you want to see in your data extract.
Note
The actions, action_values, and conversions fields are group fields. This means that if you select one or more of these fields, and later select the Force action fields checkbox, this datastream will fetch all fields in the selected groups, even if the column is empty.
This could mean that your data extract will contain lots of empty columns. If you only want to keep some of these columns, you can use the cut custom script instruction to choose which columns to keep.
Alternatively, if you know which columns you want to include in your data extract, you can use the extendmissing custom script instruction to only add these columns. You can do this instead of using the Force action fields option.
For more information about action fields, including a list of all fields you can collect by selecting these group fields, see the Facebook Ads documentation.
Note
For information on configuring other Facebook Ads fields, see Advanced Facebook Ads tips.
What’s next?#
Apply Data Mapping to your collected data to harmonize data collected from different sources in Adverity.
Transform your data to meet your needs by creating and applying transformations to your datastream.
Load your data into Explore & Present to visualize your data in Adverity.
Load your data into an external destination of your choice.
Troubleshooting Facebook Ads#
The status of a campaign, ad set or ad is not correct when fetching data from Facebook Ads#
If the status of an object is incorrect, for example if an ad is inactive but its status is shown as active when fetching data for a long date range, this is because the metadata for the authorization used in this datastream is out of date.
To resolve this issue, follow the steps in Synchronizing metadata for the authorization used in this datastream.