Installer le Pixel Meta et configurer l'API Conversions

Comment installer le Pixel Meta sur un site web, configurer les événements standards, mettre en place l'API Conversions (CAPI) avec déduplication et comprendre ce qui a changé pour iOS 14.

Rédigé par
Alexandre PAULRédacteur et éditeur de Kenoby
Publié le
mis à jour le
Lecture
11 min
Sommaire
  1. Le Meta Pixel : fonctionnement et installation
  2. Configurer les événements standards
  3. L'API Conversions (CAPI) : pourquoi et comment
  4. Enrichir les données pour améliorer la qualité de correspondance des événements
  5. iOS 14 et mesure agrégée des événements : ce qui a changé
  6. Vérifier la qualité de votre installation
  7. FAQ Meta Pixel et API Conversions

En bref

Le Pixel Meta est un script qui envoie à Meta les actions des visiteurs de votre site : page vue, lead, achat. L'API Conversions transmet ces mêmes événements depuis votre serveur ou votre CRM. Meta recommande d'utiliser les deux ensemble, avec un identifiant d'événement commun pour ne pas compter deux fois la même conversion.

Le Meta Pixel : fonctionnement et installation

Qu'est-ce que le Meta Pixel ?

Le Pixel Meta est un fragment de code JavaScript qui, une fois installé sur votre site, envoie à Meta des informations sur les actions des visiteurs :

  • Pages consultées
  • Événements de conversion (ajout au panier, lead, achat)
  • Données d'audience pour le retargeting

Chaque Pixel est identifié par un ID de Pixel numérique unique. Dans le Gestionnaire d'événements, Meta parle aussi d'ensemble de données : il regroupe les événements reçus du Pixel et de l'API Conversions.

Créer un Pixel dans Meta Business Manager

  1. Allez sur business.facebook.com > Gestionnaire d'événements
  2. Cliquez sur + Connecter des sources de données > Web
  3. Choisissez "Pixel Meta" > Créer
  4. Nommez votre Pixel et entrez l'URL de votre site
  5. Récupérez l'ID du Pixel

Installer le Pixel via Google Tag Manager (recommandé)

Dans GTM :

  1. Créez une nouvelle balise
  2. Type : cherchez "Meta Pixel" ou "Facebook Pixel" dans la galerie de modèles de la communauté GTM, et vérifiez son éditeur
  3. ID Pixel : entrez votre ID de Pixel
  4. Événement : PageView
  5. Déclencheur : All Pages
  6. Enregistrez et publiez

Si le template Meta n'est pas disponible, utilisez HTML personnalisé :

<script>
!function(f,b,e,v,n,t,s)
{if(f.fbq)return;n=f.fbq=function(){n.callMethod?
n.callMethod.apply(n,arguments):n.queue.push(arguments)};
if(!f._fbq)f._fbq=n;n.push=n;n.loaded=!0;n.version='2.0';
n.queue=[];t=b.createElement(e);t.async=!0;
t.src=v;s=b.getElementsByTagName(e)[0];
s.parentNode.insertBefore(t,s)}(window, document,'script',
'https://connect.facebook.net/en_US/fbevents.js');
fbq('init', 'VOTRE_ID_PIXEL');
fbq('track', 'PageView');
</script>

Vérifier l'installation

Meta Pixel Helper : extension Chrome officielle Meta. Visitez votre site, l'extension affiche les événements Pixel en temps réel avec leur statut (actif, erreur, doublon).

Gestionnaire d'événements : la vue d'ensemble de votre source de données indique si elle reçoit des événements, et depuis quand.

Configurer les événements standards

Les événements standards Meta ont des noms prédéfinis qui alimentent les rapports et l'optimisation. Utilisez ces noms exactement (sensible à la casse). L'événement qui sert à optimiser se choisit ensuite dans l'ensemble de publicités : le guide Meta Ads explique comment régler le lieu de conversion et l'objectif de performance.

Les événements prioritaires à configurer

Pour la génération de leads :

// Sur la page de confirmation / remerciement
fbq('track', 'Lead', {
  content_name: 'Formulaire de contact',
  value: 50,        // valeur estimée du lead
  currency: 'EUR'
});

Pour l'e-commerce :

// Ajout au panier
fbq('track', 'AddToCart', {
  content_ids: ['PROD-123'],
  content_type: 'product',
  value: 29.99,
  currency: 'EUR'
});

// Début du checkout
fbq('track', 'InitiateCheckout');

// Achat confirmé
fbq('track', 'Purchase', {
  value: 99.90,
  currency: 'EUR',
  content_ids: ['PROD-123']
});

Configurer les événements via GTM

Pour déclencher Lead sur la page de remerciement via GTM :

  1. Balise : HTML personnalisé, fbq('track', 'Lead')
  2. Déclencheur : Page vue, URL contient /merci
  3. Publiez

