All resources

Free Facebook Ads to BigQuery Connector by OWOX: Take Control of Your Ad Data at Scale

Running Facebook Ads is one thing. Reporting on them at scale? Reporting on them at scale with a Facebook to BigQuery solution? That’s a whole different beast.

Exporting Facebook ad data into BigQuery often means costly ETL tools, complex pipelines, or constant engineering help -  barriers that slow down insights.

Dashboard displaying Facebook Ads data flowing into BigQuery storage and being exported to Google Sheets and Looker Studio.

Analysts deserve straightforward control over their own ad performance data, without needing a full tech stack. That’s why we built this free, no-code Facebook Ads to BigQuery connector a part of the OWOX Data Marts. It lets you load, refresh, and manage Facebook Ads data directly into BigQuery, with full transparency and zero vendor lock-in.

No limits, no black boxes. Just your Facebook Ads data to BigQuery, exactly where you need it.

Why We Made This Free Connector

Most Facebook Ads connectors are either expensive, limited in what they pull, or completely opaque in how they work. We wanted to flip that model on its head. We believe analysts and marketers should own their data workflows, not rent them from third-party vendors.

So we built this open-source connector to give you:

  • Full access to all Facebook Ads API fields
  • Full control over how your data is extracted and loaded
  • A cost-free alternative to proprietary, paywalled solutions

This Facebook Ads to BigQuery connector from OWOX Data Marts is the first step toward a more open, self-owned future in marketing analytics. It is 100% free – no paywalls, no restrictions, no surprises.

Join the Open-Source Movement

We’re not just releasing a free connector – we’re inviting you to help shape the future of data and marketing analytics tools.

At OWOX, we believe that data access and transparency should be a right, not a luxury. That’s why this connector is 100% open-source – giving you full control over how it works, what it does, and how far it can go.

If you like what we do, please ⭐ star our GitHub repo to show your support – it helps us reach more analysts and grow the number of available connectors.

Also, feel free to:

  • Explore the code and customize it to fit your needs.
  • Contribute to this data connectivity ecosystem: suggest new connectors, pull new connectors, and/or documentation to support the wider community.
  • Join our community & share your feedback.

We’ve built the core, the foundation – now it’s your turn to take it further.

Why Bring Facebook Ads Data into BigQuery?

When it comes to running scalable marketing analytics, BigQuery is hard to beat. But getting raw Facebook Ads data into it? That’s where most teams hit a wall.

  • Complex pipelines that require engineering help
  • Limited access to raw data for modeling or enrichment
  • Expensive tools that gate key metrics or APIs

That’s exactly why we built this connector for Facebook ads to Google BigQuery – to unlock a better way. Here’s why it’s a must-have for data teams:

Automatically load TikTok Ads to BigQuery – no manual steps or third-party ETL required
No-code setup with a simple, open-source spreadsheet template
Full-funnel data access: impressions, clicks, CTR, video engagement, conversions, and more
Schedule recurring imports and incremental updates
Pull granular data across campaigns, ad groups, creatives, and audiences

This connector gives you the raw access, flexibility, and power needed to run marketing analytics your way – and at your scale.

And you don’t need to pay a cent or write a single line of backend code to get started.

Want even more control over your ad data?
If you're moving Facebook Ads to BigQuery, you’ll love what else you can connect, completely free and code-free:

Facebook Ads → Google Sheets

TikTok Ads → BigQuery
Reddit Ads → BigQuery
Twitter Ads → BigQuery

Unify your ad data, customize your analysis, and scale your reporting, your way.

Why OWOX’s Facebook Ads to BigQuery Connector Beats Other Tools

There’s no shortage of tools that push Facebook Ads data into BigQuery. Still, many come at a cost: restrictive pricing models, rigid pipelines, and limited visibility into what’s happening under the hood.

