Integration of Instagram Insights with BigQuery



๐Ÿ“ข Introduction

This module integrates with the Instagram Insights API, enabling you to collect instagram account 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 Instagram 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 Instagram account before starting the configuration.

๐Ÿ”ง Module Setup

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





Select Instagram Insights from the list of available integrations.





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





๐Ÿ”‘ Authorization

๐Ÿ’ก Tip: If you have previously authorized the Instagram 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 Instagram Insights data will now be synchronized with BigQuery, providing you with detailed insights into the performance of your Instagram account.


๐Ÿ“Š Data Schema

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


๐Ÿ”Ž Click to view the data schema for the instagram_insights_account table
๐Ÿ”Ž Click to view the data schema for the instagram_insights_account_reach table
๐Ÿ”Ž Click to view the data schema for the instagram_insights_media table