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 |
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 |