Qu'est-ce que l'outil LinkedIn Conversions API ?

LinkedIn Conversions API (CAPI) est un endpoint server-side qui permet à votre site web ou à votre système back-end d'envoyer des événements de conversion directement à LinkedIn sans dépendre du navigateur. Comme les appels proviennent de votre serveur, les données sont moins affectées par les bloqueurs de publicité, l'ITP et les limitations de cookies. L'API connecte votre base de données à Campaign Manager, contribuant à garantir que davantage de leads qualifiés ou de ventes sont comptabilisés en réduisant la perte de données côté navigateur.

Pourquoi LinkedIn Conversions API est important

• Reliez les commandes téléphoniques, les étapes CRM ou les ventes en magasin à vos campagnes pour obtenir une vue complète.
• Des signaux plus riches aident LinkedIn à réduire automatiquement le CPA. Les annonceurs utilisant CAPI rapportent +31 % de conversions attribuées, −20 % de CPA et −39 % de coût par lead qualifié en moyenne.
• Les appels serveur résistent aux restrictions des navigateurs qui peuvent bloquer le LinkedIn Insight Tag.
• Choisissez exactement quels champs hachés sont partagés (SHA256_EMAIL, UUID de suivi first-party, ou identifiants tiers comme ACXIOM_ID et ORACLE_MOAT_ID).
• Le hachage SHA-256 côté serveur, la conservation des données pendant 180 jours et les contrôles de préférences publicitaires des membres simplifient la conformité au RGPD, au CCPA et aux lois similaires sur la vie privée.
• Les mises à jour en quasi temps réel atteignent Campaign Manager plus rapidement, permettant aux stratégies d'enchères de s'adapter avant que le budget ne soit gaspillé.

Les équipes SaaS utilisent CAPI pour diffuser des événements SQL. Les boutiques e-commerce transmettent le revenu net. Les marketeurs B2B synchronisent les données de webinaires et de salons. Pour l'automatisation du funnel de vente et l'optimisation des campagnes sur LinkedIn, consultez le LinkedIn Automated Marketing Funnel: Sales Funnel Automation Guide.

Comment fonctionne LinkedIn Conversions API

Côté client vs côté serveur :

• Pixel : le navigateur collecte les données de clic/vue ; sensible aux bloqueurs.
• API : votre serveur envoie un POST JSON à l'endpoint /rest/conversionEvents de LinkedIn en utilisant un access token OAuth2 (avec les scopes rw_conversions et r_ads) et quatre en-têtes obligatoires : Authorization: Bearer {token}, X-Restli-Protocol-Version: 2.0.0, LinkedIn-Version: {yyyymm} et Content-Type: application/json.

Les événements de conversion doivent comporter un horodatage conversionHappenedAt datant de moins de 90 jours. Les fenêtres de rétrospective d'attribution peuvent être configurées à 1, 7, 30 ou 90 jours ; les fenêtres de 365 jours sont disponibles pour les types de conversion Lead, Qualified Lead, Purchase, Submit Application et Add to Cart.

Configuration étape par étape

1. Créer une règle de conversion — dans Campaign Manager, allez dans Measurement → Conversion tracking → Create conversion → Conversions API. Nommez la règle, choisissez un type de conversion (Lead, Purchase, Sign Up, etc.), définissez une méthode de valeur (dynamique, fixe ou aucune) et configurez les fenêtres d'attribution.
2. Choisir un chemin d'intégration — connectez-vous via un partenaire (Adobe, HubSpot, Google Tag Manager, Zapier, Segment, Tealium, entre autres) ou construisez une intégration directe avec la REST API de LinkedIn. Les configurations partenaires sont généralement ponctuelles ; les intégrations directes prennent en moyenne 2 à 4 semaines et offrent un contrôle total sur le payload.
3. Générer un access token OAuth2 — votre application a besoin des scopes rw_conversions et r_ads. Le propriétaire du token doit détenir un rôle Account Manager, Campaign Manager ou Billing Admin sur le compte publicitaire.
4. Associer les campagnes — attachez la règle de conversion à chaque campagne devant recevoir le crédit. Utilisez autoAssociationType=ALL_CAMPAIGNS lors de la création de la règle, ou associez manuellement via PUT /rest/campaignConversions.
5. Diffuser les événements — envoyez chaque conversion en POST à /rest/conversionEvents avec l'URN de conversion, un horodatage en millisecondes, au moins un identifiant utilisateur et un eventId optionnel pour la déduplication.

