Set up the account tag
Use the account that owns the organization’s LinkedIn campaigns. Do not use a tag from another advertiser or an Erdo account. The account, partner, and conversion IDs must be positive decimal integers that JavaScript can represent exactly.- Call
run_integration_actionwithapp: linkedin_ads,action_key: get_linkedin_insight_tag, andconfigured_props: {"ad_account_id": "123456789"}. Use the numeric sponsored account ID resolved for this organization. - The read returns the tag’s
partner_id. This is the_linkedin_partner_idfrom LinkedIn’s browser snippet. LinkedIn’s APIInsightTag.idis a separate identifier; use the returnedpartner_idto configure page tracking. - Call
run_integration_actionagain withapp: linkedin_ads,action_key: set_linkedin_insight_tracking, andconfigured_props: {"ad_account_id": "123456789", "partner_id": "987654321"}. Includeconversion_idinconfigured_propswhen needed. The setup action checks the tag and conversion against that same account before saving.
ad_account_id and partner_id are required. conversion_id is optional. Omitting it when
updating an existing destination clears its lead-conversion mapping; retain the current ID if you
want to keep measuring that conversion. Provide it when you
want successful lead captures to count against a LinkedIn website conversion owned by that same
account. LinkedIn’s conversion setup guide
explains how to create event-specific conversions and verify that the Insight Tag is installed.
The conversion ID is available from the conversion’s settings in Campaign Manager; see
LinkedIn’s instructions for finding it.
The tag read needs LinkedIn Ads account access and the r_ads permission. If the account has no
Insight Tag yet, create one in that account’s Campaign Manager, then run the read again. LinkedIn
describes the tag creation steps here. If
the read is denied, resolve account access or permission before configuring page tracking.
When a conversion ID is supplied, Erdo reads it from the account-scoped
GET /rest/conversions/{conversion_id}?account={sponsoredAccountUrn} endpoint
and confirms the response belongs to the same account before saving it.
The tools read and configure the account through its connected LinkedIn integration. The Insight Tag
API supports account-scoped lookup with GET /rest/insightTags?q=account&account=...; LinkedIn
documents that an ad account has one Insight Tag in its Marketing API guide.
What the tag sends
The page shell loads LinkedIn’s tag and records the page view. Whenconversion_id is configured, a
successful lead capture sends lintrk('track', { conversion_id: ... }) after the server confirms
that the lead was saved. Page views continue to support retargeting when no conversion ID is set.
Phone calls, form opens, and failed submissions do not fire this lead conversion.
The tag follows the page’s gtag Consent Mode state. If the page sets any of ad_storage,
ad_user_data, or ad_personalization to denied or leaves a required-consent setup without grants,
the tag waits. With consent: implied and no explicit consent command, it initializes after the DOM
is ready. A later consent update initializes a tag that was waiting; a later denial blocks further
lead-conversion calls.
LinkedIn advises against installing the Insight Tag on pages that collect or contain sensitive
data. Review its Insight Tag guidance for the
page types covered by that restriction before connecting the tag.
Read the configuration
Useerdo analytics tracking or the read-only GET /v1/page-tracking endpoint to confirm whether
the tag is configured and enabled. A linkedin_insight destination returns its numeric partner_id
as public_id. If a conversion is configured, its ID appears as conversion_id; the field is
omitted for retargeting-only setup. See page tracking for the complete response
shape and CLI output.
