Integrations

LinkedIn Ads datasets and fields

The 16 datasets Maven lands from LinkedIn Ads, every field in them, and how the connection syncs.

Maven lands 16 datasets from LinkedIn Ads in each client workspace. This page lists every one with all of its fields. For the metrics, reports and setup steps, see the LinkedIn Ads integration page.

Connection and sync#

You connect LinkedIn Ads by signing in to it and approving access, so nobody shares a password.

The first LinkedIn Ads sync pulls the most recent 30 days so the workspace fills quickly. A follow-up backfill then adds older history, up to 5 years in total. After that, each scheduled sync re-reads the last 7 days, so late changes are picked up.

Datasets#

Accounts#

LinkedIn sponsored-account metadata used to label spend with account identity, lifecycle, ISO currency, and UTC reporting context.

FieldType
account IDText
account urnText
account nameText
currencyText
statusText
account typeText
is testTrue/false
reference urnText
reference IDText
serving statusesText
reporting timezoneText
raw payloadText
changeauditstamps created actorText
changeauditstamps created timeText
changeauditstamps lastmodified actorText
changeauditstamps lastmodified timeText
client IDText
date range endText
date range startText
IDText
nameText
notifiedoncampaignoptimizationText
notifiedoncreativeapprovalText
notifiedoncreativerejectionText
notifiedonendofcampaignText
notifiedonnewfeaturesenabledText
referenceText
servingstatusesText
testText
typeText
version versiontagText

Campaign groups#

LinkedIn campaign-group configuration and lifecycle; parent of sponsored campaigns.

FieldType
campaign group IDText
account IDText
campaign group nameText
statusText
total budgetNumber
budget currencyText
run schedule start msInteger
run schedule end msInteger
created at platformInteger
last modified at platformInteger
raw payloadText
accountText
allowedcampaigntypesText
backfilledText
budgetoptimization bidstrategyText
budgetoptimization budgetoptimizationstrategyText
changeauditstamps created actorText
changeauditstamps created timeText
changeauditstamps lastmodified actorText
changeauditstamps lastmodified timeText
client IDText
dailybudgetText
date range endText
date range startText
IDText
nameText
objectivetypeText
runschedule endText
runschedule startText
servingstatusesText
testText
totalbudget amountText
totalbudget currencycodeText

Campaigns#

LinkedIn sponsored-campaign configuration, hierarchy, status, objective, format, bidding, budget, locale, and flight.

FieldType
campaign IDText
campaign nameText
account IDText
campaign group IDText
statusText
objective typeText
campaign typeText
campaign formatText
cost typeText
creative selectionText
optimization target typeText
daily budgetNumber
total budgetNumber
budget currencyText
unit costNumber
unit cost currencyText
locale countryText
locale languageText
run schedule start msInteger
run schedule end msInteger
audience expansion enabledTrue/false
offsite delivery enabledTrue/false
connected television onlyTrue/false
associated entity urnText
serving statusesText
version tagText
created at platformInteger
last modified at platformInteger
raw payloadText
loaded atTimestamp
accountText
associatedentityText
audienceexpansionenabledText
campaigngroupText
changeauditstamps created actorText
changeauditstamps created timeText
changeauditstamps lastmodified actorText
changeauditstamps lastmodified timeText
client IDText
connectedtelevisiononlyText
costtypeText
creativeselectionText
dailybudget amountText
dailybudget currencycodeText
date range endText
date range startText
formatText
IDText
nameText
objectivetypeText
offsitedeliveryenabledText
offsitepreferences iabcategories excludeText
offsitepreferences publisherrestrictionfiles excludeText
offsitepreferences publisherrestrictionfiles includeText
optimizationtargettypeText
pacingstrategyText
politicalintentText
runschedule endText
runschedule startText
servingstatusesText
storydeliveryenabledText
targetingcriteria exclude orText
targetingcriteria include andText
testText
totalbudget amountText
totalbudget currencycodeText
typeText
unitcost amountText
unitcost currencycodeText
version versiontagText

Ad insights#

Daily ad performance metrics.

FieldType
dateDate
account IDText
account nameText
campaign IDText
impressionsInteger
clicksInteger
spendNumber
conversionsInteger
one click leadsInteger
video viewsInteger
landing page clicksInteger
total engagementsInteger
qualified leadsInteger
conversion value in local currencyNumber
reporting timezoneText
loaded atTimestamp
client IDText
commentsText
cost in local currencyText
date range endText
date range startText
followsText
likesText
pivot valueText
reactionsText
sharesText
video completionsText
video first quartile completionsText
video midpoint completionsText
video third quartile completionsText

Creative insights#

Daily LinkedIn delivery at sponsored-creative grain, including paid-social, video, lead, messaging, job, document, and conversion metrics.

