LinkedIn Lead Gen Forms (Lead Sync): Most-used fields

LinkedIn Lead Gen Forms (Lead Sync): Most-used fields#

The table below gives information about most-used fields that you can import from LinkedIn Lead Gen Forms (Lead Sync). Other fields might also be available in Adverity.

The fields that you can fetch in Adverity are updated regularly to reflect updates to data source APIs.

API name

Adverity UI name

Description

Use in Adverity

Campaign ID

Campaign ID

A unique identifier for the ad campaign associated with the lead form response.

metric

Campaign name

Campaign name

The name of the ad campaign associated with the lead form response.

dimension

Campaign status

Campaign status

The current lifecycle status of the associated advertising campaign. This indicates if the campaign is running, paused, or completed.

dimension

Campaign type

Campaign type

The type of ad campaign, such as TEXT_AD, SPONSORED_UPDATES, SPONSORED_INMAILS, or DYNAMIC.

dimension

Consent response.{NUM}.accepted

Consent response.{NUM}.accepted

Indicates whether the submitter accepted (true) or declined (false) a specific consent request.

dimension

Consent response.{NUM}.consentId

Consent response.{NUM}.consentId

The unique identifier for a specific consent option within the form’s legal information.

metric

Email

Email

The email address of the member, if collected through a predefined email field.

dimension

FirstName

FirstName

The first name of the member, if collected through a predefined first name field.

dimension

Form ID

Form ID

A numerical identifier for the Lead Gen Form.

metric

Form consent.{NUM}.checkRequired

Form consent.{NUM}.checkRequired

Indicates whether a specific consent checkbox must be selected by the member when submitting the form.

dimension

Form consent.{NUM}.consent.localized.en_US

Form consent.{NUM}.consent.localized.en_US

The custom text displayed next to a consent checkbox in US English (en_US), informing the member about the data usage they are consenting to.

dimension

Form consent.{NUM}.id

Form consent.{NUM}.id

The unique identifier for a specific consent within the Lead Gen Form’s legal information.

metric

Form consent.{NUM}.label

Form consent.{NUM}.label

The marketer-specified label for a consent option, unique within the form’s context.

dimension

Form country

Form country

The uppercase two-letter country code (ISO-3166) of the locale where the form was created, influencing localized content.

dimension

Form created

Form created

The epoch time in milliseconds when the Lead Gen Form was created.

metric

Form created date

Form created date

The calendar date when the Lead Gen Form was created, derived from the ‘Form created’ timestamp.

dimension

Form created datetime

Form created datetime

The full date and time when the Lead Gen Form was created, derived from the ‘Form created’ timestamp.

dimension

Form description en_US

Form description en_US

The optional description or introductory text of the form in US English (en_US), displayed to the viewer.

dimension

Form headline en_US

Form headline en_US

The main headline of the form in US English (en_US), displayed to the viewer.

dimension

Form language

Form language

The lowercase two-letter language code (ISO-639-1) of the locale where the form was created, influencing localized content.

dimension

Form lastmodified

Form lastmodified

The epoch time in milliseconds when the Lead Gen Form was last modified.

metric

Form lastmodified date

Form lastmodified date

The calendar date when the Lead Gen Form was last modified, derived from the ‘Form lastmodified’ timestamp.

dimension

Form lastmodified datetime

Form lastmodified datetime

The full date and time when the Lead Gen Form was last modified, derived from the ‘Form lastmodified’ timestamp.

dimension

Form legal disclaimer en_US

Form legal disclaimer en_US

The owner’s legal disclaimer text in US English (en_US) accompanying the Lead Gen Form.

dimension

Form legal info ID

Form legal info ID

A unique identifier for the legal information section of the Lead Gen Form.

metric

Form name

Form name

The name of the Lead Gen Form, provided by the owner for internal identification.

dimension

Form privacy policy URL

Form privacy policy URL

The URL of the privacy policy that applies to data collected through this form.

dimension

Form state

Form state

The current lifecycle state of the Lead Gen Form, such as DRAFT, PUBLISHED, or ARCHIVED.

dimension

Hidden fields.{NUM}.name

