Source: LinkedinAds - Upgrade API Version to 202410

airbyte-integrations/connectors/source-linkedin-ads/integration_tests/abnormal_state.json

@@ -9,7 +9,7 @@
   {
     "type": "STREAM",
     "stream": {
-      "stream_state": { "lastModified": "2050-01-02" },
+      "stream_state": { "lastModified": "2050-01-02T00:00:00+0000" },
       "stream_descriptor": { "name": "campaign_groups" }
     }
   },

airbyte-integrations/connectors/source-linkedin-ads/integration_tests/expected_records.jsonl

@@ -4,7 +4,7 @@
 {"stream": "campaign_groups", "data": {"runSchedule": {"start": 1628229693058, "end": 1695253500000}, "test": false, "totalBudget": {"currencyCode": "USD", "amount": "200"}, "name": "Airbyte Test", "servingStatuses": ["CAMPAIGN_GROUP_END_DATE_HOLD", "CAMPAIGN_GROUP_TOTAL_BUDGET_HOLD"], "backfilled": false, "id": 616471656, "account": "urn:li:sponsoredAccount:508720451", "status": "ACTIVE", "created": "2021-08-06T06:01:33+00:00", "lastModified": "2023-09-20T23:33:45+00:00"}, "emitted_at": 1718164662674}
 {"stream": "campaigns", "data": {"storyDeliveryEnabled": false, "targetingCriteria": {"include": {"and": [{"type": "urn:li:adTargetingFacet:interfaceLocales", "values": ["urn:li:locale:en_US"]}, {"type": "urn:li:adTargetingFacet:locations", "values": ["urn:li:geo:103644278"]}]}}, "pacingStrategy": "LIFETIME", "locale": {"country": "US", "language": "en"}, "type": "SPONSORED_UPDATES", "optimizationTargetType": "MAX_REACH", "runSchedule": {"start": 1628230144426, "end": 1630971900000}, "costType": "CPM", "creativeSelection": "OPTIMIZED", "offsiteDeliveryEnabled": true, "id": 168387646, "audienceExpansionEnabled": true, "test": false, "format": "STANDARD_UPDATE", "servingStatuses": ["CAMPAIGN_END_DATE_HOLD", "STOPPED", "CAMPAIGN_GROUP_END_DATE_HOLD", "CAMPAIGN_GROUP_TOTAL_BUDGET_HOLD"], "version": {"versionTag": "7"}, "objectiveType": "BRAND_AWARENESS", "associatedEntity": "urn:li:organization:64265083", "offsitePreferences": {"iabCategories": {"exclude": []}, "publisherRestrictionFiles": {"include": [], "exclude": []}}, "campaignGroup": "urn:li:sponsoredCampaignGroup:616471656", "dailyBudget": {"currencyCode": "USD", "amount": "10"}, "unitCost": {"currencyCode": "USD", "amount": "62.73"}, "name": "Brand awareness - Aug 6, 2021", "account": "urn:li:sponsoredAccount:508720451", "status": "COMPLETED", "created": "2021-08-06T06:03:52+00:00", "lastModified": "2023-09-20T23:33:56+00:00"}, "emitted_at": 1718164665677}
 {"stream": "campaigns", "data": {"storyDeliveryEnabled": false, "targetingCriteria": {"include": {"and": [{"type": "urn:li:adTargetingFacet:interfaceLocales", "values": ["urn:li:locale:en_US"]}, {"type": "urn:li:adTargetingFacet:locations", "values": ["urn:li:geo:103644278"]}]}}, "pacingStrategy": "LIFETIME", "locale": {"country": "US", "language": "en"}, "type": "SPONSORED_UPDATES", "optimizationTargetType": "MAX_REACH", "runSchedule": {"start": 1692612446473, "end": 1695253500000}, "costType": "CPM", "creativeSelection": "OPTIMIZED", "offsiteDeliveryEnabled": true, "id": 252074216, "audienceExpansionEnabled": true, "test": false, "format": "STANDARD_UPDATE", "servingStatuses": ["CAMPAIGN_END_DATE_HOLD", "STOPPED", "CAMPAIGN_GROUP_END_DATE_HOLD", "CAMPAIGN_GROUP_TOTAL_BUDGET_HOLD"], "version": {"versionTag": "15"}, "objectiveType": "BRAND_AWARENESS", "associatedEntity": "urn:li:organization:64265083", "offsitePreferences": {"iabCategories": {"exclude": []}, "publisherRestrictionFiles": {"include": [], "exclude": []}}, "campaignGroup": "urn:li:sponsoredCampaignGroup:616471656", "dailyBudget": {"currencyCode": "USD", "amount": "100"}, "unitCost": {"currencyCode": "USD", "amount": "49.85"}, "name": "Brand awareness - Aug 21, 2023", "account": "urn:li:sponsoredAccount:508720451", "status": "COMPLETED", "created": "2023-08-18T12:05:38+00:00", "lastModified": "2023-09-20T23:33:56+00:00"}, "emitted_at": 1718164665684}