The OWOX connector was built to eliminate those problems:

  • 100% free and open-source: no usage fees, hidden limits, or tiered pricing. This connector is available free on GitHub as part of OWOX Data Marts.
  • Direct Facebook Ads to BigQuery flow: skips CSVs, staging layers, and 3rd-party services in between.
  • Full API coverage: extract any metrics, breakdowns, or dimensions available in Meta’s Ads API.
  • Own your schema: Define your destination table schema, assign clear field aliases, and adjust the structure to align with your specific reporting requirements.
  • Complete transparency: inspect, modify, and extend every pipeline component with open configs and SQL in your warehouse.

You don’t have to settle for a black-box ETL or worry about how much data will cost this month.

If you want total control over how Facebook Ads data lands in your BigQuery project, with zero vendor lock-in, the OWOX connector is built for you.

Facebook Ads Connector to Google BigQuery

How the Connector Works

We designed this connector to work out of the box for data analysts, marketers, and technical teams, as part of the OWOX Data Marts, with no middleware or ETL platforms required.

Here’s what’s under the hood:

  • It’s based on an open-source framework you operate yourself, removing the need for additional platforms, paid ETL tools, or manual CSV handling.
  • Connects directly to the Facebook Marketing API to fetch campaigns, ad insights, creatives, and account data.
  • It loads your Facebook Ads data to BigQuery tables directly 

And yes – it’s 100% free and open, with no usage limits.

You can use it to:

  • Replace pricey ETL tools with a solution you wholly own, built on OWOX Data Marts.
  • Schedule regular imports to keep your BigQuery tables fresh
  • Power Looker Studio dashboards and advanced models using clean, structured ad data

It’s the simplest, fastest way to start running Facebook Ads analysis in BigQuery – no waiting, no black boxes.

💡Check out this video for a step-by-step guide on connecting Facebook Ads to BigQuery using OWOX’s free template. It’s a quick and easy way to see the setup in action.

Step-by-Step Guide: Import Facebook Ads Data to BigQuery with OWOX Data Marts

Set up a fully self-managed, SaaS-free pipeline to import Facebook Ads data directly into BigQuery using OWOX Data Marts and a local server.

Step 1: Install Node.js and OWOX CLI ( ~2 min)

To run OWOX Data Mart locally, you’ll need to install Node.js and the OWOX CLI. This setup allows you to start a local server and work with OWOX Data Marts effectively.

To get started, install the LTS version of Node.js from nodejs.org and use a version manager like nvm or nvm-windows to avoid permission issues. Once Node.js is set up, you can install the OWOX CLI globally and run ‘owox serve’ to launch the local server.

Step 2: Connect Google BigQuery and Set Up Your Data Mart ( ~3 min)

Set up BigQuery as your destination and link it to a new Facebook Ads data mart in OWOX.

  1. Open your browser and go to http://localhost:3000.
Local host being redirected to the home page of OWOX Data Marts. i-shadow
💡 Follow our guide, where you’ll find easy-to-follow instructions on how to configure your storage in OWOX Data Marts.
  1. Create your Service Account JSON Key.
Navigation panel in Google Cloud Console showing the path to access service accounts by going to IAM and then selecting the Service Accounts section.
  1. Paste it into the ‘OWOX Service Account JSON Field’
  • Don’t forget to click ‘Save’.
OWOX connector configuration labeled ‘OWOX Service Account JSON Field’ where users paste their service account key for authentication. i-shadow
  1. Create your first Data Mart: Once storage is added, click on the Data Mart Tab, then on ‘New Data Mart’
OWOX Data Marts interface showing the main dashboard with the ‘New Data Mart’ button. i-shadow
  • Now, create the Data Mart, name the title as ‘Facebook Data’, as the data source
  • Choose the storage named ‘Facebook Ads Storage’ you just created
  • Click ‘Create Data Mart’.
Create Data Mart screen with title set to "Facebook Data" and storage selected as "Facebook Ads Storage". i-shadow

Now we will do the Data Setup

  1. Setup your Data Mart
    • Go to Data Setup Tab and then select Connector
Input Setup section in OWOX Data Marts with 'Connector' selected as the definition type for the data source. i-shadow
  • Click on Setup Connector and Choose Facebook Ads Connector
Setup Connector panel in OWOX Data Marts with Facebook Ads selected as the connector source.i-shadow

