Configuring Meta Exports

Learn how to set up and customize data exports from your Meta (Facebook) advertising accounts to Google Sheets.

Overview

After connecting your Meta account, you can configure exports to send your advertising data to Google Sheets. This allows you to analyze campaign performance, track ad metrics, monitor audience insights, and create custom reports based on your Meta advertising data.

Prerequisites

Before configuring Meta exports, make sure you have:

Creating a Meta Export

Follow these steps to create a new Meta export:

  1. Navigate to the Export Builder

    From your dashboard, go to "Export Builder" and click "Create New Export".

  2. Select Meta as the Data Source

    Choose "Meta" from the list of available data sources.

  3. Select Your Meta Ad Account

    If you have multiple ad accounts connected, select the ad account you want to export data from.

  4. Choose a Google Sheet

    Select the Google Sheet where you want to export your Meta data.

  5. Configure Export Settings

    Set the date range and, if needed, select which platforms (e.g. Instagram only) to include for performance data. Then set up tabs and columns as described in the sections below.

    Meta Export Configuration

    The Meta export configuration screen

  6. Save Your Export

    Click "Create Export" to save your configuration and create the export.

Export Configuration Options

When configuring a Meta export, you have several options to customize what data is exported and how it's organized:

Data Tabs

Meta exports are organized by data types, with each type creating a separate tab in your Google Sheet:

Meta Data Tabs

The tab interface for configuring different data types

Available data tabs include:

  • Campaigns: Information about your advertising campaigns
  • Ad Sets: Details about your ad sets within campaigns
  • Ads: Information about individual ads
  • Insights: Performance metrics broken down by campaign, ad set, and ad (multiple rows per day, one per entity). Daily granularity only.
  • Date: Account-level totals—one row per time period for the whole ad account. Time granularity can be set to daily (default), weekly, or monthly.
  • Insights (Campaigns): Performance metrics broken down by campaign. Time granularity: daily (default), weekly, or monthly.
  • Insights (Ad Sets): Performance metrics broken down by ad set. Time granularity: daily (default), weekly, or monthly.
  • Insights (Ads): Performance metrics broken down by ad. Time granularity: daily (default), weekly, or monthly.
  • Audiences: Information about your custom audiences

For each data tab, you can select which columns (fields) to include in your export.

Column Selection

For each data tab, you can select which columns (fields) to include in your export:

Meta Column Selection

The column selection interface for a data tab

Each data tab has its own set of available columns. Some common columns include:

Data Tab Example Columns
Campaigns ID, Name, Status, Objective, Budget, Start Time, End Time, Spend, Results
Ad Sets ID, Name, Campaign ID, Status, Budget, Targeting, Optimization Goal, Bid Strategy
Ads ID, Name, Ad Set ID, Status, Creative, Preview URL, Impressions, Clicks, CTR
Insights Date Start, Date Stop, Campaign ID, Ad Set ID, Ad ID, Account ID, Platform, Impressions, Reach, Frequency, Clicks, CTR, CPC, Spend, Purchases, Omni Add to Cart, Omni Purchases, Purchase Conversion Value, Purchases (1d Click), Purchases (7d Click), Purchases (1d View), Purchases (7d View), and more
Date Date Start, Date Stop, Account ID, Platform, Impressions, Reach, Frequency, Clicks, CTR, CPC, Spend, Omni Add to Cart, Omni Purchases, Purchase Conversion Value, and other metrics. One row per time period (day/week/month) for the whole ad account.
Insights (Campaigns) Same metrics as Insights, with Campaign ID, Campaign Name, and Platform. One row per campaign per time period. Time granularity selectable.
Insights (Ad Sets) Same metrics as Insights, with Ad Set ID, Ad Set Name, and Platform. One row per ad set per time period. Time granularity selectable.
Insights (Ads) Same metrics as Insights, with Ad ID, Ad Name, and Platform. One row per ad per time period. Time granularity selectable.
Audiences ID, Name, Description, Size, Type, Creation Time, Rule

You can use the "Select All" and "Deselect All" buttons to quickly manage your column selections.

Date Range Options

You can specify the date range for which you want to export data using Meta's preset date ranges:

  • Today: Data from the current day
  • Yesterday: Data from the previous day
  • Last 3, 7, 14, 28, 30, 90 days: Rolling windows from today backwards
  • This year / Last year: Data from the current or previous calendar year
  • This month / Last month: Data from the current or previous calendar month
  • This quarter: Data from the current calendar quarter
  • Maximum: Maximum available data range

These date presets are Meta API presets and are used to filter data for all data types, including Campaigns, Ad Sets, Ads, and Insights. Even when a tab has no data (for example, no audiences or no activity in the date range), the export still writes the column headers so the sheet or table is created with the correct structure.

Platforms (performance data only)