-{"stream": "creatives", "data": {"servingHoldReasons": ["CAMPAIGN_END_DATE_HOLD", "CAMPAIGN_STOPPED", "CAMPAIGN_GROUP_END_DATE_HOLD", "CAMPAIGN_GROUP_TOTAL_BUDGET_HOLD"], "lastModifiedAt": 1692926398000, "lastModifiedBy": "urn:li:system:0", "content": {"reference": "urn:li:share:6823991265126957056"}, "createdAt": 1692360339000, "isTest": false, "createdBy": "urn:li:person:HRnXB4kIO7", "review": {"status": "APPROVED"}, "isServing": false, "campaign": "urn:li:sponsoredCampaign:252074216", "id": "urn:li:sponsoredCreative:287513206", "intendedStatus": "ACTIVE", "account": "urn:li:sponsoredAccount:508720451"}, "emitted_at": 1718164668634}
+{"stream": "creatives", "data": {"servingHoldReasons": ["CAMPAIGN_END_DATE_HOLD", "CAMPAIGN_STOPPED", "CAMPAIGN_GROUP_END_DATE_HOLD", "CAMPAIGN_GROUP_TOTAL_BUDGET_HOLD"], "lastModifiedAt": 1692926398000, "lastModifiedBy": "urn:li:system:0", "content": {"reference": "urn:li:share:6823991265126957056"}, "createdAt": 1692360339000, "isTest": false, "createdBy": "urn:li:person:HRnXB4kIO7", "review": {"status": "APPROVED"}, "name": "Creative Airbyte name", "isServing": false, "campaign": "urn:li:sponsoredCampaign:252074216", "id": "urn:li:sponsoredCreative:287513206", "intendedStatus": "ACTIVE", "account": "urn:li:sponsoredAccount:508720451"}, "emitted_at": 1718164668634}
 {"stream": "conversions", "data": {"postClickAttributionWindowSize": 30, "conversionMethod": "INSIGHT_TAG_URL_MATCH_RULES", "viewThroughAttributionWindowSize": 7, "created": 1692168056678, "imagePixelTag": "<img height=\"1\" width=\"1\" style=\"display:none;\" alt=\"\" src=\"https://px.ads.linkedin.com/collect/?pid=3417636&conversionId=13703588&fmt=gif\" />", "type": "AD_CLICK", "enabled": true, "associatedCampaigns": [{"associatedAt": 1692609636804, "campaign": "urn:li:sponsoredCampaign:252074216", "conversion": "urn:lla:llaPartnerConversion:13703588"}, {"associatedAt": 1692168067977, "campaign": "urn:li:sponsoredCampaign:251861596", "conversion": "urn:lla:llaPartnerConversion:13703588"}], "campaigns": ["urn:li:sponsoredCampaign:252074216", "urn:li:sponsoredCampaign:251861596"], "name": "Airbyte", "urlMatchRuleExpression": [[{"matchValue": "https://airbyte.com/", "matchType": "STARTS_WITH"}]], "id": 13703588, "lastModified": 1692168056678, "attributionType": "LAST_TOUCH_BY_CAMPAIGN", "urlRules": [{"type": "STARTS_WITH", "matchValue": "https://airbyte.com/"}], "value": {"currencyCode": "USD", "amount": "1"}, "account": "urn:li:sponsoredAccount:508720451"}, "emitted_at": 1718164671607}
 {"stream": "ad_campaign_analytics", "data": {"documentFirstQuartileCompletions": 0.0, "actionClicks": 0.0, "comments": 0.0, "costInUsd": -2e-18, "commentLikes": 0.0, "adUnitClicks": 0.0, "companyPageClicks": 0.0, "costInLocalCurrency": -2e-18, "documentThirdQuartileCompletions": 0.0, "cardImpressions": 0.0, "documentCompletions": 0.0, "clicks": 0.0, "cardClicks": 0.0, "pivotValues": ["urn:li:sponsoredCampaign:252074216"], "documentMidpointCompletions": 0.0, "downloadClicks": 0.0, "start_date": "2023-08-26", "end_date": "2023-08-26", "string_of_pivot_values": "urn:li:sponsoredCampaign:252074216", "sponsoredCampaign": "252074216", "_pivot": "", "oneClickLeads": 0.0, "landingPageClicks": 0.0, "fullScreenPlays": 0.0, "oneClickLeadFormOpens": 0.0, "follows": 0.0, "impressions": 1.0, "otherEngagements": 0.0, "externalWebsiteConversions": 0.0, "leadGenerationMailContactInfoShares": 0.0, "opens": 0.0, "leadGenerationMailInterestedClicks": 0.0, "likes": 0.0}, "emitted_at": 1718164682305}
 {"stream": "ad_campaign_analytics", "data": {"documentFirstQuartileCompletions": 0.0, "actionClicks": 0.0, "comments": 0.0, "costInUsd": 100.0, "commentLikes": 0.0, "adUnitClicks": 0.0, "companyPageClicks": 0.0, "costInLocalCurrency": 100.0, "documentThirdQuartileCompletions": 0.0, "cardImpressions": 0.0, "documentCompletions": 0.0, "clicks": 106.0, "cardClicks": 0.0, "pivotValues": ["urn:li:sponsoredCampaign:252074216"], "documentMidpointCompletions": 0.0, "downloadClicks": 0.0, "start_date": "2023-08-25", "end_date": "2023-08-25", "string_of_pivot_values": "urn:li:sponsoredCampaign:252074216", "sponsoredCampaign": "252074216", "_pivot": ""}, "emitted_at": 1718164682311}