Step 3: Get a Facebook Ads Access Token ( ~1 min)

To connect your Facebook Ads account, you’ll need an access token. Let’s make sure you’ve got the right access credentials in place. 

Prerequisites

  • A Facebook account with access to the Meta for Developers portal
  • A Meta Developer App created in the Developers portal
  • Marketing API set up and enabled in your app
  • A valid Access Token generated via OAuth to authenticate requests

Steps to Obtain Credentials

  1. Log in to Meta for Developers
Meta Ads homepage with login button highlighted for accessing Meta for Developers.
  • Sign in using your Facebook account.
    (Use the account that has access to your Meta Ads Business Manager.)
Meta for Developers login screen showing login options with Facebook or account creation.
  1. Create a New App
    • Click My Apps in the top-right menu, then Create App
Meta dashboard with “My Apps” button highlighted to manage or create Facebook Apps.

Meta Developer console showing the option to create a new app in the Apps section.

  • In the App Name field, enter a name of your choice.
App creation screen with OWOX App name entered and contact email field shown.
  • For the use case, select Other
 Option selected to create an app without a use case under the “Other” category.
  • Choose Business as the app type → click Next
Selection of “Business” as the app type for managing Meta business assets.
  1. Connect to a Business Portfolio
    • Select the appropriate Business Portfolio
    • Click Create App
Business portfolio dropdown displayed while filling app creation details.
  1. Start Business Verification
    • Go to App Settings → Basic
Business verification section under App Settings showing the “Start Verification” button.

  • If prompted, connect your app to your business portfolio.
Popup for selecting a business portfolio to begin business verification.
  • Click Start Business Verification
 Dialog box with selected portfolio and “Start business verification” button highlighted.
  1. Submit Verification Info
    • Fill in the required fields with accurate contact and organizational information.
    • Ensure your submission meets Meta's requirements.
Security Centre in Meta Business Manager showing pending business verification.
  • Meta will review your submission within 2 business days.
Confirmation message stating business verification info was submitted.
  1. Set Up Marketing API
    • After successful verification, return to your app dashboard.
    • Locate the Marketing API card and click Set Up
Meta App Dashboard with Marketing API selected to set up for app integration.
  1. Grant Required Permissions
    • In the Tools section, enable the following scopes:
      • ads_read
      • Read_insights
Meta dashboard showing token permissions selection with checkboxes for ads_management, ads_read, and read_insights.

  1. Generate and Save Token
    • Click Get Token
Token generation screen with selected permissions and highlighted “Get Token” button in Meta developer portal.

  • Copy the generated access token and store it securely.
    To regenerate, go to Marketing API → Tools → User Token section.
Access token displayed in the Meta developer UI after permissions are selected and token is generated.

Security Notes

  • Keep your access token and app secret secure
  • Don’t share credentials
  • For production environments, always implement secure token refresh logic 

Step 4: Configure Facebook Ads Connector and Run Your First Import ( ~2 min)

Now that you’ve retrieved your Facebook Ads access token, it’s time to configure the connector in OWOX.

  1. Add the Access Token
OWOX connector configuration panel with the Facebook Ads access token field filled in for authentication. i-shadow
  1. Find your Account ID
Facebook Ads Manager interface showing where to find the Meta Ad Account Overview. i-shadow
  • Paste the Account ID
Account ID being pasted into the appropriate field. i-shadow
  1. Start Date
    • Set the reporting start date (e.g., 2025-07-01). This determines how far back data will be fetched.
Connector configuration form with the Start Date field set to 2025-07-01 for fetching data from Facebook Ads. i-shadow
  1. When you scroll down, you’ll see some more fields with parameters. For your first run, they are optional, and you can always come back and adjust them later.
  2. Click Next.
  3. Endpoint: Choose the following valid endpoint nodes:
  • ad-account/ads 
  • ad-account/user – Information about the user connected to the ad account.
  • ad-account – General account-level details such as account name, currency, and status.
  • ad-account/adcreatives – Metadata and details of ad creatives, including format and assets.
  • ad-account/ads – Information on individual ads within the account.
  • ad-account/insights – Performance metrics like impressions, clicks, spend, and conversions.
  • ad – Specific details for a single ad entity.

