Foundgrove
← All posts

Paid Ads · 9 min read

LinkedIn Conversions API: Fix B2B Attribution Signal Loss

Summary

LinkedIn's Conversions API pushes closed-won revenue back into the platform so bidding learns which leads were real. Routes, match rates, honest limits.

By Hyder Shah, Founder & CEO · Published July 13, 2026 · Updated July 13, 2026

Your LinkedIn Campaign Manager says the campaign produced 46 leads at $180 a lead. Your CRM says four of them were real, one bought, and the rest were students and job seekers grabbing a PDF. LinkedIn's bidding algorithm has no idea. It is still out there hunting for more PDF-grabbers, because that is the only signal you ever gave it.

The Conversions API is how you close that loop. It is not a tracking upgrade — it is a feedback loop that tells LinkedIn which leads turned into money. This post covers what it actually fixes, the routes to install it, what wrecks your match rate, and the honest cases where it is not worth the engineering hours.

What does the LinkedIn Conversions API actually fix?

It fixes two things at once: browser-side signal loss, and the total absence of deal value in your ad account. LinkedIn's developer docs describe it as a way to 'stream conversion events from their server to LinkedIn primarily to measure LinkedIn marketing campaign performance, regardless of where the conversion occurs' — see the Conversions API reference.

The Insight Tag is a browser pixel. Ad blockers, tracking-prevention defaults, and consent banners all sit between it and the event. That is the same failure mode we cover in the Meta Pixel and CAPI server-side setup, and the fix is the same shape: send the event from your server, where nothing can strip it.

The bigger prize is B2B-specific. A conversion event sent through the API carries a conversionValue object with a currency code and an amount. That is how LinkedIn learns the difference between a lead worth nothing and a signed contract — and no browser pixel can ever know that, because the deal closes in a CRM eight weeks later, not on a thank-you page.

  • Online events the tag missed — a demo request that fired behind a consent banner
  • Offline events the tag can never see — a sales-qualified lead, a created opportunity, a closed-won deal
  • Revenue — an actual dollar amount per event, not a flat 'lead' count
  • Events from any system — your CRM, your billing platform, your ops database

Do you still need the Insight Tag if you run CAPI?

Yes, and running both is the documented design, not a redundancy. LinkedIn's Conversions FAQ is direct about it: use the Conversions API and the Insight Tag together, and LinkedIn deduplicates events sent through both sources so nothing double-counts.

There is a harder reason. LinkedIn's strongest match key is LINKEDIN_FIRST_PARTY_ADS_TRACKING_UUID — the click ID, also called li_fat_id. Per the same FAQ, LinkedIn appends that click ID to your landing page URLs when enhanced conversion tracking with first-party cookies is enabled, and passing it back raises match rates significantly.

That click ID is generated by the Insight Tag. Rip out the tag to 'go server-side' and you have just destroyed the single best identifier you were going to send. Keep the tag, turn on first-party cookies, and capture li_fat_id into your CRM on the very first form fill.

Which integration route should you pick: direct API, CRM partner, or connector?

LinkedIn documents two implementation options — a partner integration or a direct build — and its own FAQ puts the direct build at 1-2 weeks on average. There is also a third, quieter path: a Direct API access token you generate yourself inside Campaign Manager, with no developer app and no review queue.

RouteBest forEffort per LinkedIn's docsThe catch
Direct API token (Campaign Manager)Teams with a developer and a CRM they controlNo app, no review — token generated in Signals ManagerCampaign Manager does not store the token; copy it once or regenerate. You own retries and error handling
Partner integration (GTM, Zapier, Dreamdata, Supermetrics, Tealium, Adobe)Most in-house B2B teams with no spare dev capacityOne-time setup, limited technical effort, typically fastMay carry partner fees, and you inherit their field mapping — check that it passes conversionValue
Developer Portal appSoftware vendors building for other advertisersApp review, verified business email, verified LinkedIn PageRejected outright if the Page or email is unverified. Not the route an advertiser needs

Verdict: start with a partner integration. It is the fastest path to a working signal, and a working signal in week one beats a perfect one in week six. Move to the direct API only when CRM stage data with real dollar values is the entire point of the exercise — which, for a $2,500-plus retainer, it usually is. Confirm the token flow in LinkedIn's access documentation before you brief a developer.

How do you push closed-won revenue back into LinkedIn?