Ou via l'outil de configuration d'événements de Meta :

Dans le Gestionnaire d'événements > votre Pixel > Configurer avec l'outil de configuration des événements. Meta ouvre votre site dans un outil visuel où vous pouvez associer des événements à des clics ou des pages sans code.

L'API Conversions (CAPI) : pourquoi et comment

Pourquoi l'API Conversions est devenue la norme

Le Pixel dépend du navigateur. Les bloqueurs de publicité, les restrictions de Safari et le refus du suivi sur iOS 14.5 et versions ultérieures lui font perdre une partie des événements.

L'API Conversions établit un lien direct entre vos données marketing (serveur, plateforme de site, application ou CRM) et Meta. Meta la présente comme une connexion « plus fiable », qui sert à optimiser le ciblage, à réduire le coût par résultat et à mesurer les résultats (aide Meta Business, API Conversions, consultée le 5 novembre 2026). Elle accepte des événements de site web, d'application, hors ligne et de messagerie.

Deux limites à connaître : le consentement reste obligatoire, que l'événement parte du navigateur ou du serveur, et les événements envoyés par l'API Conversions peuvent eux aussi être traités selon les limites du protocole de mesure agrégée des événements.

Objectif : Pixel + CAPI, avec déduplication

SourceCe qu'elle capteLimites
Pixel seulÉvénements du navigateur, en temps réelPerd les événements bloqués par le navigateur ou les extensions
CAPI seuleÉvénements du serveur, du CRM, hors lignePeut manquer des signaux propres au navigateur, demande un développement ou une intégration
Pixel + CAPILes deux sources, recoupéesExige une déduplication fiable

Meta recommande cette configuration « redondante », Pixel et API Conversions en parallèle (documentation Meta for Developers sur la déduplication, mise à jour le 28 juin 2026).

La déduplication : éviter le double comptage

Quand le Pixel ET l'API Conversions envoient le même événement, Meta doit les reconnaître comme un seul. Sans méthode de déduplication, la conversion risque d'être comptée deux fois.

Méthode recommandée par Meta : l'identifiant eventID du Pixel doit être identique au paramètre event_id de l'API Conversions, et le nom de l'événement doit être le même des deux côtés. Dans le Pixel, eventID est le quatrième argument de l'appel fbq. Quand les deux versions sont équivalentes, Meta retient en général celle reçue en premier. Une seconde méthode s'appuie sur les paramètres fbp ou external_id, envoyés de façon identique par le navigateur et le serveur.

// Côté Pixel (navigateur)
fbq('track', 'Lead', { value: 50, currency: 'EUR' }, { eventID: 'LEAD-ABC123' });
// Côté CAPI (serveur), même event_id et même nom d'événement
{
  "event_name": "Lead",
  "event_id": "LEAD-ABC123",
  "event_time": 1793875200,
  "action_source": "website",
  "event_source_url": "https://www.exemple.fr/merci",
  "user_data": {
    "em": ["hash_sha256_email_utilisateur"],
    "client_ip_address": "203.0.113.10",
    "client_user_agent": "Mozilla/5.0 ..."
  },
  "custom_data": { "value": 50, "currency": "EUR" }
}

Implémenter l'API Conversions

Option 1 : intégration partenaire (Shopify, WooCommerce, WordPress, etc.)

Le Gestionnaire d'événements propose des intégrations avec les principales plateformes de site, sans développement. Vérifiez dans l'intégration que l'API Conversions est bien activée en plus du Pixel, et que la déduplication est gérée.

Option 2 : via GTM server-side

La méthode la plus souple pour les sites sur mesure. Configurez un conteneur GTM server-side (hébergé par exemple chez Stape ou sur Google Cloud) et ajoutez un modèle de balise API Conversions. Les événements envoyés au conteneur serveur sont relayés à Meta.

Voir le guide : Tracking server-side.

Option 3 : développement direct via l'API Meta

Pour les équipes techniques. Les événements s'envoient en POST vers ce point de terminaison :

https://graph.facebook.com/{API_VERSION}/{PIXEL_ID}/events?access_token={TOKEN}

Remplacez {API_VERSION} par la version en cours de l'API Graph (v27.0 dans les exemples de Meta au moment de la mise à jour). Deux règles évitent les erreurs fréquentes : le paramètre action_source est obligatoire, et un événement dont event_time date de plus de 7 jours fait rejeter toute la requête (documentation Meta for Developers, utilisation de l'API Conversions, mise à jour le 17 juillet 2026).

Enrichir les données pour améliorer la qualité de correspondance des événements