👉 Tip for first-time setup: If you’re just getting started, begin with the ad-account/ads endpoint. It provides detailed information on each ad, including creatives and delivery status, which most teams use to build their first reports. Later, you can add ad-account/insights for performance metrics or ad-account/adcreatives to enrich your model with creative-level context. 

Node selection menu for Facebook Ads with options like ad-account/ads. i-shadow
  1. Select Fields for chosen node. 
    • Select all available fields or choose specific metrics like clicks, spend, and impressions based on your reporting needs.
List of available fields from Facebook Ads API to include in the connector. i-shadow

8. Dataset Name: 

  • Enter the BigQuery dataset name where the imported data should be stored.
Final setup screen showing the target dataset and table path in BigQuery with time triggers hint enabled. i-shadow

Note: If the dataset doesn't exist, OWOX will create it automatically in the storage during the import process.

  1. Click Finish

10. In the Data Setup Tab, Click 'Save'.

OWOX Data Marts configuration screen showing successful mapping between Facebook Ads and BigQuery table with a Save button. i-shadow

11. Click 'Publish Data Mart'..

OWOX Data Marts setup showing the 'Publish Data Mart ' button ready to be clicked to activate the data mart configuration. i-shadow

12. Click 'Manual Run' button or use the 3-dot menu.

OWOX Data Marts interface with the ‘Manual Run’ button visible and the 3-dot menu expanded. i-shadow

13. A configuration panel will appear to choose a Run Type. Select Backfill or Incremental Load. Then add the required start and end dates, then click Run to load the data. 

Please Note: If you are setting up this connector for the first time, you need to go with the Backfill Run Type.

14. Go to 'Run History' and see the message 'Success'.

Run History tab in OWOX Data Marts displaying the status message ‘Import is finished’. i-shadow

Step 5: Schedule Automated Imports ( ~1 min)

Set up a trigger to pull data on a recurring schedule.

  1. Go to the 'Triggers' tab in the new Data Mart
    • Click 'Add Trigger'.
Triggers tab in OWOX Data Marts showing the option to add a new time trigger, with no scheduled triggers currently listed for the Facebook Data mart. i-shadow

2. Configure:

  • Trigger Type: Connector Run
  • Schedule Settings: Daily / Weekly / Monthly / Interval
  • Time Settings: hour, minute, second
  • Days of the week
  • Time zone
Scheduled trigger setup screen in OWOX Data Marts showing trigger type and scheduling options for automating data runs. i-shadow

3. Click 'Create Trigger'. Your data will now refresh automatically.

OWOX Data Marts time trigger setup showing schedule details and the 'Create trigger' button to automate data refresh based on the selected configuration. i-shadow

4. The trigger is now active and scheduled to run automatically on the defined days and at the defined time.

OWOX Data Marts trigger summary screen showing active time trigger details, including schedule, status, and upcoming run for Facebook Data. i-shadow

What’s Next?

The free Facebook Ads to BigQuery connector in OWOX Data Marts continues our mission to make data ownership simple, transparent, and accessible to everyone.

Here are more resources to explore:

🔗 More free connectors – including LinkedIn Ads and Microsoft Ads Connectors for BigQuery.

🎥 Step-by-step video tutorials – so you can follow along and set everything up with ease.

📊 Prebuilt dashboard templates – designed to help you get actionable insights instantly from BigQuery faster than ever.

Check out our GitHub repo, leave us a ⭐ star, and let’s build better tools together.

Facebook Ads Connector to Google BigQuery

FAQ

Is the Facebook Ads to BigQuery connector really free?
Do I need to know how to code to use this connector?
What kind of data can I import from Facebook Ads?
How often can I refresh the data in BigQuery?
Is my data secure when using this connector?
Can I modify or extend the connector for my needs?

You might also like

2,000 companies rely on us

Oops! Something went wrong while submitting the form...