FieldType
dateDate
account IDText
campaign IDText
creative IDText
impressionsInteger
clicksInteger
landing page clicksInteger
spendNumber
cost in local currencyNumber
conversionsNumber
external website post click conversionsNumber
external website post view conversionsNumber
conversion value in local currencyNumber
total engagementsInteger
likesInteger
commentsInteger
sharesInteger
reactionsInteger
followsInteger
video startsInteger
video viewsInteger
video first quartile completionsInteger
video midpoint completionsInteger
video third quartile completionsInteger
video completionsInteger
one click lead form opensInteger
one click leadsInteger
qualified leadsInteger
sendsInteger
opensInteger
lead generation mail contact info sharesInteger
lead generation mail interested clicksInteger
registrationsNumber
post click registrationsNumber
post view registrationsNumber
job applicationsNumber
job apply clicksNumber
document completionsInteger
reporting timezoneText
company page clicksInteger

Conversions#

LinkedIn conversion rule metadata keyed by account and conversion id.

FieldType
client IDText
account IDText
conversion IDText
conversion urnText
nameText
typeText
enabledTrue/false
attribution typeText
post click attribution window sizeInteger
view through attribution window sizeInteger
associated campaignsText
campaignsText
URL rulesText
image pixel tagText
value amountText
value currency codeText
created at platformInteger
last modified at platformInteger
last callback at platformInteger
latest first party callback at platformInteger
conversion methodText
raw payloadText
date range startText
date range endText

Insight tag domains#

Daily snapshot of the domains each account's LinkedIn Insight Tag has called back from.

FieldType
client IDText
account IDText
insight tag IDText
insight tag urnText
domain nameText
blockedTrue/false
last callback at platformInteger
created at platformInteger
snapshot dateDate
raw payloadText
date range startText
date range endText

Configured target coverage#

Current completeness status for LinkedIn campaign conversion-association collection.

FieldType
coverage keyText
account IDText
scope levelText
collection statusText
source entity countInteger
configured target countInteger
capability reasonText
collected atTimestamp

Conversion action insights#

FieldType
client IDText
account IDText
campaign IDText
creative IDText
conversion IDText
conversion urnText
dateDate
conversionsNumber
conversion value in local currencyNumber
raw pivot valuesText
requested pivotsText
reported grainText
raw payloadText
date range startText
date range endText

Conversion report coverage daily#

Successful LinkedIn native conversion-report coverage including accepted fallback pivot grain.

FieldType
dateDate
account IDText
report nameText
requested grainText
reported grainText
report statusText
row countInteger
is partialTrue/false

Member company daily#

Daily paid LinkedIn delivery at member-company grain.

FieldType
dateDate
client IDText
account IDText
campaign IDText
provider company IDText
provider company urnText
paid impressionsNumber
paid clicksNumber
paid landing page clicksNumber
paid engagementsNumber
paid leadsNumber
paid conversionsNumber
spend usdNumber
source modeText
raw payloadText

Ad analytics geo daily#

Daily LinkedIn delivery at campaign x member geography grain; approximate professional-demographic metrics with values under 3 events dropped by LinkedIn, so rows do not sum exactly to campaign totals; limited to LinkedIn's two-year professional-demographic retention.

FieldType
dateDate
client IDText
account IDText
campaign IDText
pivotText
geo levelText
pivot value urnText
pivot value IDText
impressionsNumber
clicksNumber
landing page clicksNumber
cost in local currencyNumber
cost in usdNumber
external website conversionsNumber
external website post click conversionsNumber
external website post view conversionsNumber
one click leadsNumber
approximateTrue/false
reporting timezoneText
raw payloadText
date range startText
date range endText

Geo names#

FieldType
geo IDText
geo urnText
nameText
localeText
client IDText
raw payloadText
date range startText
date range endText

Company intelligence snapshots#

Rolling LinkedIn Company Intelligence snapshots.

FieldType
snapshot dateDate
window start dateDate
window end dateDate
lookback windowText
client IDText
account IDText
campaign IDText
provider company IDText
company nameText
company websiteText
company page URLText
industryText
employee count rangeText
countryText
paid impressionsNumber
paid clicksNumber
paid engagementsNumber
paid leadsNumber
paid qualified leadsNumber
paid conversionsNumber
organic impressionsNumber
organic engagementsNumber
source modeText
raw payloadText

Creatives#

Creative metadata + landing URL for ACTIVE/PAUSED creatives.

FieldType
creative IDText
campaign IDText
account IDText
intended statusText
is servingTrue/false
creative nameText
creative typeText
landing page URLText
image URLText
content reference urnText
review statusText
serving hold reasonsText
preview asset IDText
preview storage pathText
preview source URLText
preview statusText
preview failure codeText
preview verified atText
preview content typeText
preview widthInteger
preview heightInteger
created atInteger
last modified atInteger
raw payloadText
client IDText
date range endText
date range startText

Creative card insights#

FieldType
dateDate
account IDText
campaign IDText
creative IDText
card indexInteger
card index rawText
pivot valuesText
card impressionsInteger
card clicksInteger
impressionsInteger
clicksInteger
landing page clicksInteger
spendNumber
cost in local currencyNumber
conversionsNumber
conversion value in local currencyNumber
one click leadsInteger
video viewsInteger
reporting timezoneText
client IDText
date range startText
date range endText