In preparation for the upcoming deprecation of Linkedin unversioned APIs, we will upgrade Linkedin Ads to v202306 and Linkedin Social to v202305 on Thursday, June 29, 2023. The upgrade requires modification for the existing Linkedin Ads and Linkedin Social rivers.
What Is Being Updated?
Linkedin Ads data source:
Accounts Report
Status section -
‘PENDING CANCELLATION’ status renamed to ‘PENDING DELETION’
New status: ‘REMOVED’
Campaigns Report
Status section-
New statuses: COMPLETED, PENDING_DELETION, REMOVED
Ads Statistics Report
Deprecated field - Pivot
Ads Analytics Report
Deprecated field - Pivot
Creatives Report
‘Status’ field renamed to ‘intendedStatus’
‘id’ has changed from a long (123 ) to a SponsoredCreativeUrn (urn:li:sponsoredCreative:123)
New statuses: DRAFT, PENDING_DELETION, REMOVED
Campaign Groups Report
New statuses: PENDING_DELETION, REMOVED
Linkedin Social data source:
Get Posts report
According to UCG API migration for Posts API, the fields of the report have been changed. Deprecated fields:
- clientApplication
- contentCertificationRecord
- versionTag
- SponsoredContentVisibility
- distributedViaFollowFeed
Renamed fields:
- lastModified_time → lastModifiedAt
- Created_time → createdAt
- responseContext_parent → reshareContext_parent
- responseContext_root → reshareContext_root
- targetAudience_targetedEntities → distribution_targetEntities
Organizational Followers
New fields:
- followerCountsByAssociationType
- followerCountsBySeniority
- followerCountsByIndustry
- followerCountsByFunction
- followerCountsByStaffCountRange
- followerCountsByGeoCountry
- followerCountsByGeo
Organizaiton Page Statistics Report
New fields:
- pageStatisticsBySeniority
- pageStatisticsByCountry
- pageStatisticsByIndustry
- pageStatisticsByTargetedContent
- pageStatisticsByStaffCountRange
- pageStatisticsByFunction
- pageStatisticsByRegion
What Should You Do?
- If you want to use the new fields within custom reports: update Rivery’s mapping of the relevant reports according to the required fields (using “clear all” and then “Auto Mapping” under your River schema tab).
- The changes in Linkedin Social ‘Get Posts’ report requires updating Rivery’s mapping of the the report report to get the updated fields (using “clear all” and then “Auto Mapping” under your River schema tab), after we will confirm the upgrade on Thursday, June 29, 2023.
- If you are currently using deprecated fields / properties:
If no action is taken, deprecated fields / properties will be shown as null in the existing report’s data. If you wish to remove those from the target table, remove those in the schema mapping.