DMA deprecation and Comscore Market stream

_changelog-files/2026/2026-06-22-facebook-v1-updates.md

@@ -0,0 +1,26 @@
+---
+title: "Facebook Ads (v1): Integration updates"
+content-type: "changelog-entry"
+date: 2026-06-22
+entry-type: improvement
+entry-category: integration
+connection-id: facebook-ads
+connection-version: 1
+pull-request: "https://github.com/singer-io/tap-facebook/pull/269"
+---
+{{ site.data.changelog.metadata.single-integration | flatify }}
+
+We've improved our {{ this-connection.display_name }} (v{{ this-connection.this-version }}) integration with multiple updates.
+
+For v1.26.0:
+
+**New:**
+- Added `ads_insights_comscore_market` table for market-level geographic insights.
+
+**Deprecated:**
+- `ads_insights_dma` table deprecated due to Meta API changes (June 22, 2026).
+
+**Action required:**
+- If using `ads_insights_dma`, switch to `ads_insights_comscore_market`.
+
+**Reference:** [Meta announcement](https://developers.facebook.com/blog/post/2026/03/13/transitioning-to-comscore-markets-for-automotive-model-ads)

_data/taps/schemas/facebook-ads/v1/facebook-ads-v1-foreign-keys.yml

@@ -20,6 +20,9 @@ keys:
   - table: ads_insights_dma
     keys:
     - account_id
+  - table: ads_insights_comscore_market
+    keys:
+    - account_id
   - table: ads_insights_platform_and_device
     keys:
     - account_id
@@ -56,6 +59,9 @@ keys:
   - table: ads_insights_dma
     keys:
     - adset_id
+  - table: ads_insights_comscore_market
+    keys:
+    - adset_id
   - table: ads_insights_platform_and_device
     keys:
     - adset_id
@@ -85,6 +91,9 @@ keys:
   - table: ads_insights_dma
     keys:
     - ad_id
+  - table: ads_insights_comscore_market
+    keys:
+    - ad_id
   - table: ads_insights_platform_and_device
     keys:
     - ad_id
@@ -114,6 +123,9 @@ keys:
   - table: ads_insights_dma
     keys:
     - campaign_id
+  - table: ads_insights_comscore_market
+    keys:
+    - campaign_id
   - table: ads_insights_platform_and_device
     keys:
     - campaign_id
@@ -185,6 +197,10 @@ tables:
     keys:
     - key: account_id
       foreign-key: account_id
+  - table-name: ads_insights_comscore_market
+    keys:
+    - key: account_id
+      foreign-key: account_id
   - table-name: ads_insights_platform_and_device
     keys:
     - key: account_id
@@ -257,6 +273,16 @@ tables:
       foreign-key: ad_id
     - key: campaign_id
       foreign-key: campaign_id
+  - table-name: ads_insights_comscore_market
+    keys:
+    - key: account_id
+      foreign-key: account_id
+    - key: adset_id
+      foreign-key: adset_id
+    - key: id
+      foreign-key: ad_id
+    - key: campaign_id
+      foreign-key: campaign_id
   - table-name: ads_insights_platform_and_device
     keys:
     - key: account_id
@@ -335,6 +361,16 @@ tables:
       foreign-key: ad_id
     - key: campaign_id
       foreign-key: campaign_id
+  - table-name: ads_insights_comscore_market
+    keys:
+    - key: account_id
+      foreign-key: account_id
+    - key: adset_id
+      foreign-key: adset_id
+    - key: ad_id
+      foreign-key: ad_id
+    - key: campaign_id
+      foreign-key: campaign_id
   - table-name: ads_insights_platform_and_device
     keys:
     - key: account_id
@@ -411,6 +447,16 @@ tables:
       foreign-key: ad_id
     - key: campaign_id
       foreign-key: campaign_id
+  - table-name: ads_insights_comscore_market
+    keys:
+    - key: account_id
+      foreign-key: account_id
+    - key: adset_id
+      foreign-key: adset_id
+    - key: ad_id
+      foreign-key: ad_id
+    - key: campaign_id
+      foreign-key: campaign_id
   - table-name: ads_insights_platform_and_device
     keys:
     - key: account_id
@@ -487,6 +533,16 @@ tables:
       foreign-key: ad_id
     - key: campaign_id
       foreign-key: campaign_id
+  - table-name: ads_insights_comscore_market
+    keys:
+    - key: account_id
+      foreign-key: account_id
+    - key: adset_id
+      foreign-key: adset_id
+    - key: ad_id
+      foreign-key: ad_id
+    - key: campaign_id
+      foreign-key: campaign_id
   - table-name: ads_insights_platform_and_device
     keys:
     - key: account_id
@@ -563,6 +619,102 @@ tables:
       foreign-key: ad_id
     - key: campaign_id
       foreign-key: campaign_id
+  - table-name: ads_insights_comscore_market
+    keys:
+    - key: account_id
+      foreign-key: account_id
+    - key: adset_id
+      foreign-key: adset_id
+    - key: ad_id
+      foreign-key: ad_id
+    - key: campaign_id
+      foreign-key: campaign_id
+  - table-name: ads_insights_platform_and_device
+    keys:
+    - key: account_id
+      foreign-key: account_id
+    - key: adset_id
+      foreign-key: adset_id
+    - key: ad_id
+      foreign-key: ad_id
+    - key: campaign_id
+      foreign-key: campaign_id
+  - table-name: ads_insights_region
+    keys:
+    - key: account_id
+      foreign-key: account_id
+    - key: adset_id
+      foreign-key: adset_id
+    - key: ad_id
+      foreign-key: ad_id
+    - key: campaign_id
+      foreign-key: campaign_id
+  - table-name: adsets
+    keys:
+    - key: adset_id
+      foreign-key: id
+  - table-name: campaigns
+    keys:
+    - key: ad_id
+      foreign-key: ads.data.id
+    - key: campaign_id
+      foreign-key: id
+- table-name: ads_insights_comscore_market
+  join:
+  - table-name: adcreative
+    keys:
+    - key: account_id
+      foreign-key: account_id
+  - table-name: ads
+    keys:
+    - key: account_id
+      foreign-key: account_id
+    - key: adset_id
+      foreign-key: adset_id
+    - key: ad_id
+      foreign-key: id
+    - key: campaign_id
+      foreign-key: campaign_id
+  - table-name: ads_insights
+    keys:
+    - key: account_id
+      foreign-key: account_id
+    - key: adset_id
+      foreign-key: adset_id
+    - key: ad_id
+      foreign-key: ad_id
+    - key: campaign_id
+      foreign-key: campaign_id
+  - table-name: ads_insights_age_and_gender
+    keys:
+    - key: account_id
+      foreign-key: account_id
+    - key: adset_id
+      foreign-key: adset_id
+    - key: ad_id
+      foreign-key: ad_id
+    - key: campaign_id
+      foreign-key: campaign_id
+  - table-name: ads_insights_country
+    keys:
+    - key: account_id
+      foreign-key: account_id
+    - key: adset_id
+      foreign-key: adset_id
+    - key: ad_id
+      foreign-key: ad_id
+    - key: campaign_id
+      foreign-key: campaign_id
+  - table-name: ads_insights_dma
+    keys:
+    - key: account_id
+      foreign-key: account_id
+    - key: adset_id
+      foreign-key: adset_id
+    - key: ad_id
+      foreign-key: ad_id
+    - key: campaign_id
+      foreign-key: campaign_id
   - table-name: ads_insights_platform_and_device
     keys:
     - key: account_id
@@ -649,6 +801,16 @@ tables:
       foreign-key: ad_id
     - key: campaign_id
       foreign-key: campaign_id
+  - table-name: ads_insights_comscore_market
+    keys:
+    - key: account_id
+      foreign-key: account_id
+    - key: adset_id
+      foreign-key: adset_id
+    - key: ad_id
+      foreign-key: ad_id
+    - key: campaign_id
+      foreign-key: campaign_id
   - table-name: ads_insights_region
     keys:
     - key: account_id
@@ -725,6 +887,16 @@ tables:
       foreign-key: ad_id
     - key: campaign_id
       foreign-key: campaign_id
+  - table-name: ads_insights_comscore_market
+    keys:
+    - key: account_id
+      foreign-key: account_id
+    - key: adset_id
+      foreign-key: adset_id
+    - key: ad_id
+      foreign-key: ad_id
+    - key: campaign_id
+      foreign-key: campaign_id
   - table-name: ads_insights_platform_and_device
     keys:
     - key: account_id
@@ -783,6 +955,10 @@ tables:
     keys:
     - key: id
       foreign-key: adset_id
+  - table-name: ads_insights_comscore_market
+    keys:
+    - key: id
+      foreign-key: adset_id
   - table-name: ads_insights_platform_and_device
     keys:
     - key: id
@@ -823,6 +999,12 @@ tables:
       foreign-key: ad_id
     - key: id
       foreign-key: campaign_id
+  - table-name: ads_insights_comscore_market
+    keys:
+    - key: ads.data.id
+      foreign-key: ad_id
+    - key: id
+      foreign-key: campaign_id
   - table-name: ads_insights_platform_and_device
     keys:
     - key: ads.data.id

_data/taps/schemas/facebook-ads/v1/facebook-ads-v1-tables.yml

@@ -102,8 +102,11 @@ tables:
 
     - [`ads_insights_country`](#ads-insights-country) - Data segmented by country
 
+    - [`ads_insights_comscore_market`](#ads-insights-comscore-market) - Data segmented
+    by Comscore Market
+
     - [`ads_insights_dma`](#ads-insights-dma) - Data segmented by DMA (Designated
-    Market Area)
+    Market Area). This table is deprecated.
 
     - [`ads_insights_platform_and_device`](#ads-insights-platform-and-device) - Data
     segmented by platform and device
@@ -182,6 +185,10 @@ tables:
     Market Area).
 
 
+    **Deprecated**: As of June 22, 2026, Meta no longer supports DMA breakdowns.
+    Use [`ads_insights_comscore_market`](#ads-insights-comscore-market) instead.
+
+
     This table contains the same fields as the [`ads_insights`](#ads_insights) table,
     with the exception of `dma`.
 
@@ -203,6 +210,33 @@ tables:
     - dma
     - date_start
     replication-key: date_start
+- name: ads_insights_comscore_market
+  description: 'The `ads_insights_comscore_market` table contains entries for each
+    campaign/set/ad combination for each day, along with detailed statistics, segmented
+    by Comscore Market.
+
+
+    This table contains the same fields as the [`ads_insights`](#ads_insights) table,
+    with the exception of `comscore_market`.
+
+
+    **Note**: Data for deleted ads, adsets, and campaigns will not appear in this
+    table even if the **Include data from deleted campaigns, ads, and adsets** option
+    in the integration''s settings is enabled.
+
+    '
+  links:
+    doc-link: https://developers.facebook.com/docs/marketing-api/insights/fields/
+    singer-schema: https://github.com/singer-io/tap-facebook/blob/master/tap_facebook/schemas/ads_insights_comscore_market.json
+  table-details:
+    replication-method: Key-based Incremental
+    primary-keys:
+    - ad_id
+    - adset_id
+    - campaign_id
+    - comscore_market
+    - date_start
+    replication-key: date_start
 - name: ads_insights_hourly_advertiser
   description: 'The `ads_insights_hourly_advertiser` table contains entries for each
     campaign/set/ad combination for each day, along with detailed statistics, segmented