Merge branch 'gvillafanetapia/source-fb-marketing-learningstage-attrspec' into master

Author: almorgante

airbyte-integrations/connectors/source-facebook-marketing/metadata.yaml

@@ -10,7 +10,7 @@ data:
   connectorSubtype: api
   connectorType: source
   definitionId: e7778cfc-e97c-4458-9ecb-b4f2bba8946c
-  dockerImageTag: 4.0.0
+  dockerImageTag: 4.1.0
   dockerRepository: airbyte/source-facebook-marketing
   documentationUrl: https://docs.airbyte.com/integrations/sources/facebook-marketing
   githubIssueLabel: source-facebook-marketing

airbyte-integrations/connectors/source-facebook-marketing/pyproject.toml

@@ -3,7 +3,7 @@ requires = [ "poetry-core>=1.0.0",]
 build-backend = "poetry.core.masonry.api"
 
 [tool.poetry]
-version = "4.0.0"
+version = "4.1.0"
 name = "source-facebook-marketing"
 description = "Source implementation for Facebook Marketing."
 authors = [ "Airbyte <[email protected]>",]

airbyte-integrations/connectors/source-facebook-marketing/source_facebook_marketing/schemas/ad_sets.json

@@ -187,6 +187,23 @@
           }
         }
       }
+    },
+    "attribution_spec": {
+      "description": "Conversion attribution spec used for attributing conversions for optimization. Supported window lengths differ by optimization goal and campaign objective.",
+      "type": ["null", "array"],
+      "items": {
+        "type": "object",
+        "properties": {
+          "event_type": {
+            "description": "The type of conversion event to which the attribution applies.",
+            "type": "string"
+          },
+          "window_days": {
+            "description": "The attribution window in days. Common values: 1, 7, or 28 depending on the event type.",
+            "type": "integer"
+          }
+        }
+      }
     }
   }
 }

airbyte-integrations/connectors/source-facebook-marketing/unit_tests/integration/test_include_deleted.py

@@ -176,6 +176,7 @@ def test_ad_sets_stream(self, http_mocker: HttpMocker):
             "bid_constraints",
             "adlabels",
             "learning_stage_info",
+            "attribution_spec",
         ]
 
         http_mocker.get(

airbyte-integrations/connectors/source-facebook-marketing/unit_tests/resource/http/response/ad_sets.json

@@ -40,7 +40,13 @@
         "conversions": 12,
         "last_sig_edit_ts": 1734947501,
         "attribution_windows": ["7d_click", "1d_view"]
-      }
+      },
+      "attribution_spec": [
+        {
+          "event_type": "OFFSITE_CONVERSIONS",
+          "window_days": 7
+        }
+      ]
     }
   ]
 }

docs/integrations/sources/facebook-marketing.md

@@ -356,6 +356,7 @@ This response indicates that the Facebook Graph API requires you to reduce the f
 
 | Version | Date       | Pull Request                                             | Subject                                                                                                                                                                                                                                                                                           |
 |:--------|:-----------|:---------------------------------------------------------|:--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| 4.1.0 | 2025-05-29 | [59655](https://github.com/airbytehq/airbyte/pull/59655) | Add `attribution_spec` field to `ad_sets` stream |
 | 4.0.0 | 2025-08-25 | [65533](https://github.com/airbytehq/airbyte/pull/65533) | Migrate to Marketing API v23 |
 | 3.5.12 | 2025-08-23 | [65288](https://github.com/airbytehq/airbyte/pull/65288) | Update dependencies |
 | 3.5.11 | 2025-08-19 | [64911](https://github.com/airbytehq/airbyte/pull/64911) | Allow overriding action breakdowns for default Ads Insights stream. |