La qualité de correspondance des événements (Event Match Quality, EMQ) indique si les informations clientèle envoyées avec vos événements serveur permettent de les rattacher à un compte Meta. Meta calcule une note de 0 à 10 sur les 48 dernières heures de données : envoyez donc vos événements en continu pour garder une note à jour (aide Meta Business, qualité de correspondance des événements, consultée le 5 novembre 2026). Une meilleure correspondance améliore l'attribution et l'optimisation.

Paramètres d'informations clientèle et priorité selon Meta :

ParamètrePriorité selon MetaDisponibilité
E-mail (em)ÉlevéeSouvent collecté
Identifiant de clic (fbc)ÉlevéePrésent si l'utilisateur vient d'une publicité
Numéro de téléphone (ph)MoyenneSi le formulaire demande le téléphone
Identifiant externe (external_id)MoyenneIdentifiant client de votre CRM
Identifiant de navigateur (fbp)MoyenneCookie du Pixel, si consentement
Pays, date de naissanceMoyenneSelon vos formulaires
Prénom, nom, ville, code postalFaibleDans les formulaires complets

Meta ne publie pas de note cible. Suivez les actions recommandées affichées dans le Gestionnaire d'événements et ajoutez les paramètres qui manquent.

Hacher les données : les coordonnées doivent être hachées en SHA-256 avant l'envoi, comme l'exigent les conditions d'utilisation de Meta. Les SDK Business de Meta, la plupart des intégrations et des modèles GTM gèrent ce hachage. N'envoyez aucune donnée sensible.

iOS 14 et mesure agrégée des événements : ce qui a changé

Le protocole de mesure agrégée des événements (AEM) permet à Meta de mesurer, de façon limitée, les conversions web des utilisateurs d'iOS 14.5 ou versions ultérieures. Ses exigences ont été allégées. Selon l'aide Meta Business sur la mesure agrégée des événements (consultée le 5 novembre 2026) :

  • vous n'avez plus à classer 8 événements de conversion par domaine, ni à activer des ensembles de valeurs ;
  • l'onglet dédié du Gestionnaire d'événements a été supprimé ;
  • la vérification du domaine n'est plus nécessaire pour configurer vos événements (elle peut l'être pour d'autres raisons) ;
  • vous n'avez plus à choisir un domaine de conversion en créant une campagne.

Si un ancien tutoriel vous demande de prioriser vos 8 événements, il est périmé.

Vérifier la qualité de votre installation

Dans le Gestionnaire d'événements Meta :

  • Vue d'ensemble : volume d'événements reçus, par source (navigateur ou serveur)
  • Qualité de correspondance : note par type d'événement
  • Déduplication : vérifiez que les événements reçus des deux sources sont bien fusionnés
  • Diagnostics : signale les erreurs de configuration et les paramètres manquants

Outil Test des événements :

Dans le Gestionnaire d'événements > votre source de données > Test des événements. Entrez une URL de test et effectuez les actions sur votre site. Les événements Pixel et CAPI apparaissent en temps réel avec leurs paramètres.

FAQ Meta Pixel et API Conversions

Faut-il un Pixel par domaine ou un seul suffit ?

Un Pixel par activité est la norme. Si vous gérez plusieurs domaines ou plusieurs boutiques distinctes, vous pouvez créer plusieurs Pixels dans votre Gestionnaire d'événements.

Le Pixel Meta est-il soumis au RGPD ?

Oui. Le Pixel collecte des données personnelles (navigation, identifiants). Vous devez obtenir le consentement de l'utilisateur avant de le charger. Utilisez une CMP et chargez le Pixel de façon conditionnelle, ou utilisez sa fonction de consentement. Pour les balises Google, voir notre guide du mode Consentement de Google.

Le Pixel fonctionne-t-il pour les apps mobiles ?

Non. Pour les applications mobiles, Meta utilise le SDK Meta (Facebook SDK), et l'API Conversions accepte aussi les événements d'application. Pour l'attribution mobile multicanale, intégrez un MMP (Mobile Measurement Partner) comme AppsFlyer, Adjust ou Branch.

Quelle est la différence entre l'API Conversions et Enhanced Conversions de Google ?

Les deux renforcent la mesure, mais pour des régies différentes. L'API Conversions envoie des événements à Meta depuis votre serveur. Les conversions améliorées (Enhanced Conversions) de Google envoient des données hachées à Google Ads. Les deux compensent une partie du signal perdu côté navigateur sur leurs régies respectives.

Sources et liens cités

  1. [1]aide Meta Business, API Conversionsfacebook.com
  2. [2]documentation Meta for Developers sur la déduplicationdevelopers.facebook.com
  3. [3]documentation Meta for Developers, utilisation de l'API Conversionsdevelopers.facebook.com
  4. [4]aide Meta Business, qualité de correspondance des événementsfacebook.com
  5. [5]aide Meta Business sur la mesure agrégée des événementsfacebook.com