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.
| Field | Type |
|---|---|
| account ID | Text |
| account urn | Text |
| account name | Text |
| currency | Text |
| status | Text |
| account type | Text |
| is test | True/false |
| reference urn | Text |
| reference ID | Text |
| serving statuses | Text |
| reporting timezone | Text |
| raw payload | Text |
| changeauditstamps created actor | Text |
| changeauditstamps created time | Text |
| changeauditstamps lastmodified actor | Text |
| changeauditstamps lastmodified time | Text |
| client ID | Text |
| date range end | Text |
| date range start | Text |
| ID | Text |
| name | Text |
| notifiedoncampaignoptimization | Text |
| notifiedoncreativeapproval | Text |
| notifiedoncreativerejection | Text |
| notifiedonendofcampaign | Text |
| notifiedonnewfeaturesenabled | Text |
| reference | Text |
| servingstatuses | Text |
| test | Text |
| type | Text |
| version versiontag | Text |
Campaign groups#
LinkedIn campaign-group configuration and lifecycle; parent of sponsored campaigns.
| Field | Type |
|---|---|
| campaign group ID | Text |
| account ID | Text |
| campaign group name | Text |
| status | Text |
| total budget | Number |
| budget currency | Text |
| run schedule start ms | Integer |
| run schedule end ms | Integer |
| created at platform | Integer |
| last modified at platform | Integer |
| raw payload | Text |
| account | Text |
| allowedcampaigntypes | Text |
| backfilled | Text |
| budgetoptimization bidstrategy | Text |
| budgetoptimization budgetoptimizationstrategy | Text |
| changeauditstamps created actor | Text |
| changeauditstamps created time | Text |
| changeauditstamps lastmodified actor | Text |
| changeauditstamps lastmodified time | Text |
| client ID | Text |
| dailybudget | Text |
| date range end | Text |
| date range start | Text |
| ID | Text |
| name | Text |
| objectivetype | Text |
| runschedule end | Text |
| runschedule start | Text |
| servingstatuses | Text |
| test | Text |
| totalbudget amount | Text |
| totalbudget currencycode | Text |
Campaigns#
LinkedIn sponsored-campaign configuration, hierarchy, status, objective, format, bidding, budget, locale, and flight.
| Field | Type |
|---|---|
| campaign ID | Text |
| campaign name | Text |
| account ID | Text |
| campaign group ID | Text |
| status | Text |
| objective type | Text |
| campaign type | Text |
| campaign format | Text |
| cost type | Text |
| creative selection | Text |
| optimization target type | Text |
| daily budget | Number |
| total budget | Number |
| budget currency | Text |
| unit cost | Number |
| unit cost currency | Text |
| locale country | Text |
| locale language | Text |
| run schedule start ms | Integer |
| run schedule end ms | Integer |
| audience expansion enabled | True/false |
| offsite delivery enabled | True/false |
| connected television only | True/false |
| associated entity urn | Text |
| serving statuses | Text |
| version tag | Text |
| created at platform | Integer |
| last modified at platform | Integer |
| raw payload | Text |
| loaded at | Timestamp |
| account | Text |
| associatedentity | Text |
| audienceexpansionenabled | Text |
| campaigngroup | Text |
| changeauditstamps created actor | Text |
| changeauditstamps created time | Text |
| changeauditstamps lastmodified actor | Text |
| changeauditstamps lastmodified time | Text |
| client ID | Text |
| connectedtelevisiononly | Text |
| costtype | Text |
| creativeselection | Text |
| dailybudget amount | Text |
| dailybudget currencycode | Text |
| date range end | Text |
| date range start | Text |
| format | Text |
| ID | Text |
| name | Text |
| objectivetype | Text |
| offsitedeliveryenabled | Text |
| offsitepreferences iabcategories exclude | Text |
| offsitepreferences publisherrestrictionfiles exclude | Text |
| offsitepreferences publisherrestrictionfiles include | Text |
| optimizationtargettype | Text |
| pacingstrategy | Text |
| politicalintent | Text |
| runschedule end | Text |
| runschedule start | Text |
| servingstatuses | Text |
| storydeliveryenabled | Text |
| targetingcriteria exclude or | Text |
| targetingcriteria include and | Text |
| test | Text |
| totalbudget amount | Text |
| totalbudget currencycode | Text |
| type | Text |
| unitcost amount | Text |
| unitcost currencycode | Text |
| version versiontag | Text |
Ad insights#
Daily ad performance metrics.
| Field | Type |
|---|---|
| date | Date |
| account ID | Text |
| account name | Text |
| campaign ID | Text |
| impressions | Integer |
| clicks | Integer |
| spend | Number |
| conversions | Integer |
| one click leads | Integer |
| video views | Integer |
| landing page clicks | Integer |
| total engagements | Integer |
| qualified leads | Integer |
| conversion value in local currency | Number |
| reporting timezone | Text |
| loaded at | Timestamp |
| client ID | Text |
| comments | Text |
| cost in local currency | Text |
| date range end | Text |
| date range start | Text |
| follows | Text |
| likes | Text |
| pivot value | Text |
| reactions | Text |
| shares | Text |
| video completions | Text |
| video first quartile completions | Text |
| video midpoint completions | Text |
| video third quartile completions | Text |
Creative insights#
Daily LinkedIn delivery at sponsored-creative grain, including paid-social, video, lead, messaging, job, document, and conversion metrics.
| Field | Type |
|---|---|
| date | Date |
| account ID | Text |
| campaign ID | Text |
| creative ID | Text |
| impressions | Integer |
| clicks | Integer |
| landing page clicks | Integer |
| spend | Number |
| cost in local currency | Number |
| conversions | Number |
| external website post click conversions | Number |
| external website post view conversions | Number |
| conversion value in local currency | Number |
| total engagements | Integer |
| likes | Integer |
| comments | Integer |
| shares | Integer |
| reactions | Integer |
| follows | Integer |
| video starts | Integer |
| video views | Integer |
| video first quartile completions | Integer |
| video midpoint completions | Integer |
| video third quartile completions | Integer |
| video completions | Integer |
| one click lead form opens | Integer |
| one click leads | Integer |
| qualified leads | Integer |
| sends | Integer |
| opens | Integer |
| lead generation mail contact info shares | Integer |
| lead generation mail interested clicks | Integer |
| registrations | Number |
| post click registrations | Number |
| post view registrations | Number |
| job applications | Number |
| job apply clicks | Number |
| document completions | Integer |
| reporting timezone | Text |
| company page clicks | Integer |
Conversions#
LinkedIn conversion rule metadata keyed by account and conversion id.
| Field | Type |
|---|---|
| client ID | Text |
| account ID | Text |
| conversion ID | Text |
| conversion urn | Text |
| name | Text |
| type | Text |
| enabled | True/false |
| attribution type | Text |
| post click attribution window size | Integer |
| view through attribution window size | Integer |
| associated campaigns | Text |
| campaigns | Text |
| URL rules | Text |
| image pixel tag | Text |
| value amount | Text |
| value currency code | Text |
| created at platform | Integer |
| last modified at platform | Integer |
| last callback at platform | Integer |
| latest first party callback at platform | Integer |
| conversion method | Text |
| raw payload | Text |
| date range start | Text |
| date range end | Text |
Insight tag domains#
Daily snapshot of the domains each account's LinkedIn Insight Tag has called back from.
| Field | Type |
|---|---|
| client ID | Text |
| account ID | Text |
| insight tag ID | Text |
| insight tag urn | Text |
| domain name | Text |
| blocked | True/false |
| last callback at platform | Integer |
| created at platform | Integer |
| snapshot date | Date |
| raw payload | Text |
| date range start | Text |
| date range end | Text |
Configured target coverage#
Current completeness status for LinkedIn campaign conversion-association collection.
| Field | Type |
|---|---|
| coverage key | Text |
| account ID | Text |
| scope level | Text |
| collection status | Text |
| source entity count | Integer |
| configured target count | Integer |
| capability reason | Text |
| collected at | Timestamp |
Conversion action insights#
| Field | Type |
|---|---|
| client ID | Text |
| account ID | Text |
| campaign ID | Text |
| creative ID | Text |
| conversion ID | Text |
| conversion urn | Text |
| date | Date |
| conversions | Number |
| conversion value in local currency | Number |
| raw pivot values | Text |
| requested pivots | Text |
| reported grain | Text |
| raw payload | Text |
| date range start | Text |
| date range end | Text |
Conversion report coverage daily#
Successful LinkedIn native conversion-report coverage including accepted fallback pivot grain.
| Field | Type |
|---|---|
| date | Date |
| account ID | Text |
| report name | Text |
| requested grain | Text |
| reported grain | Text |
| report status | Text |
| row count | Integer |
| is partial | True/false |
Member company daily#
Daily paid LinkedIn delivery at member-company grain.
| Field | Type |
|---|---|
| date | Date |
| client ID | Text |
| account ID | Text |
| campaign ID | Text |
| provider company ID | Text |
| provider company urn | Text |
| paid impressions | Number |
| paid clicks | Number |
| paid landing page clicks | Number |
| paid engagements | Number |
| paid leads | Number |
| paid conversions | Number |
| spend usd | Number |
| source mode | Text |
| raw payload | Text |
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.
| Field | Type |
|---|---|
| date | Date |
| client ID | Text |
| account ID | Text |
| campaign ID | Text |
| pivot | Text |
| geo level | Text |
| pivot value urn | Text |
| pivot value ID | Text |
| impressions | Number |
| clicks | Number |
| landing page clicks | Number |
| cost in local currency | Number |
| cost in usd | Number |
| external website conversions | Number |
| external website post click conversions | Number |
| external website post view conversions | Number |
| one click leads | Number |
| approximate | True/false |
| reporting timezone | Text |
| raw payload | Text |
| date range start | Text |
| date range end | Text |
Geo names#
| Field | Type |
|---|---|
| geo ID | Text |
| geo urn | Text |
| name | Text |
| locale | Text |
| client ID | Text |
| raw payload | Text |
| date range start | Text |
| date range end | Text |
Company intelligence snapshots#
Rolling LinkedIn Company Intelligence snapshots.
| Field | Type |
|---|---|
| snapshot date | Date |
| window start date | Date |
| window end date | Date |
| lookback window | Text |
| client ID | Text |
| account ID | Text |
| campaign ID | Text |
| provider company ID | Text |
| company name | Text |
| company website | Text |
| company page URL | Text |
| industry | Text |
| employee count range | Text |
| country | Text |
| paid impressions | Number |
| paid clicks | Number |
| paid engagements | Number |
| paid leads | Number |
| paid qualified leads | Number |
| paid conversions | Number |
| organic impressions | Number |
| organic engagements | Number |
| source mode | Text |
| raw payload | Text |
Creatives#
Creative metadata + landing URL for ACTIVE/PAUSED creatives.
| Field | Type |
|---|---|
| creative ID | Text |
| campaign ID | Text |
| account ID | Text |
| intended status | Text |
| is serving | True/false |
| creative name | Text |
| creative type | Text |
| landing page URL | Text |
| image URL | Text |
| content reference urn | Text |
| review status | Text |
| serving hold reasons | Text |
| preview asset ID | Text |
| preview storage path | Text |
| preview source URL | Text |
| preview status | Text |
| preview failure code | Text |
| preview verified at | Text |
| preview content type | Text |
| preview width | Integer |
| preview height | Integer |
| created at | Integer |
| last modified at | Integer |
| raw payload | Text |
| client ID | Text |
| date range end | Text |
| date range start | Text |
Creative card insights#
| Field | Type |
|---|---|
| date | Date |
| account ID | Text |
| campaign ID | Text |
| creative ID | Text |
| card index | Integer |
| card index raw | Text |
| pivot values | Text |
| card impressions | Integer |
| card clicks | Integer |
| impressions | Integer |
| clicks | Integer |
| landing page clicks | Integer |
| spend | Number |
| cost in local currency | Number |
| conversions | Number |
| conversion value in local currency | Number |
| one click leads | Integer |
| video views | Integer |
| reporting timezone | Text |
| client ID | Text |
| date range start | Text |
| date range end | Text |