Export from Facebook Marketing to MongoDB

CloudQuery is an open-source data integration platform that allows you to export data from any source to any destination.

The CloudQuery Facebook Marketing plugin allows you to sync data from Facebook Marketing to any destination, including MongoDB. It's free, open source, requires no account, and takes only minutes to get started.

Ready? Let's dive right in!

Step 1. Install the CloudQuery CLI

The CloudQuery CLI is a command-line tool that runs the sync. It supports MacOS, Linux and Windows.

brew install cloudquery/tap/cloudquery

Step 2. Configure the Facebook Marketing source plugin

Create a configuration file for the Facebook Marketing plugin and set up authentication.

Configuration

Create a file called facebookmarketing.yaml and add the following contents:

kind: source
spec:
  # Source spec section
  name: facebookmarketing
  path: cloudquery/facebookmarketing
  version: "v1.1.1"
  tables: ["*"]
  destinations: ["mongodb"]

  spec: 
    # Facebook Marketing Spec section
    
    # You can find the ad_account_id in the Facebook Ads Manager: https://www.facebook.com/ads/manager/accounts/
    ad_account_id: "AD_ACCOUNT_ID"
    # See the "authentication section" on how to create an access token
    access_token: "ACCESS_TOKEN"

Fine-tune this configuration to match your needs. For more information, see the Facebook Marketing Plugin ↗ page in the docs.

Authentication

In order for CloudQuery to sync data from Facebook Marketing, you will need a Facebook Marketing access token. You will need to follow the following steps (if you don't have them set up already):

Create a business app in the Meta App dashboard (opens in a new tab). See Facebook's documentation (opens in a new tab). Make sure to choose the "Business" application type, and to link it to your business account.

Add the "Marketing API" capability to your application. You should now see a dropdown "Marketing API" menu. In this dropdown, under Tools, you will be able to generate your access token. See also Facebook's documentation (opens in a new tab)
You will also need to find your ad_account_id, which you can find in the Facebook Ads Manager (opens in a new tab). (See documentation (opens in a new tab)).

💡

CloudQuery only ever makes READ calls to the API, but due to the way the Facebook permission model works, some of the tables also require ads_management permissions.

Step 3. Configure the MongoDB destination plugin

Create a configuration file for the MongoDB plugin and set up authentication.

Configuration

Create a file called mongodb.yaml and add the following contents:

This example configures a MongoDB destination, located at localhost:27017. The (top level) spec section is described in the Destination Spec Reference.

kind: destination
spec:
  name: "mongodb"
  registry: "github"
  path: "cloudquery/mongodb"
  version: "v2.0.1"
  # batch_size: 10000 # optional
  # batch_size_bytes: 5242880 # optional
  spec:
    connection_string: "mongodb://localhost:27017"
    database: "your_mongo_database_name"

Fine-tune this configuration to match your needs. For more information, see the MongoDB Plugin ↗ page in the docs.

Step 4. Start the Sync

Run the following command in your terminal to start the sync

cloudquery sync facebookmarketing.yaml mongodb.yaml

And away we go! 🚀 The sync will run until completion, fetching all selected tables from Facebook Marketing. Any errors will be logged to a file called cloudquery.log.

Export from Facebook Marketing to MongoDB

Step 1. Install the CloudQuery CLI

Step 2. Configure the Facebook Marketing source plugin

Configuration

Authentication

Step 3. Configure the MongoDB destination plugin

Configuration

Step 4. Start the Sync

Further Reading