Skip to main content

Meta Audience Network Reporting

info

API Documentation: Meta Audience Network Reporting API

The Meta Audience Network Reporting API provides performance data for apps monetized through Meta Audience Network, including metrics like impressions, clicks, revenue, and fill rates.

Source Setup Guide​

Step 1​

Click connect in the Edit Source form.

Step 2​

Complete the Facebook OAuth flow to grant Extract the required permissions.

Required permission:

  • read_audience_network_insights

Step 3​

Ensure that your email and profile picture are visible, and verify that the source status is Connected.

Connection Setup Guide​

Once you connect Meta Audience Network Reporting to a destination, configure:

  • Connection Pull Schedule: How frequently data is extracted from the source.
  • Backfill (Days): How many days of historical data to retrieve on each run.
  • Destination-specific settings: For example, dataset name or target schema (varies by destination).
  • Schema Migration Policy: How Extract handles schema changes from the source.

Connector Information​

Data freshness and partitioning​

This source extracts reporting data in daily date chunks and advances a date cursor after each successful run. Backfill is applied relative to the cursor.

Configuration fields​

FieldTypeRequiredDescription
tokenOAuthYesFacebook OAuth credentials.
accountsstring[]NoOptional allowlist of ad account IDs to sync. If omitted, Extract syncs all accessible ad accounts that have an associated business.
backfillnumberYesNumber of days to backfill on each run.
breakdownsstring[]NoReport breakdown dimensions. If omitted, defaults to property, placement, country, platform. Allowed values: ad_space, country, delivery_method, placement, placement_name, platform, property.

Data Streams​

report​

Daily Meta Audience Network performance report rows, returned per business and segmented by the configured breakdowns.

Primary keys / grain​

Each row represents a unique combination of:

  • date (day)
  • business (derived from the ad account’s associated business)
  • the selected breakdown dimensions (for example: property, placement, country, platform)

Metrics​

The stream includes common Audience Network performance metrics such as:

  • revenue, impressions, requests, filled requests
  • clicks, CPM, CTR
  • fill rate, show rate
  • bidding metrics (bid rate, requests/responses, win rate)
  • no-bid / no-fill style failure metrics

Notes​

  • If you configure accounts, only those ad accounts are considered; otherwise, all accessible ad accounts with a business are used.
  • Breakdowns must be chosen from the allowed list above; invalid values will cause the source to fail validation.