Three steps, in this order: create a conversion rule, associate campaigns to it, then stream events. Skip step two and your conversions are invisible — LinkedIn only attributes a conversion to campaigns the rule is associated with, and the auto-association shortcut covers only the first 200 active campaigns.

The rule itself is where you set the attribution window. LinkedIn's API accepts post-click windows of 1, 7, 28, 30, or 90 days. A 365-day window exists, but only for a specific set of conversion types — including QUALIFIED_LEAD, LEAD, and PURCHASE. Pick the wrong type and the API rejects your 365 outright.

CRM stageConversion type to sendValue to attach
Form fill / demo requestLEADNo value, or a modeled placeholder
Sales-qualified leadQUALIFIED_LEADExpected deal size, or leave empty
Closed-wonPURCHASEThe real contract value in USD

Then the timing trap. Per LinkedIn's FAQ, conversions can be attributed for a maximum of 180 days: there is a 90-day lookback for each conversion, and the conversion must have occurred within the last 90 days to be attributed at all. Batch your CRM exports monthly and half of them arrive dead. Send events in real time, or at worst within a day.

One more number worth building around: batches take up to 5,000 events, and the API allows 600 requests per minute and 500,000 per day per access token. Almost no service business will ever come close to those ceilings — which means there is no throughput excuse for batching weekly.

What match rate should you expect, and what wrecks it?

Nobody can honestly tell you a target number, because LinkedIn does not publish one. Its docs define identity match rate and attribution match rate carefully but attach no benchmark figure to either. Any agency quoting you a 'typical 80% match rate' invented it. What the docs do say is unambiguous: only matched events can be used for attribution and optimization.

So you do not chase a number — you maximize identifiers. LinkedIn's guidance is that the more IDs you send with each event, the more likely it matches to a member, and it explicitly recommends sending both the SHA256 email and the click ID for best matching.

  • Send SHA-256 hashed email and li_fat_id together — not one or the other
  • Lowercase emails before hashing. LinkedIn recommends it, and SHA-256 is used without salting
  • The classic B2B killer: a prospect fills your form with a personal Gmail while their LinkedIn account uses a work address. No match. Ask for a work email on the form
  • Add firstName, lastName, companyName, title, and countryCode — every extra field is another shot at a match
  • Never let a conversion rule sit unassociated with campaigns. Perfect data, zero attribution
  • Late events. An event older than 90 days cannot be attributed, no matter how clean it is

How long must CAPI run before the bidding gets smarter?

Longer than your patience, and the math is your own sales cycle plus 72 hours. LinkedIn states that ingestion takes up to 24 hours and reporting an additional 48 — up to 72 hours before complete data appears. So if your average deal closes in 60 days, your first closed-won signal cannot exist in the ad account until roughly day 63 after launch.

That is arithmetic on your numbers, not a LinkedIn statistic. But it kills the most common mistake: switching CAPI on and judging the channel three weeks later. You will have spent the budget and collected almost none of the signal you turned it on to collect.

Volume matters as much as time. LinkedIn says there is no minimum number of attributed conversions for reporting — but reporting is not optimization. A bidding algorithm fed three closed-won events a month has nothing to learn from. If you close a handful of deals a month, optimize on the SQL stage instead: it fires sooner, fires more often, and still filters out the tire-kickers. The same logic drives our approach to tracking conversions across long sales cycles.

We run a 90-day kill switch on any channel that produces no qualified leads. LinkedIn CAPI is exactly why that clock starts when the signal is live, not when the ads are.

When is LinkedIn CAPI not worth the engineering hours?

Skip it when your CRM data is worse than your pixel data — which is more often than agencies admit. If your reps mark deals closed-won three weeks late, or nobody agrees what 'qualified' means, CAPI will feed LinkedIn a confident, well-formatted stream of garbage. It optimizes toward whatever you send it.

  • Your conversion happens fully on-site and the Insight Tag already fires reliably — CAPI adds resilience, not revenue
  • Nobody owns pipeline hygiene, and CRM stages get updated whenever someone remembers
  • You close a couple of deals a month. There is no volume for any algorithm to learn from
  • You are still testing whether LinkedIn works at all. Prove the channel first, then instrument it
  • Your team cannot commit to the 1-2 weeks LinkedIn's own docs budget for a direct integration, and no partner connector fits your stack

Everywhere else, it is the highest-leverage hour of engineering in a B2B paid ads program. Fixing the CRM comes first, though. Clean stages, honest definitions, work emails captured on the form — then the API has something worth carrying. That sequencing is the whole post: instrument the signal, then read it, then judge the channel.

