LinkedIn Ads
Updated:
LinkedIn Ads API : guide complet pour développeurs
Sébastien Castelli
Expert LinkedIn Ads pour services B2B >10K€
La LinkedIn Ads API est l'outil qui permet aux équipes techniques et marketing d'automatiser la gestion des campagnes, d'envoyer des données de conversion directement à LinkedIn et de récupérer des rapports publicitaires sans passer par Campaign Manager. Si vous gérez plusieurs comptes ou des budgets importants, c'est une brique technique qui change le niveau de contrôle sur vos campagnes.
Ce guide couvre tout ce qu'il faut savoir : accès à la marketing developer platform, configuration de l'API des conversions, récupération des données de campagne via l'advertising API, et cas d'utilisation concrets que j'ai rencontrés sur des comptes clients B2B. L'objectif : que vous sachiez exactement par où commencer et quoi éviter.
Points clés
L'accès à la LinkedIn Ads API passe par le LinkedIn Developer Portal, créer une application et demander les bons produits API est la première étape
La LinkedIn Marketing API couvre trois périmètres distincts : campaign management, advertising API et API des conversions
L'API des conversions permet d'envoyer des données de conversion côté serveur, indépendamment des restrictions cookies
Pour récupérer les données de campagne, chaque API request utilise OAuth 2.0 et des query parameters spécifiques
Chaque intégration passe par une revue manuelle de LinkedIn avant accès production
Les cas d'utilisation principaux en B2B : reporting multi-comptes, tracking offline, synchronisation CRM et audiences automatisées
Les trois produits de la LinkedIn Marketing API
La LinkedIn Marketing API n'est pas un seul endpoint. C'est un ensemble de produits regroupés sur la marketing developer platform, chacun avec ses propres permissions et ses propres cas d'utilisation.
Les trois produits principaux :
Campaign Management API : créer, lire, modifier et supprimer des campagnes, groupes de campagnes et publicités via des API requests. Utile pour les équipes qui gèrent des dizaines de comptes ou qui veulent automatiser la création de campagnes depuis un catalogue.
Advertising API : récupérer les métriques de performance, les statistiques d'audience et les données de reporting. C'est l'équivalent programmatique de l'onglet Reporting dans Campaign Manager, avec une granularité temporelle configurable et un accès aux données démographiques professionnelles (professional demographic).
API des conversions : envoyer les données de conversion depuis votre serveur ou CRM directement vers LinkedIn, sans dépendre du cookie de l'Insight Tag. C'est le cas d'utilisation le plus demandé aujourd'hui.
Un quatrième produit existe, le Community Management API, mais il couvre la gestion des pages entreprise et des posts organiques, pas la partie advertising.
Avant de choisir quel produit intégrer, clarifiez votre use case : si c'est du reporting automatisé, c'est l'advertising API. Si c'est du tracking offline ou CRM, c'est l'API des conversions. Les deux ne se confondent pas.
Accéder à la LinkedIn Ads API : créer une application sur le Developer Portal
L'accès commence sur le LinkedIn Developer Portal. Voici la procédure concrète pour tout marketer B2B qui souhaite utiliser l'API :
Rendez-vous sur developer.linkedin.com et connectez-vous avec votre compte LinkedIn
Cliquez sur "Create an app" et renseignez le nom de l'application, la page entreprise associée et l'URL de votre politique de confidentialité (privacy policy, obligatoire)
Une fois l'application créée, allez dans l'onglet "Products" et soumettez un request form pour les produits Marketing API dont vous avez besoin
LinkedIn envoie une demande de review au technical support, délai habituel : 1 à 5 jours ouvrés
Une fois approuvé, vous récupérez vos credentials OAuth 2.0 (client ID + client secret) pour authentifier vos API requests
L'accès development est accordé rapidement. L'accès production (avec des rate limits plus élevées) nécessite une validation supplémentaire basée sur votre use case.
Pour la plupart des intégrations B2B
tracking offline, reporting automatisé
l'accès development est suffisant pour démarrer et learn les subtilités de l'API
.
Un détail pratique : si vous gérez plusieurs comptes clients, utilisez le Business Manager LinkedIn pour centraliser les accès. Ça simplifie la gestion des tokens et des autorisations entre comptes. Le Business Manager permet aussi de créer des partenaires de service et de gérer les permissions API de manière granulaire.
L'API des conversions : fonctionnement et mise en œuvre
C'est le produit qui suscite le plus d'intérêt. L'API des conversions LinkedIn permet d'envoyer les données de conversion directement depuis votre serveur vers LinkedIn, sans que l'Insight Tag (côté navigateur) soit impliqué. Le cas typique en B2B : un prospect clique sur une publicité LinkedIn, prend un rendez-vous, et devient client trois mois plus tard dans votre CRM. Avec l'API des conversions, vous envoyez cet événement à LinkedIn le jour où le deal se ferme, même si le cookie est expiré ou bloqué.
Deux méthodes de mise en œuvre :
Via Campaign Manager : pour les équipes sans ressources dev, LinkedIn propose une interface pour configurer une intégration directement dans Campaign Manager. Vous sélectionnez l'API des conversions comme source, vous créez une règle de conversion, et vous obtenez un api endpoint à appeler depuis votre outil marketing.
Via API request directe : vous envoyez les données de conversion à l'aide d'un appel HTTP vers l'API URL de LinkedIn, avec le LI-FAT-ID (identifiant de clic LinkedIn) pour relier le clic publicitaire à la conversion côté serveur.
La valeur de conversion, la catégorie de l'événement (lead, achat, opportunité) et l'horodatage sont les champs clés dans chaque envoi. Pour faire le lien entre clic et conversion, incluez le LI-FAT-ID dans l'URL de destination de vos publicités dès le départ. C'est ce paramètre qui permet d'attribuer la conversion à la bonne campagne.
Authentification OAuth et structure des requêtes API
La LinkedIn Ads API utilise OAuth 2.0 pour l'authentification. Chaque API request doit inclure un Bearer token dans le header HTTP. Ce token est obtenu via le flux Authorization Code (pour agir au nom d'un utilisateur) ou Client Credentials (pour les intégrations serveur-à-serveur automatisées).
Structure d'un sample request pour récupérer les données d'une campagne :
Endpoint :
https://api.linkedin.com/rest/adCampaignsHeader Authorization :
Bearer {votre_token}Query parameters :
q=search&search.account.values[0]=urn:li:sponsoredAccount:{ACCOUNT_ID}Header version :
LinkedIn-Version: 202401
Un point souvent raté : LinkedIn impose de spécifier la version de l'API dans chaque requête via le header LinkedIn-Version. Sans ça, vous obtenez des erreurs 400 qui ne sont pas toujours explicites. La documentation Microsoft Learn détaille les versions disponibles et les changements entre chaque release.
Pour tester un sample request avant d'intégrer dans votre code, la developer documentation LinkedIn propose des exemples de requêtes avec sample response directement dans l'interface, pratique pour valider l'accès sans coder.
Récupérer les données de campagne via l'Advertising API
L'advertising API permet de récupérer les métriques de performance par campagne, par publicité ou par profil démographique. C'est la base de tout système de reporting automatisé sur LinkedIn Ads, et le point d'entrée pour build des tableaux de bord qui agrègent la data de plusieurs comptes.
Les ressources principales :
adCampaigns : retrieve la liste des campagnes avec statut, budget et objectifs
adCampaignGroups : récupérer l'organisation des groupes de campagnes
adAnalytics : les métriques de performance (impressions, clics, conversions, coût) avec granularité temporelle configurable via query parameters
adCreatives : données sur les publicités, identifiants, statuts, métriques par creative
Pour les données démographiques professionnelles (professional demographic), LinkedIn Ads expose des agrégats par tranche d'âge, secteur, taille d'entreprise et fonction, sans données individuelles. Ces données sont accessibles via l'API de reporting avec des query parameters dédiés. Pour les marketers B2B, c'est utile pour analyser quelle audience réelle a vu vos publicités et ajuster le ciblage.
La fréquence de rafraîchissement des données via l'API est généralement de 3 heures. Ne comptez pas sur l'API pour du temps réel. Campaign Manager lui-même a ce délai. Pour les rapports quotidiens automatisés, planifier les appels API le matin pour les données de la veille est la pratique standard.
Cas d'utilisation concrets de la LinkedIn Marketing API en B2B
Voici les use cases que je rencontre le plus souvent chez des clients B2B qui cherchent à exploiter la LinkedIn Ads API :
Reporting centralisé multi-comptes
Quand vous gérez 5 à 15 comptes LinkedIn Ads clients, aller chercher les données manuellement dans Campaign Manager n'est pas scalable. L'API permet d'agréger automatiquement les métriques dans un Google Sheets ou un dashboard, avec une logique de query parameters pour filtrer par compte, période et objectif de campagne. C'est le cas d'usage le plus simple à implement et qui apporte de la valeur immédiatement.
Tracking de conversions offline
Le use case typique des services B2B à long cycle de vente. Un prospect clique sur une publicité LinkedIn, prend un RDV, et devient client six mois plus tard. Avec l'API des conversions, vous envoyez cet événement à LinkedIn depuis votre CRM le jour où le deal se ferme. LinkedIn peut alors optimiser vers des profils similaires aux vrais clients. Pas de juste aux leads de formulaire. Pour les agences qui gèrent des clients avec des cycles de vente longs, c'est un argument fort pour prouver le ROI des campagnes.
Création automatisée de campagnes
Pour les organisations avec des offres qui se renouvèlent régulièrement (recrutement, events, promotions saisonnières), la Campaign Management API permet de créer et manage des campagnes et publicités en masse via des API requests automatisées, sans passer par l'interface Campaign Manager.
Synchronisation CRM pour audiences de retargeting
Via l'API, vous pouvez mettre à jour vos listes d'audiences LinkedIn directement depuis votre CRM. Un contact qui passe en statut "SQL" dans HubSpot déclenche automatiquement son ajout à une audience LinkedIn pour une campagne de conversion ciblée. C'est une forme d'ABM programmatique qui ne nécessite pas de solution tier payante.
Limites techniques et points d'attention
La LinkedIn Ads API a des contraintes à connaître avant de se lancer dans une intégration :
Rate limits : en accès standard, LinkedIn impose des limites de requêtes par jour et par heure. Pour la plupart des use cases de reporting ou d'envoi de données de conversion, ces limites ne posent pas de problème. Elles deviennent contraignantes uniquement pour des volumes très élevés, création de milliers de campagnes ou envoi en masse de données de conversion en temps réel.
Revue de l'application : chaque application qui demande l'accès aux produits Marketing API passe par une review manuelle de LinkedIn. Il faut l'anticiper dans votre planning. Un request form clair, avec une description précise du use case, accélère le processus.
Versioning strict : LinkedIn fait évoluer son API régulièrement. Chaque version est maintenue pendant 12 à 24 mois avant dépréciation. Intégrer un système de mise à jour du header LinkedIn-Version dans votre code dès le départ vous évitera des coupures imprévues.
Délai de traitement des conversions : quand vous envoyez des données de conversion via l'API des conversions, LinkedIn les traite avec un délai pouvant aller jusqu'à 24-48 heures avant qu'elles apparaissent dans Campaign Manager. Ne vous attendez pas à une remontée instantanée dans vos rapports publicitaires.
Ce que l'API LinkedIn Ads change concrètement pour les équipes B2B
La LinkedIn Ads API n'est pas réservée aux grandes entreprises avec des équipes dev dédiées. Un consultant Ads ou un Growth Manager à l'aise techniquement peut configurer une intégration de l'API des conversions en quelques heures. La documentation LinkedIn sur la marketing developer platform est précise, le technical support est disponible, et les outils comme HubSpot ou Zapier proposent des connecteurs pré-construits pour les use cases les plus courants.
Ce qui change concrètement : vous sortez du tracking purement côté navigateur pour avoir une vision complète du parcours de conversion, y compris les deals qui se closent des mois après le premier clic sur une publicité LinkedIn. Pour des services B2B à tickets élevés, cette donnée est ce qui permet de prouver le ROI réel des campagnes LinkedIn Ads à un C-level sceptique.
Si vous voulez aller plus loin dans la mise en place d'un tracking LinkedIn Ads complet, de l'Insight Tag à l'API des conversions en passant par l'intégration CRM. C'est l'un des modules centraux de la LinkedIn Ads Academy. Tout est détaillé étape par étape, avec des exemples réels sur des comptes clients.
Expert LinkedIn Ads pour services B2B >10K€
Sébastien Castelli
Consultant LinkedIn Ads spécialisé dans les services B2B à haute valeur. Il accompagne des consultants et agences à générer des leads qualifiés via LinkedIn Ads.
Vous avez aimé cet article?
Partagez-le avec vos collègues ou amis !
Rejoignez la LinkedIn Ads Academy
Maîtrisez LinkedIn Ads et générez des leads B2B qualifiés.
Découvrir la formation →
