Integration of Facebook Insights with BigQuery



πŸ“’ Introduction

This module integrates with the Facebook Insights API, enabling you to collect campaign data and store it in Google Cloud BigQuery. Gain deeper insights into your data and optimize the performance of your marketing efforts with real-time data collection.


πŸ“ Configuration Guide

Follow the steps below to connect Facebook Insights with BigQuery. Once the setup is complete, your ad data will be automatically transferred to your BigQuery project.

πŸ’‘ Tip: Make sure you have admin access to your Facebook account before starting the configuration.

πŸ”§ Module Setup

Go to the Collect section in the menu > Click Create Data Collect.





Select Facebook Insights from the list of available integrations.





Enter the Collector Name, e.g., "Facebook Collect".





πŸ”‘ Authorization

πŸ’‘ Tip: If you have previously authorized the Facebook Insights module and do not require additional permissions, you can skip this step.

Click Authorize.





Grant the necessary permissions.





Select the appropriate account from the dropdown list.




Some tables that store the entire data historyβ€”such as postsβ€”are refreshed less frequently; you can adjust this setting here.




⏳ Historical Data and Scheduling

Select the date range for which you want to fetch historical data.




During the initial setup, you can retrieve data going back up to 12 months, with the possibility of importing older data.


A data synchronization schedule will be created automatically. More information on this topic can be found here.


Click Create to complete the configuration.


βœ… Done! Your Facebook Insights data will now be synchronized with BigQuery, providing you with detailed insights into the performance of your ad campaigns.


πŸ“Š Data Schema

Expand the tables below to view the full data schema collected from Facebook Insights.


πŸ”Ž Click to view the data schema for the fb_insights_city table
πŸ”Ž Click to view the data schema for the fb_insights_country table
πŸ”Ž Click to view the data schema for the fb_insights_page table
πŸ”Ž Click to view the data schema for the fb_insights_page_unique table
πŸ”Ž Click to view the data schema for the fb_insights_posts table
πŸ”Ž Click to view the data schema for the fb_insights_video_reels table