If your LinkedIn account is optimizing toward leads your sales team quietly deletes, the fix is a feedback loop, not a new creative. We build LinkedIn CAPI into our paid ads engagements — month-to-month, no lock-in, and you own the ad account and the integration when you leave. Get my free audit and we will tell you whether your data is even good enough to send.

Where does this fit in your stack?

If you're running a US service business, the playbook in this post pairs with our full services lineup and applies cleanly across our supported industries and US locations. If you want help implementing it, book a free strategy call — we'll review your current setup and prioritize the next three moves.

For the deeper engagement details, see our paid ads service. New to the terminology here? Our SEO & marketing glossary defines every acronym in this post.

Want this built for your vertical? See SEO for SaaS Startups, SEO for B2B Software Companies, SEO for IT Services & MSPs.

What are the most common questions about this topic?

Common questions readers send us about this topic.

What is the LinkedIn Conversions API?

It is a server-to-server connection that streams conversion events from your systems directly to LinkedIn, instead of relying on the browser-based Insight Tag. LinkedIn's docs describe it as a way to measure campaign performance regardless of where the conversion happens. That means online events the pixel missed and offline events it could never see — a sales-qualified lead, a created opportunity, or a closed-won deal with a real dollar amount attached.

Do I need the Insight Tag and the Conversions API?

Both. LinkedIn's Conversions FAQ says to use them together, and it deduplicates events arriving from both sources so nothing double-counts. There is a practical reason too: the Insight Tag, with first-party cookies enabled, is what generates LinkedIn's click ID (li_fat_id). LinkedIn says passing that click ID back significantly increases match rates. Remove the tag and you lose your best identifier.

How do I upload offline conversions to LinkedIn?

Three steps. Create a conversion rule with conversionMethod set to CONVERSIONS_API and pick the conversion type and attribution window. Associate that rule with your campaigns — conversions are only attributed to campaigns the rule is linked to. Then stream events to the conversionEvents endpoint, each carrying at least one user identifier and, for revenue, a conversionValue with a currency code and amount. Batches take up to 5,000 events.

What is a good LinkedIn CAPI match rate?

LinkedIn does not publish a benchmark. Its documentation defines identity match rate and attribution match rate but attaches no target figure to either, so treat any agency quoting you a 'typical' percentage with suspicion. What LinkedIn does say is that the more identifiers you send per event, the more likely it matches — and it recommends sending both the SHA-256 hashed email and the click ID together for best results.

Can I connect HubSpot or Salesforce to LinkedIn conversions?

Yes, through one of two documented routes. A partner integration handles the connection for you — LinkedIn names Google Tag Manager, Zapier, Dreamdata, Supermetrics, Tealium, and Adobe among them — with limited technical effort but possible partner fees. Or build a direct integration, which LinkedIn's own FAQ estimates at 1-2 weeks on average and gives you full control over exactly which CRM fields and stages get sent.

How long before CAPI improves campaign performance?

Plan on at least one full sales cycle plus 72 hours. LinkedIn states ingestion takes up to 24 hours and reporting an additional 48, so complete data can take three days to appear. If your deals close in 60 days, no closed-won signal exists in the account until roughly day 63. Judging the channel three weeks after switching CAPI on tells you nothing.

How far back can LinkedIn attribute a conversion?

Up to 180 days total, but with a hard constraint people miss. LinkedIn's FAQ states there is a 90-day lookback for each conversion, and the conversion itself must have occurred within the last 90 days to be attributed. An event you export from your CRM four months after it happened is dead on arrival. Send events in real time, or within a day at the latest.

When is LinkedIn CAPI not worth setting up?

When your CRM data is worse than your pixel data. If reps update stages late or nobody agrees what qualified means, CAPI just feeds LinkedIn well-formatted garbage and the bidding optimizes toward it. Skip it if your conversion happens fully on-site and the Insight Tag fires reliably, if you close only a couple of deals a month, or if you have not yet proven the channel works at all.

About the author

Hyder Shah

Founder & CEO, Foundgrove

Hyder Shah is the founder of Foundgrove, an SEO and GEO agency for US service businesses. See our editorial policy for how these guides are researched and reviewed.

Want help applying this to your business?

Book a free 30-minute call. We'll review your current acquisition stack and show you the three highest-leverage moves for your industry and state. Or read how our paid ads service works.

Free SEO & AI visibility auditGet my free audit