LinkedIn Conversions API per il B2B: regole di conversione, li_fat_id ed e-mail con hash

Cosa LinkedIn si aspetta da te

1. Una regola di conversione in Campaign Manager (Analizza → Monitoraggio delle conversioni) con origine "Conversions API". Ogni regola ha un ID numerico; l'API vi fa riferimento come urn:lla:llaPartnerConversion:{id}.
2. Un token OAuth 2.0 con gli scope r_ads e rw_conversions, emesso per un utente con accesso all'account pubblicitario. Track collega l'account tramite l'OAuth di LinkedIn e rinnova il token automaticamente.
3. L'Insight Tag nel browser, se vuoi un tracking ibrido: imposta l'identificatore first-party li_fat_id che rende preciso il match lato server.

La richiesta

POST https://api.linkedin.com/rest/conversionEvents con gli header Authorization: Bearer <token>, LinkedIn-Version: 202608, X-Restli-Protocol-Version: 2.0.0 e Content-Type: application/json:

{
  "conversion": "urn:lla:llaPartnerConversion:123456",
  "conversionHappenedAt": 1767225600000,
  "conversionValue": { "currencyCode": "EUR", "amount": "1200.00" },
  "eventId": "01J9EXAMPLESOURCEEVENTID00",
  "user": {
    "userIds": [
      { "idType": "SHA256_EMAIL", "idValue": "<sha256>" },
      { "idType": "LINKEDIN_FIRST_PARTY_ADS_TRACKING_UUID", "idValue": "<li_fat_id>" }
    ],
    "userInfo": { "firstName": "…", "lastName": "…", "companyName": "…", "title": "…", "countryCode": "DE" }
  }
}

Un 201 Created conferma l'accettazione. La creazione in batch usa lo stesso percorso con l'header X-RestLi-Method: BATCH_CREATE e un array elements; LinkedIn risponde per ciascun elemento.

Il versioning è mensile. L'header LinkedIn-Version indica una versione che resta valida per circa un anno; Track la fissa nel proprio registro delle versioni e avvisa prima della data di dismissione.

Identificatori e cosa fa davvero match

• LINKEDIN_FIRST_PARTY_ADS_TRACKING_UUID — il valore li_fat_id che l'Insight Tag memorizza (aggiunto anche agli URL delle landing page come li_fat_id). Qualità di match più alta; per acquisirlo serve il consenso marketing.
• SHA256_EMAIL — l'e-mail aziendale normalizzata, in minuscolo, con hash. I lead B2B di solito la forniscono; funziona senza il tag.
• userInfo — nome, azienda, ruolo e paese in chiaro. LinkedIn li usa come segnali ausiliari di match; invia solo quelli che la tua policy consente.

Per gli eventi lead non è richiesto alcun conversionValue, ma inviare un valore modellato aiuta l'ottimizzazione delle campagne.

Deduplicare con l'Insight Tag

Se una regola viene tracciata sia dall'Insight Tag (window.lintrk('track', { conversion_id: 123456 })) sia dall'API, passa lo stesso eventId su entrambi i percorsi; LinkedIn deduplica gli ID identici per la stessa regola. In pratica la maggior parte dei team B2B tiene separate le regole browser e server: "Invio form (tag)" scatta subito, "Lead qualificato (CRM)" arriva dal server giorni dopo con una regola diversa, quindi non c'è nulla da deduplicare.

La finestra di 90 giorni e le qualificazioni ritardate

conversionHappenedAt deve rientrare negli ultimi 90 giorni. È questo che rende praticabili le conversioni guidate dal CRM: quando un lead diventa un'opportunità tre settimane dopo il clic, caricalo con l'orario di conversione originale e l'e-mail, e LinkedIn lo attribuisce a ritroso all'interazione con l'annuncio.

Errori

La procedura guidata valida la connessione elencando le regole di conversione che il token può vedere, così un ID regola sconosciuto viene intercettato prima del primo evento.