airbyte-integrations/connectors/source-linkedin-ads/metadata.yaml

@@ -11,7 +11,7 @@ data:
   connectorSubtype: api
   connectorType: source
   definitionId: 137ece28-5434-455c-8f34-69dc3782f451
-  dockerImageTag: 5.1.5
+  dockerImageTag: 5.1.6
   dockerRepository: airbyte/source-linkedin-ads
   documentationUrl: https://docs.airbyte.com/integrations/sources/linkedin-ads
   githubIssueLabel: source-linkedin-ads

airbyte-integrations/connectors/source-linkedin-ads/pyproject.toml

@@ -3,7 +3,7 @@ requires = [ "poetry-core>=1.0.0",]
 build-backend = "poetry.core.masonry.api"
 
 [tool.poetry]
-version = "5.1.5"
+version = "5.1.6"
 name = "source-linkedin-ads"
 description = "Source implementation for Linkedin Ads."
 authors = [ "Airbyte <[email protected]>",]

airbyte-integrations/connectors/source-linkedin-ads/source_linkedin_ads/manifest.yaml

@@ -278,7 +278,7 @@ definitions:
           request_parameters:
             q: criteria
           request_headers:
-            Linkedin-Version: "202404"
+            Linkedin-Version: "202410"
             X-RestLi-Method: FINDER
           error_handlers:
             type: CompositeErrorHandler
@@ -2255,6 +2255,11 @@ schemas:
             type:
               - "null"
               - array
+      name:
+        description: The name of the creative.
+        type:
+          - "null"
+          - string
       isServing:
         description: Boolean indicating if the creative is currently serving.
         type:

docs/integrations/sources/linkedin-ads.md

@@ -191,6 +191,7 @@ After 5 unsuccessful attempts - the connector will stop the sync operation. In s
 
 | Version | Date       | Pull Request                                             | Subject                                                                                                         |
 |:--------|:-----------|:---------------------------------------------------------|:----------------------------------------------------------------------------------------------------------------|
+| 5.1.6 | 2025-01-29 | [49458](https://github.com/airbytehq/airbyte/pull/49458) | Update Linkedin Ads API version to 202410 for creatives stream            |
 | 5.1.5 | 2025-02-01 | [52791](https://github.com/airbytehq/airbyte/pull/52791) | Update dependencies |
 | 5.1.4 | 2025-01-30 | [52604](https://github.com/airbytehq/airbyte/pull/52604) | Fix state error |
 | 5.1.3 | 2025-01-22 | [52604](https://github.com/airbytehq/airbyte/pull/52604) | Update CDK to production ^6 |