LinkedIn Ads Updates

Updates on the LinkedIn Ads data source, including new metrics, dimensions, and other features.

February 2023

2023-02-21

The following fields have been deprecated as they are no longer supported. Please remove them from your reporting:

• Creative ad preview URL

January 2023

2021-01-03

New fields added:

• Document completions

• Document first quartile completions

• Document midpoint completions

• Document third quartile completions

• Download clicks

• Full screen plays

• Lead form completion rate (%)

• Video starts

• Viral document completions

• Viral document first quartile completions

• Viral document midpoint completions

• Viral document third quartile completions

• Viral download clicks

• Viral video views

October 2022

2022-10-31

These fields have been deprecated:

• Reach 1 day

• Reach 7 day

• Reach 30 day

• Frequency 1 day

• Frequency 7 day

• Frequency 30 day

• Cost per reach 1 day

• Cost per reach 7 day

• Cost per reach 30 day

2022-10-11

New fields added: * Ad form consent answer

• Ad form consent text

• Ad form hidden field name

• Ad form hidden field value

• Ad form response answer

• Ad form response ID

• Ad form response lead type

• Ad form response submission time

• Ad form response test lead

August 2022

2022-08-01

Metric deprecated:

• Reach

New metrics added:

• Reach 1 day

• Reach 7 day

• Reach 30 day

• Frequency 1 day

• Frequency 7 day

• Frequency 30 day

• Cost per reach 1 day

• Cost per reach 7 day

• Cost per reach 30 day

September 2022

Added ability to combine demographic data (member company, member industry, member country, etc.) by the campaign name or ID.

January 2022

2022-01-05

New metric added:

• Reactions

August 2021

2021-08-25

New dimension added:

• Creative ad preview URL

May 2021

2021-05-27 -

New fields added for thumbnail images for creatives. Note only SPONSORED_STATUS_UPDATE and TYPE_SPONSORED_UPDATE_CAROUSEL creatives support these.

• Creative thumbnail
• Creative thumbnail URL

April 2021

2021-04-08 -

Properly marked "Non-chargable clicks" as deprecated (as it had been retired in the API years ago).

Dec. 2020

2020-12-17:

Added "double pivots" feature, which allows combining dimensions from more than one report type into the same query. Note that there are still some limitations from the API about what can be combined - see this article for more infomation.

Nov. 2020

2020-11-04 -

Added new metric "Reach".

Oct. 2020

2020-10-01:

Feature added to support longer lived authentication tokens. They should now last 365 days instead of 60 (requires re-authentication to get new type of token).

2020-10-30:

The following field was deprecated. Please use the alternative instead.

Deprecated Field	Replace with...
Account total Budget	Campaign group total budget

Jan. 2020

2020-01-14 - new fields have been added:

• Viral external website conversions
• Viral external website post click conversion
• Viral external website post view conversions
• Viral full screen plays
• Viral reactions
• Viral video starts
• Viral video completions
• Viral video views at 25%
• Viral video views at 50%
• Viral video views at 75%

Dec. 2019

2019-12-04 - new dimension added:

• Campaign created date

Nov. 2019

2019-11-28 - the following dimension has been added:

• Carousel card index

Oct. 2019

2019-10-03 - new dimensions added:

• Insight tag domain ID
• Insight tag domain

2019-10-08 - new conversion pivot added for conversion-specific fields:

• Conversion ID
• Conversion name
• Conversion type
• Conversion enabled
• Conversion value
• Conversion currency

2019-10-30 - dimension added to support Lead forms and get the details from those.

• Ad form name
• Ad form ID
• Ad form headline
• Ad form landing page
• Ad form legal disclaimer
• Ad form privacy policy
• Ad form version tag
• Ad form question name
• Ad form question ID
• Ad form question field
• Ad form question placeholder
• Ad form question text

May 2019

2019-05-02 - new metric added:

• Sends

April 2019

2019-04-02:

• Added support for Sponsored Videos.
• Added support for Sponsored Status Update creative fields.
• API behavior note - If Sponsored content is deleted, content for creative fields (intro text, etc.) is also deleted from the API and won't be obtainable by Supermetrics after that.

Feb. 2019

2019-02-28:

The authentication has been updated to use v2 as the v1 API is being deprecated. You will need to re-authenticate the LinkedIn Ads connector after this change.

Oct. 2018

New metric added - 2018-10-18:

• Cost per lead

April 2018

New video metrics added - 2018-04-03:

• Video Views
• Video Views at 25%
• Video Views at 50%
• Video Views at 75%
• Video Completions

Feb. 2018

New dimensions added - 2018-02-01:

• Campaign objective type
• Campaign total budget
• Campaign start date
• Campaign end date

New dimensions added - 2018-02-12:

• Creative Direct Sponsored Content name
• Campaign group name
• Campaign group ID
• Campaign group status
• Campaign group total budget
• Campaign group start date
• Campaign group end date