Tutoriel
Audit pixel Meta et CAPI : grille et script Python
Audit du pixel Meta et de la Conversions API : déduplication, qualité des données, consentement, et script Python sur un export synthétique.
Dans ce tutoriel
Auditer le pixel Meta et la Conversions API revient à vérifier trois choses : chaque conversion arrive une seule fois, elle transporte assez de données pour être associée à un compte, et rien ne part avant le consentement. Les deux premières se lisent dans Events Manager, la troisième se teste dans le navigateur. Ce tutoriel ajoute un script Python qui compare un export d’événements navigateur et serveur, et signale les paires cassées.
Le script tourne sur un export synthétique et fictif, pas sur un site client. Pour la mise en place complète de la CAPI, voir le consultant Meta CAPI ; ici, on audite un dispositif qui existe déjà. L’audit s’inscrit dans l’audit de tracking et suit la même logique que l’audit d’un conteneur GTM : une grille de contrôles, puis un script qui les applique.
Avant de commencer
- Accès en lecture à Events Manager sur le jeu de données du pixel
- Un export d'événements navigateur et serveur de la même période, au format de l'exemple
- Python 3 sur le poste : le script n'utilise que la bibliothèque standard
Ce que l’audit doit prouver
Je lis le dispositif sous quatre angles. Ils se recoupent, et chacun laisse un symptôme différent dans Events Manager ou dans l’export.
Les quatre angles se contrôlent dans cet ordre : d'abord la déduplication, puis les données, les volumes et le consentement.
Ce que Meta documente
Les règles ci-dessous viennent des pages développeurs de Meta que j’ai ouvertes pour cet article. Je ne reprends que ce qu’elles disent.
| Point | Ce que dit Meta | Ce que l’audit vérifie |
|---|---|---|
| Déduplication | Le eventID du pixel doit correspondre au event_id de la CAPI, et le event du pixel au event_name de la CAPI (déduplication pixel et serveur). | Même identifiant et même nom des deux côtés. |
| Fenêtre | Les événements sont dédupliqués dans les 48 heures suivant la réception du premier événement avec ce event_id (même page). | Écart entre les deux copies. |
| Identifiants | Meta recommande d’inclure event_id et external_id pour tous les événements (bonnes pratiques). | Présence sur chaque ligne. |
| Données client | em, ph, fn, ln, ct, zp, country doivent être hachés. fbc, fbp et client_ip_address ne se hachent pas. Pour l’e-mail : espaces retirés, tout en minuscules (paramètres client). | Valeur hachée, et normalisée avant hachage. |
| fbc | Format fb.<version>.<subdomainIndex>.<creationTime>.<fbclid>, avec creationTime en millisecondes (fbp et fbc). | fbc présent quand un fbclid arrive dans l’URL. |
| EMQ | Score de 1 à 10. Meta vise un score d’au moins 6,0 (vérifier la configuration). | Score par événement dans Events Manager. |
| Délai | Les événements doivent apparaître dans les 20 minutes après l’envoi (vérifier la configuration). | Test avec un achat de test. |
Avant de commencer
Avant de lancer le protocole, vérifiez que vous avez les accès et les exports.
Le protocole
-
Constituer l'export des deux flux
Préparez un fichier JSON au format de l’exemple : une liste
browseret une listeserver. Chaque événement porteevent_name,event_id,timestamp(UTC),fbp,fbcetem, et les événements navigateur portent aussipage_url. Pour une recette, travaillez sur une commande de test, puis sur une période courte.Résultat attendu : un fichier
events.jsonqui respecte le format de l’exemple. -
Lancer le script
Le script ci-dessous est dans la section suivante. Depuis son dossier :
python audit_meta_pixel.py events.jsonRésultat attendu : un bloc par contrôle, avec le nombre de points à relire, puis le total. Un point signalé n’est pas forcément une erreur, il dit où regarder.
-
Lire la déduplication dans Events Manager
Dans Events Manager, ouvrez le jeu de données du pixel et la section de déduplication des événements. Relevez le taux d’événements dédupliqués pour chaque source, le taux d’usage de chaque clé de déduplication et le chevauchement entre les sources. Meta affiche un avertissement quand le taux est trop bas ; si c’est le cas, la solution documentée consiste à ajouter des paramètres de déduplication à l’événement.
Résultat attendu : pour chaque événement clé (achat, lead), une lecture du taux et de la clé utilisée.
-
Vérifier la qualité de correspondance
Dans la même vue, ouvrez le détail de chaque événement clé et notez son score EMQ. Visez 6,0 ou plus, comme le recommande Meta. Si le score est bas, regardez quels paramètres client partent : un e-mail non haché ou un
fbcabsent réduisent la correspondance, et le script les signale.Résultat attendu : un score par événement clé, et la liste des paramètres manquants.
-
Tester le consentement
Ouvrez le site en navigation privée. Refusez le bandeau, parcourez le tunnel d’achat de test, puis observez dans les outils de développement les requêtes vers Meta et les envois côté serveur. Recommencez en acceptant. Notez ce qui part dans chaque cas.
Résultat attendu : un tableau refus / acceptation, avec les envois observés dans chaque cas.
-
Corriger et relancer
Corrigez dans l’ordre de la table de la section suivante. Après chaque correction, exportez de nouveau, relancez le script et comparez le total : il doit baisser sans nouveau type de signal. Si un signal nouveau apparaît, la correction a créé un problème.
Résultat attendu : un total plus bas, et des événements clés dont la déduplication et le score sont stables.
Le script
Le script est en bibliothèque standard, lit un fichier en argument et ne fait aucun appel réseau. Je l’ai écrit pour cet exemple : il ne se connecte ni à Meta ni à votre serveur.
#!/usr/bin/env python3
"""Contrôle d'un export synthétique d'événements navigateur (Pixel) et serveur (CAPI).
Usage : python audit_meta_pixel.py chemin/vers/events.json
Stdlib uniquement, lecture seule, aucun appel réseau.
Format attendu : {"browser": [...], "server": [...]}, chaque événement ayant
event_name, event_id, timestamp (ISO 8601 UTC), fbp, fbc, em, et pour le navigateur page_url.
"""
import json
import re
import sys
from collections import Counter
from datetime import datetime
WINDOW_HOURS = 48
SHA256_RE = re.compile(r"^[a-f0-9]{64}$")
def ts(value):
return datetime.fromisoformat(value.replace("Z", "+00:00"))
def is_hashed(value):
return bool(SHA256_RE.match(value))
def main():
if len(sys.argv) != 2:
print("Usage : python audit_meta_pixel.py events.json")
return 2
sys.stdout.reconfigure(encoding="utf-8")
with open(sys.argv[1], encoding="utf-8") as f:
data = json.load(f)
browser, server = data.get("browser", []), data.get("server", [])
print(f"Événements navigateur : {len(browser)} | serveur : {len(server)}")
findings = {}
# 1. event_id absent, par source
findings["NO_EVENT_ID"] = [
f'{src} | {e["event_name"]} | horodatage {e["timestamp"]}'
for src, events in (("navigateur", browser), ("serveur", server))
for e in events if not e.get("event_id")
]
# 2. Paires : même event_id des deux côtés, nom identique ou non
b_index = {(e["event_id"], e["event_name"]): e for e in browser if e.get("event_id")}
s_index = {(e["event_id"], e["event_name"]): e for e in server if e.get("event_id")}
dedup_ok = sorted(k for k in b_index if k in s_index)
findings["NOT_DEDUPLICATED"] = []
b_ids = {e["event_id"] for e in browser if e.get("event_id")}
s_ids = {e["event_id"] for e in server if e.get("event_id")}
for eid, name in sorted(b_index):
if (eid, name) not in s_index:
if eid in s_ids:
findings["NOT_DEDUPLICATED"].append(
f'{eid} : navigateur « {name} », serveur avec un autre nom (clé non appariée)')
else:
findings["NOT_DEDUPLICATED"].append(
f'{eid} « {name} » : navigateur seul, aucun pendant serveur')
for eid, name in sorted(s_index):
if (eid, name) not in b_index and eid not in b_ids:
findings["NOT_DEDUPLICATED"].append(
f'{eid} « {name} » : serveur seul, aucun pendant navigateur')
# 3. Délai entre copies : à relire si l'écart dépasse la fenêtre de 48 h
findings["WINDOW"] = []
for key in dedup_ok:
gap = abs((ts(s_index[key]["timestamp"]) - ts(b_index[key]["timestamp"])).total_seconds()) / 3600
if gap > WINDOW_HOURS:
findings["WINDOW"].append(f"{key[0]} : écart de {gap:.1f} h")
# 4. Volumes par nom d'événement (repère, pas une règle Meta)
cb, cs = Counter(e["event_name"] for e in browser), Counter(e["event_name"] for e in server)
findings["VOLUME"] = [
f"{n} : navigateur {cb[n]}, serveur {cs.get(n, 0)}"
for n in sorted(set(cb) | set(cs)) if cb[n] != cs.get(n, 0)
]
# 5. fbclid présent dans l'URL mais fbc absent
findings["FBC_MISSING"] = [
f'{e["event_name"]} ({e["event_id"] or "sans id"}) : fbclid dans l\'URL, fbc vide'
for e in browser if "fbclid=" in e.get("page_url", "") and not e.get("fbc")
]
# 6. Données client non hachées ou non normalisées
findings["PII"] = []
for src, events in (("navigateur", browser), ("serveur", server)):
for e in events:
em = e.get("em", "")
if not em:
continue
if not is_hashed(em):
reason = "non hachée"
if em != em.strip() or em != em.lower():
reason += " et non normalisée (espaces ou majuscules avant hachage)"
findings["PII"].append(f'{src} | {e["event_name"]} | em {reason}')
labels = [
("NO_EVENT_ID", "Événements sans event_id"),
("NOT_DEDUPLICATED", "Événements non dédupliqués (clé non appariée)"),
("WINDOW", f"Copies espacées de plus de {WINDOW_HOURS} h"),
("VOLUME", "Écarts de volume navigateur / serveur par événement"),
("FBC_MISSING", "fbc absent alors que fbclid présent"),
("PII", "E-mail non haché ou non normalisé"),
]
total = 0
for code, title in labels:
items = findings[code]
total += len(items)
print(f"\n[{code}] {title} : {len(items)}")
for item in items:
print(f" - {item}")
print(f"\nPaires dédupliquées correctement : {len(dedup_ok)}")
print(f"Total : {total} point(s) à relire. Données synthétiques, un point n'est pas forcément une erreur.")
return 0
if __name__ == "__main__":
sys.exit(main())
Sortie obtenue
Sortie réelle sur l’export synthétique de cette page (events_synthetiques.json, données fictives), exécution du 22 novembre 2026 avec Python 3.14.3 :
Événements navigateur : 9 | serveur : 5
[NO_EVENT_ID] Événements sans event_id : 4
- navigateur | PageView | horodatage 2026-11-18T09:00:00Z
- navigateur | PageView | horodatage 2026-11-18T09:05:00Z
- navigateur | PageView | horodatage 2026-11-18T09:07:00Z
- serveur | Purchase | horodatage 2026-11-18T11:20:03Z
[NOT_DEDUPLICATED] Événements non dédupliqués (clé non appariée) : 3
- atc-55 : navigateur « AddToCart », serveur avec un autre nom (clé non appariée)
- ord-1002 « Purchase » : navigateur seul, aucun pendant serveur
- ord-1003 « Purchase » : navigateur seul, aucun pendant serveur
[WINDOW] Copies espacées de plus de 48 h : 0
[VOLUME] Écarts de volume navigateur / serveur par événement : 4
- AddToCart : navigateur 1, serveur 0
- PageView : navigateur 3, serveur 0
- Purchase : navigateur 4, serveur 3
- addtocart : navigateur 0, serveur 1
[FBC_MISSING] fbc absent alors que fbclid présent : 1
- Lead (lead-9) : fbclid dans l'URL, fbc vide
[PII] E-mail non haché ou non normalisé : 2
- serveur | Purchase | em non hachée et non normalisée (espaces ou majuscules avant hachage)
- serveur | Lead | em non hachée
Paires dédupliquées correctement : 3
Total : 14 point(s) à relire. Données synthétiques, un point n'est pas forcément une erreur.
Lecture de cette sortie : ord-1001, ord-1004 et lead-9 sont dédupliqués. ord-1002 et ord-1003 n’ont pas de pendant serveur complet, et ord-1002 côté serveur n’a pas d’identifiant. AddToCart ne s’apparie pas parce que le serveur envoie addtocart en minuscules. Les e-mails du serveur ne sont pas hachés.
Symptôme, cause, correction
| Ce que le script signale | Cause probable | Correction |
|---|---|---|
Événement sans event_id | Identifiant non transmis à la CAPI, ou jamais généré côté navigateur | Générer un identifiant par action et le transmettre au pixel et à la CAPI |
| Même action, nom différent | Nom d’événement écrit autrement côté serveur | Aligner event_name sur le nom du pixel |
| Navigateur seul | Envoi serveur absent, en échec, ou conditionné au consentement | Lire le journal serveur, puis la condition de consentement |
| Serveur seul | Pixel bloqué, absent, ou refusé au consentement | Mesurer la part refusée avant de conclure |
| Écart de volume | Consentement, bloqueurs, ou relais côté serveur | Expliquer chaque écart, sans forcer l’égalité |
fbc vide avec fbclid présent | fbc non capturé ni transmis | Lire le cookie _fbc, ou le construire au format documenté |
| E-mail non haché, ou avec espaces et majuscules | Hachage absent, ou normalisation oubliée avant hachage | Retirer les espaces, passer en minuscules, puis hacher |
| Copies espacées de plus de 48 h | Événement envoyé tardivement, ou horodatage faux | Vérifier l’horodatage envoyé et le délai du relais |
Limites du script
- Il lit un export, pas l’interface d’Events Manager. Les taux et les scores EMQ se lisent dans Meta, pas dans le script.
- Il ne calcule pas le hachage. Il repère une valeur qui n’a pas la forme d’un SHA-256 hexadécimal, mais il ne recalcule pas l’empreinte à partir de l’e-mail.
- Il ne calcule pas l’EMQ : ce score vient de Meta.
- La déduplication de bout en bout, avec ses cas limites, dépasse cet audit. Ici, elle n’est qu’un point de contrôle.
- Certaines défaillances du relais ne se voient pas dans un export. L’article sur sGTM et IPv6 en décrit une, qu’un fichier d’événements ne montre pas.
Pas suivant
Lancez le script sur un export de test, puis traitez d’abord les paires non dédupliquées et les e-mails non hachés, car ce sont les erreurs qui faussent le plus vite les conversions. Pour le cadre général, la définition de Meta CAPI résume ce qu’elle transmet. Si la liste reste longue après correction, un audit de tracking complet, avec tests de parcours et de consentement, est l’étape suivante. L’audit d’un conteneur GTM couvre le même type de contrôle côté balises.
Sources
- Handling Duplicate Pixel and Conversions API Events, Meta for Developers, lue le 22 novembre 2026.
- Verifying Your Setup, Meta for Developers, lue le 22 novembre 2026.
- Best Practices, Conversions API, Meta for Developers, lue le 22 novembre 2026.
- Customer information parameters, Meta for Developers, lue le 22 novembre 2026.
- fbp and fbc parameters, Meta for Developers, lue le 22 novembre 2026.