Hidden fields.{NUM}.name

The name of a hidden field, used by marketers for tracking purposes and not displayed on the form.

dimension

Hidden fields.{NUM}.value

Hidden fields.{NUM}.value

The value of a hidden field, which can be static or dynamic, used for tracking purposes.

dimension

Industry

Industry

The industry of the member, if collected through a predefined industry field.

dimension

JobTitle

JobTitle

The latest job title of the member, if collected through a predefined job title field.

dimension

Language

Language

The language code of the member, if collected through a predefined language field or derived from the form’s creation locale.

dimension

LastName

LastName

The last name of the member, if collected through a predefined last name field.

dimension

Lead type

Lead type

The type of lead, indicating its origination (e.g., SPONSORED for ad-driven leads, COMPANY for company page leads, EVENT for event leads, or ORGANIZATION_PRODUCT for product page leads).

dimension

LinkedInProfile

LinkedInProfile

The LinkedIn public profile URL of the member who submitted the form, if available as a predefined field.

dimension

Owner

Owner

The Uniform Resource Name (URN) that identifies the owner of the Lead Gen Form or Lead Form Response, which can be an ad account or an organization.

dimension

Owner name

Owner name

The name of the entity that owns the Lead Form Response, such as the ad account name or organization name.

dimension

PostSubmissionInfo call to action label

PostSubmissionInfo call to action label

The label for the call to action button displayed to the member after submitting the form (e.g., VISIT_COMPANY_WEBSITE, LEARN_MORE).

dimension

PostSubmissionInfo landing page URL

PostSubmissionInfo landing page URL

The URL of the landing page where the user is directed after clicking the call to action button following form submission.

dimension

PostSubmissionInfo message en_US

PostSubmissionInfo message en_US

The message displayed to the member in US English (en_US) on the post-submission screen (e.g., a thank you message).

dimension

Question.{NUM}.label

Question.{NUM}.label

The marketer-specified label for a question, unique within the context of a single form.

dimension

Question.{NUM}.name

Question.{NUM}.name

A human-readable, language-agnostic name for the question, used by the form owner for identification but not visible to the viewer.

dimension

Question.{NUM}.predefinedField

Question.{NUM}.predefinedField

The predefined field type (e.g., FIRST_NAME, EMAIL, JOB_TITLE) that the question is requesting, allowing for pre-filling with viewer profile information.

dimension

Question.{NUM}.question.localized.da_DK

Question.{NUM}.question.localized.da_DK

The question prompt displayed to the viewer in Danish (da_DK) for a specific question.

dimension

Question.{NUM}.question.localized.de_DE

Question.{NUM}.question.localized.de_DE

The question prompt displayed to the viewer in German (de_DE) for a specific question.

dimension

Question.{NUM}.question.localized.en_US

Question.{NUM}.question.localized.en_US

The question prompt displayed to the viewer in US English (en_US) for a specific question.

dimension

Question.{NUM}.question.localized.es_ES

Question.{NUM}.question.localized.es_ES

The question prompt displayed to the viewer in Spanish (es_ES) for a specific question.

dimension

Question.{NUM}.question.localized.it_IT

Question.{NUM}.question.localized.it_IT

The question prompt displayed to the viewer in Italian (it_IT) for a specific question.

dimension

Question.{NUM}.question.localized.tr_TR

Question.{NUM}.question.localized.tr_TR

The question prompt displayed to the viewer in Turkish (tr_TR) for a specific question.

dimension

Question.{NUM}.questionDetails.multipleChoiceQuestionDetails.options

Question.{NUM}.questionDetails.multipleChoiceQuestionDetails.options

A collection of all available options for a multiple-choice question.

dimension

Question.{NUM}.questionDetails.multipleChoiceQuestionDetails.options.{NUM}.id

Question.{NUM}.questionDetails.multipleChoiceQuestionDetails.options.{NUM}.id

A unique identifier for a specific option within a multiple-choice question.

metric

Question.{NUM}.questionDetails.multipleChoiceQuestionDetails.options.{NUM}.label