In Export Settings, you can limit performance data to specific Meta platforms. This applies only to the Date and Insights tabs (including Insights, Insights (Campaigns), Insights (Ad Sets), and Insights (Ads)).

  • All platforms (default): Leave all platform checkboxes unchecked to export combined performance across Facebook, Instagram, Messenger, and Audience Network.
  • One or more platforms: Check Facebook, Instagram, Messenger, and/or Audience Network to include only those platforms. For example, check only Instagram to get Instagram-only metrics in your Date and Insights tabs.

The Campaigns, Ad Sets, Ads, and Audiences tabs are not filtered by platform—they always include all entities in your ad account. Only the performance metrics in the Date and Insights tabs are limited to the platforms you select.

When you use a platform filter, a Platform column is available in the Date and Insights tabs. You can include it in your column selection to see which platform (e.g. instagram, facebook) each row belongs to. If you leave all platforms unchecked, this column will be empty because data is aggregated across all platforms.

Data Handling

For each data tab, you can choose how to handle the exported data:

  • Replace (default): Each export run will clear existing data and replace it with new data. For the Date tab, this exports the full date range specified by your date preset.
  • Append: Each export run will add new data rows without removing existing data. For the Date tab, when append mode is enabled, the system automatically uses incremental exports - it only fetches data from the day after your last export date to today, making it efficient for building historical datasets.

The append option is particularly useful for building historical datasets over time, especially for Insights and Date data. When enabled, new data will be added to existing rows rather than replacing them.

Date Tab and Time Granularity

The Date tab provides account-level performance metrics—one row per time period for the entire ad account (no campaign/ad set/ad breakdown). You can choose time granularity: daily (default), weekly, or monthly. This is useful for high-level time-series analysis and account totals.

The Insights (Campaigns), Insights (Ad Sets), and Insights (Ads) tabs also support time granularity (daily, weekly, monthly) and give you performance broken down by that dimension.

Complete Date Coverage

Insights and dimension tabs ensure complete date coverage per entity: if an entity had no impressions on a day, you still get a row for that date with empty metrics. The Date tab outputs one row per time period for the account, with empty metrics when there is no activity.

Append Mode Behavior:

  • When append mode is enabled, the Date tab (and dimension insight tabs) use incremental exports—only new data from after your last export date is fetched
  • This is efficient for scheduled exports, as only new periods are processed instead of the full date range
  • When replace mode is used, the full date range specified by your date preset is exported

Account ID Field

Each data tab includes an Account ID field that can be used to identify which Meta Ad Account the data belongs to. This is especially useful if you're exporting data from multiple ad accounts.

Best Practices

  • Focus on Key Metrics: Select only the columns you actually need for your analysis to keep your sheets manageable
  • Use Multiple Exports: Create separate exports for different purposes (e.g., one for campaign management, another for performance analysis)
  • Combine with Other Data: Use Google Sheets to combine your Meta data with data from other sources like Google Analytics or Google Ads
  • Regular Scheduling: Set up daily or weekly exports to track performance trends over time
  • Append for Historical Data: Use the append option for Insights and Date data to build a historical dataset beyond Meta's standard reporting periods. The Date tab is especially efficient with append mode, as it only exports new days incrementally.
  • Replace for Current State: Use the replace option for Campaigns, Ad Sets, and Ads to always have the current state of your advertising structure
  • Use Date Tab for Account-Level Trends: The Date tab gives one row per time period (day, week, or month) for the whole account—ideal for account-level trend analysis and time-series visualizations
  • Complete Date Coverage: Insights and dimension tabs fill in missing dates per entity; the Date tab outputs one row per period for the account, so the full date range is visible even when there was no activity
  • Platform filter for channel-specific reporting: Use the platform filter in Export Settings to get Instagram-only, Facebook-only, or other platform-specific performance in your Date and Insights tabs. Include the Platform column in those tabs to label each row.

Troubleshooting

Missing Data

If your export is missing expected data:

  • Verify that you've selected the appropriate columns for each data tab
  • Check if the date range is appropriate for the data you're looking for
  • Ensure that your campaigns, ad sets, or ads were active during the selected period
  • Verify that you have the necessary permissions to access that data

Export Errors

If your export fails with errors:

  • Check the export logs for specific error messages (see Viewing Export Logs)
  • Verify that your Meta connection is still active and the token hasn't expired
  • Check if your Google Sheet is accessible and has not been deleted
  • Be aware of Meta's API rate limits, which might affect large exports

Data Discrepancies

If you notice differences between exported data and Meta Ads Manager reports:

  • Be aware that Meta's attribution models and reporting windows can affect metrics
  • Check that the date ranges match exactly
  • Understand that Meta may have slight delays in reporting data
  • Consider time zone differences between your Meta account and the export

Related Documentation

Stop Juggling Dashboards. Start Growing Get your data flowing today, free plan available.