Clés de correspondance utilisateur

LinkedIn résout les événements vers les membres en utilisant les identifiants que vous envoyez dans le tableau userIds :

• SHA256_EMAIL — email en minuscules, nettoyé des espaces et haché en SHA-256.
• LINKEDIN_FIRST_PARTY_ADS_TRACKING_UUID — le paramètre de clic li_fat_id capturé lorsque le suivi amélioré des conversions est activé.
• ACXIOM_ID — graphe d'identité LiveRamp.
• ORACLE_MOAT_ID — graphe d'identité Oracle MOAT.
• Si aucun des éléments ci-dessus n'est disponible, envoyez firstName + lastName (et éventuellement companyName, title, countryCode) dans l'objet userInfo.

L'envoi de plusieurs identifiants par événement augmente les taux de correspondance. Seuls les événements appariés comptent pour l'attribution et l'optimisation.

Types de conversion pris en charge

LinkedIn accepte plus de 30 types de conversion, notamment Add to Cart, Download, Install, Key Page View, Lead, Purchase, Sign Up, Start Checkout, Subscribe, Qualified Lead, Submit Application, Phone Call, Book Appointment, Request Quote, entre autres. La liste complète est documentée dans la référence Marketing API.

Déduplication

Si vous utilisez à la fois l'Insight Tag et CAPI, LinkedIn peut dédupliquer automatiquement. Transmettez la même chaîne eventId avec l'événement côté client et l'événement côté serveur afin que LinkedIn reconnaisse le doublon et ne le comptabilise qu'une seule fois.

Limites de débit

• 600 requêtes par minute par token.
• 300 000 requêtes par jour par token.
• L'endpoint batch accepte jusqu'à 5 000 événements en un seul POST (utilisez l'en-tête X-RestLi-Method: BATCH_CREATE).

Bonnes pratiques

• Envoyez les événements en temps réel. Les données retardées peuvent dépasser la fenêtre d'attribution ou manquer le cycle d'optimisation.
• Incluez autant de paramètres de correspondance que possible. Plus d'identifiants signifie des taux de correspondance plus élevés et une meilleure qualité de signal.
• Activez le suivi first-party amélioré dans Campaign Manager pour que LinkedIn ajoute li_fat_id aux URL de vos pages de destination. Capturez et transmettez cet UUID avec chaque événement de conversion.
• Définissez des fenêtres d'attribution larges. LinkedIn recommande 90 jours clic / 90 jours vue pour les conversions lead et bas de funnel. Pour les cycles de vente B2B longs, utilisez la fenêtre de 365 jours sur les types Lead, Qualified Lead, Purchase, Submit Application et Add to Cart.
• Attribuez des valeurs de conversion. Même des valeurs de remplacement statiques permettent à Campaign Manager de calculer le ROAS et de faire ressortir les audiences à forte valeur.
• Associez les conversions à toutes les campagnes pertinentes. Les campagnes non associées ne peuvent pas recevoir de crédit d'attribution.
• Utilisez les requêtes batch pour les chargements en masse. Migrer des données CRM historiques ou synchroniser des exports nocturnes est plus rapide et plus fiable par lots de 5 000 événements maximum.
• Surveillez la page Conversion Tracking dans Campaign Manager pour les alertes de statut et vérifiez que les événements arrivent et sont appariés.

Astuces bonus

• Combinez CAPI avec l'Insight Tag plutôt que de le remplacer. Les signaux redondants comblent les lacunes lorsqu'un canal perd des événements, et LinkedIn déduplique automatiquement.
• Utilisez le conteneur server-side de Google Tag Manager pour transmettre les événements web à CAPI sans écrire de code personnalisé — LinkedIn fournit un template GTM officiel.
• Partagez les règles de conversion éprouvées entre les comptes publicitaires via Business Manager pour que chaque équipe utilise le même cadre de mesure.
• Hachez les emails sur votre serveur avant qu'ils ne quittent votre réseau. Le pré-hachage empêche les PII brutes de circuler dans les logs et en transit.
• Renouvelez votre token OAuth avant qu'il n'expire. Un token expiré supprime silencieusement les événements jusqu'à ce que quelqu'un remarque le trou dans Campaign Manager.
• Testez votre payload avec l'outil Payload Builder de LinkedIn sur linkedin.com/developers/payload-builder avant la mise en production.