Quickstart · Source connector
Meta Ads ELT Connector
Extract brings Meta Ads quickstart data into data warehouses and databases for analysis with the rest of your business data. Teams use it to build recurring reporting and compare business activity across systems. Flexible scheduling keeps reporting current for routine analysis and time-sensitive decisions.
View setup guide
Use cases
What teams use this connector for
Business performance reporting
Use Meta Ads data to monitor recurring activity and investigate meaningful changes over time.
Cross-system analysis
Combine Meta Ads data with customer, finance, and operational metrics for consistent reporting.
Data quality monitoring
Compare Meta Ads record totals and reporting periods to identify incomplete or unexpected data.
Flexible reporting cadence
Refresh Meta Ads reporting every 15 minutes, hourly, daily, or on a custom schedule as business needs change.
Warehouse and database analysis
Use Extract to make Meta Ads quickstart data available in data warehouses and databases such as Snowflake, BigQuery, Redshift, and PostgreSQL for governed analysis.
Connector data
Available streams
| Stream | Description | Sync mode |
|---|---|---|
account_recommendations | Fields include account_id, recommendation_signature, _singular_extract_timestamp, ad_account_id. | Full refresh |
action_canvas_component | Fields include account_id, _singular_extract_timestamp, clicks, date_start. | Incremental |
action_carousel_card | Fields include account_id, _singular_extract_timestamp, action_carousel_card_id, action_carousel_card_name. | Incremental |
action_conversion_device | Fields include account_id, _singular_extract_timestamp, clicks, date_start. | Incremental |
action_product_id | Fields include account_id, ad_id, _singular_extract_timestamp, clicks. | Incremental |
action_reactions | Fields include account_id, _singular_extract_timestamp, action_reaction, action_values. | Incremental |
action_video_sound | Fields include account_id, _singular_extract_timestamp, action_video_sound, date_start. | Incremental |
action_video_view_type | Fields include account_id, _singular_extract_timestamp, action_video_type, date_start. | Incremental |
ad | Fields include id, account_id, adset_id, campaign_id. | Incremental |
ad_account | Fields include account_id, _singular_extract_timestamp, account_status, age. | Full refresh |
ad_action_canvas_component | Fields include account_id, ad_id, adset_id, campaign_id. | Incremental |
ad_action_carousel_card | Fields include account_id, ad_id, adset_id, campaign_id. | Incremental |
ad_action_conversion_device | Fields include account_id, ad_id, adset_id, campaign_id. | Incremental |
ad_action_reactions | Fields include account_id, ad_id, adset_id, campaign_id. | Incremental |
ad_action_video_sound | Fields include account_id, ad_id, adset_id, campaign_id. | Incremental |
ad_action_video_view_type | Fields include account_id, ad_id, adset_id, campaign_id. | Incremental |
ad_activity | Fields include account_id, _singular_extract_timestamp, actor_id, actor_name. | Incremental |
ad_campaign_frequency_control | Fields include account_id, adset_id, event, _singular_extract_timestamp. | Incremental |
ad_campaign_issues_info | Fields include account_id, adset_id, _singular_extract_timestamp, error_code. | Incremental |
ad_conversion_specs | Fields include account_id, ad_id, _singular_extract_timestamp, action_type. | Incremental |
ad_creative | Fields include account_id, id, _singular_extract_timestamp, actor_id. | Full refresh |
ad_creative_labels | Fields include ad_creative_id, id, _singular_extract_timestamp. | Full refresh |
ad_delivery_platform | Fields include account_id, ad_id, adset_id, campaign_id. | Incremental |
ad_image | Fields include account_id, created_time, id, _singular_extract_timestamp. | Incremental |
ad_insights | Fields include account_id, ad_id, adset_id, campaign_id. | Incremental |
ad_labels | Fields include ad_id, id, _singular_extract_timestamp. | Incremental |
ad_recommendation | Fields include account_id, ad_id, _singular_extract_timestamp, blame_field. | Incremental |
ad_study | Fields include id, _singular_extract_timestamp, business.id, business.name. | Incremental |
ad_study_cells | Fields include id, ad_study_id, ad_entities_count, control_percentage. | Incremental |
ad_study_objectives | Fields include id, ad_study_id, is_primary, last_updated_results. | Incremental |
ad_tracking_specs | Fields include account_id, ad_id, _singular_extract_timestamp, action_type. | Incremental |
ad_video | Fields include account_id, id, _singular_extract_timestamp, ad_breaks. | Incremental |
adgroup_issues_info | Fields include account_id, ad_id, _singular_extract_timestamp, error_code. | Incremental |
adset | Fields include id, account_id, campaign_id, promoted_object.custom_conversion_id. | Incremental |
adset_action_canvas_component | Fields include account_id, adset_id, campaign_id, _singular_extract_timestamp. | Incremental |
adset_action_carousel_card | Fields include account_id, adset_id, campaign_id, _singular_extract_timestamp. | Incremental |
adset_action_conversion_device | Fields include account_id, adset_id, campaign_id, _singular_extract_timestamp. | Incremental |
adset_action_reactions | Fields include account_id, adset_id, campaign_id, _singular_extract_timestamp. | Incremental |
adset_action_video_sound | Fields include account_id, adset_id, campaign_id, _singular_extract_timestamp. | Incremental |
adset_action_video_view_type | Fields include account_id, adset_id, campaign_id, _singular_extract_timestamp. | Incremental |
adset_labels | Fields include adset_id, id, _singular_extract_timestamp. | Incremental |
adset_targeting_optimization_types | Fields include account_id, adset_id, key, _singular_extract_timestamp. | Incremental |
basic_ad | Fields include account_id, ad_id, _singular_extract_timestamp, actions. | Incremental |
basic_ad_set | Fields include account_id, adset_id, _singular_extract_timestamp, actions. | Incremental |
basic_all_levels | Fields include account_id, ad_id, _singular_extract_timestamp, actions. | Incremental |
basic_campaign | Fields include account_id, campaign_id, _singular_extract_timestamp, actions. | Incremental |
business_invoice | Fields include business_id, id, _singular_extract_timestamp, ad_account_ids. | Incremental |
campaign | Fields include id, account_id, promoted_object.custom_conversion_id, _singular_extract_timestamp. | Incremental |
campaign_action_canvas_component | Fields include account_id, campaign_id, _singular_extract_timestamp, clicks. | Incremental |
campaign_action_carousel_card | Fields include account_id, campaign_id, _singular_extract_timestamp, action_carousel_card_id. | Incremental |
campaign_action_conversion_device | Fields include account_id, campaign_id, _singular_extract_timestamp, clicks. | Incremental |
campaign_action_reactions | Fields include account_id, campaign_id, _singular_extract_timestamp, action_reaction. | Incremental |
campaign_action_video_sound | Fields include account_id, campaign_id, _singular_extract_timestamp, action_video_sound. | Incremental |
campaign_action_video_view_type | Fields include account_id, campaign_id, _singular_extract_timestamp, action_video_type. | Incremental |
campaign_ad_study | Fields include id, campaign_id, _singular_extract_timestamp, canceled_time. | Incremental |
campaign_labels | Fields include campaign_id, id, _singular_extract_timestamp. | Incremental |
custom_audience | Fields include account_id, id, _singular_extract_timestamp, allowed_domains. | Full refresh |
custom_conversion | Fields include id, account_id, _singular_extract_timestamp, creation_time. | Incremental |
delivery_device | Fields include account_id, _singular_extract_timestamp, actions, clicks. | Incremental |
delivery_platform | Fields include account_id, _singular_extract_timestamp, actions, clicks. | Incremental |
delivery_platform_and_device | Fields include account_id, _singular_extract_timestamp, actions, clicks. | Incremental |
delivery_purchase_roas | Fields include account_id, ad_id, _singular_extract_timestamp, clicks. | Incremental |
demographics_age | Fields include account_id, _singular_extract_timestamp, actions, age. | Incremental |
demographics_age_and_gender | Fields include account_id, _singular_extract_timestamp, actions, age. | Incremental |
demographics_country | Fields include account_id, _singular_extract_timestamp, actions, clicks. | Incremental |
demographics_dma_region | Fields include account_id, _singular_extract_timestamp, actions, clicks. | Incremental |
demographics_gender | Fields include account_id, _singular_extract_timestamp, actions, clicks. | Incremental |
demographics_region | Fields include account_id, _singular_extract_timestamp, actions, clicks. | Incremental |
label | Fields include id, account_id, _singular_extract_timestamp, created_time. | Incremental |
reservation | Fields include account_id, country_code, _singular_extract_timestamp, max_campaign_duration. | Full refresh |
video_thumbnail | Fields include id, video_id, _singular_extract_timestamp, height. | Incremental |
Schema
Data model at a glance
account_recommendations
account_idstringrecommendation_signaturestring_singular_extract_timestampstringad_account_idstringbodystringlevelstringlift_estimatejsonobject_idsarray
action_canvas_component
account_idstring_singular_extract_timestampstringclicksstringdate_startstringdate_stopstringinline_link_clicksstringmobile_app_purchase_roasstringoutbound_clicksstring
action_carousel_card
account_idstring_singular_extract_timestampstringaction_carousel_card_idstringaction_carousel_card_namestringclicksstringdate_startstringdate_stopstringinline_link_clicksstring
action_conversion_device
account_idstring_singular_extract_timestampstringclicksstringdate_startstringdate_stopstringdevice_platformstringinline_link_clicksstringmobile_app_purchase_roasstring
action_product_id
account_idstringad_idstring_singular_extract_timestampstringclicksstringdate_startstringdate_stopstringinline_link_clicksstringmobile_app_purchase_roasstring
action_reactions
account_idstring_singular_extract_timestampstringaction_reactionstringaction_valuesjsonactionsjsondate_startstringdate_stopstring
No verified relationships are available in this schema preview.
Connector pairings
Popular destinations
Commonly paired with Meta Ads in Extract workflows.
Why Extract
Why Extract for Meta Ads
- Rust-native performanceUse Rust-native data movement to refresh Meta Ads reporting every 15 minutes, hourly, daily, or on a custom schedule as volume grows.
- Full run transparencyInspect Meta Ads API activity, execution steps, and timing in Extract's run-level logs when data needs review.
- ELT + Reverse ETL in oneCombine Meta Ads data with customer and finance models, then send approved outputs through a separately configured Reverse ETL destination.
FAQ
Frequently asked questions
How does Extract handle incremental and full Meta Ads syncs?
An incremental sync processes only new or changed data since a stored checkpoint or new date partition, while a full sync processes the complete selected dataset or date range again. By avoiding repeated processing and writes for the full dataset, incremental syncs can reduce destination database updates and warehouse compute costs. Stream schemas define full refresh, incremental changes, partition-based extraction. Behavior varies by stream and configuration. Extract records run details so teams can verify each sync.
Can I backfill historical Meta Ads data with Extract?
Historical coverage for Meta Ads: Backfill (Days) (backfill): The backfill setting revisits and updates data from the past X days, ensuring the most current and accurate information replaces any previously pulled data. Use the setup guide and run details to confirm the available source records and selected settings.
How can teams monitor Meta Ads data quality and freshness?
Compare expected reporting periods and record totals in your models, then use Extract's run-level logs to inspect Meta Ads API activity, execution steps, and timing. This helps teams distinguish a source-data delay from a failed or incomplete run.
How often can Extract sync data from Meta Ads?
Extract supports schedules every 15 minutes, hourly, daily, or on a custom cadence. Teams can choose a frequency that matches routine reporting, time-sensitive monitoring, or operational activation needs.
What does the Meta Ads data model look like in the destination?
The Available streams table describes the datasets Extract can read from Meta Ads. The inline schema previews entities and fields. Only relationships verified from the exported schema are shown. Use the full schema link for more details.