Question.{NUM}.questionDetails.multipleChoiceQuestionDetails.options.{NUM}.label

The marketer-specified label for a multiple-choice option, unique within its question.

dimension

Question.{NUM}.questionDetails.multipleChoiceQuestionDetails.options.{NUM}.text.localized.en_US

Question.{NUM}.questionDetails.multipleChoiceQuestionDetails.options.{NUM}.text.localized.en_US

The text describing a multiple-choice option in US English (en_US).

dimension

Question.{NUM}.questionDetails.multipleChoiceQuestionDetails.options.{NUM}.text.localized.es_ES

Question.{NUM}.questionDetails.multipleChoiceQuestionDetails.options.{NUM}.text.localized.es_ES

The text describing a multiple-choice option in Spanish (es_ES).

dimension

Question.{NUM}.questionDetails.textQuestionDetails.maxResponseLength

Question.{NUM}.questionDetails.textQuestionDetails.maxResponseLength

The maximum allowed length, in characters, for a text-entry question’s response.

metric

Question.{NUM}.questionId

Question.{NUM}.questionId

A unique identifier for a specific question within the Lead Gen Form.

metric

Question.{NUM}.questionSubmissionCriteria.workEmailSubmissionCriteria.freemiumEmailAllowed

Question.{NUM}.questionSubmissionCriteria.workEmailSubmissionCriteria.freemiumEmailAllowed

For a ‘Work Email’ predefined field, this indicates if personal or freemium domain email addresses are permitted as responses.

dimension

Question.{NUM}.responseEditable

Question.{NUM}.responseEditable

Indicates whether the member viewing the form can edit a pre-filled response for this question.

dimension

Question.{NUM}.responseRequired

Question.{NUM}.responseRequired

Indicates whether a response is mandatory for this question.

dimension

Response ID

Response ID

A unique identifier for a specific Lead Form Response.

dimension

Response.{NUM}.answerDetails.multipleChoiceAnswer.options

Response.{NUM}.answerDetails.multipleChoiceAnswer.options

A collection of the identifiers for the chosen options in a multiple-choice answer.

dimension

Response.{NUM}.answerDetails.multipleChoiceAnswer.options.{NUM}

Response.{NUM}.answerDetails.multipleChoiceAnswer.options.{NUM}

An identifier for a chosen option in a multiple-choice question, as selected by the submitter.

metric

Response.{NUM}.answerDetails.textQuestionAnswer.answer

Response.{NUM}.answerDetails.textQuestionAnswer.answer

The text answer provided by the submitter for a specific text-entry question.

dimension

Response.{NUM}.questionId

Response.{NUM}.questionId

The unique identifier of the question to which this response corresponds.

metric

Submitted

Submitted

An epoch timestamp in milliseconds indicating when the form response was submitted.

metric

Submitted date

Submitted date

The calendar date when the Lead Form response was submitted, derived from the ‘Submitted’ timestamp.

dimension

Submitted datetime

Submitted datetime

The full date and time when the Lead Form response was submitted, derived from the ‘Submitted’ timestamp.

dimension

Submitter

Submitter

The Uniform Resource Name (URN) of the LinkedIn member who submitted the form. This field may be null for guest leads.

dimension

Test lead

Test lead

Indicates whether the lead is a test lead (true) created for testing purposes or a genuine lead (false).

dimension

Version ID

Version ID

The server-generated version identifier of the Lead Gen Form, which increments with each modification.

metric

utm_campaign

utm_campaign

The UTM campaign parameter, if included as a hidden field, used to identify the specific campaign that referred the lead.

dimension

utm_content

utm_content

The UTM content parameter, if included as a hidden field, used to differentiate between different ads or links within the same campaign.

dimension

utm_medium

utm_medium

The UTM medium parameter, if included as a hidden field, used to identify the medium (e.g., email, CPC, social) that referred the lead.

dimension

utm_source

utm_source

The UTM source parameter, if included as a hidden field, used to identify the source (e.g., LinkedIn, newsletter) that referred the lead.

dimension

utm_term

utm_term

The UTM term parameter, if included as a hidden field, used to identify the keywords for paid search campaigns.

dimension