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.

Par Ron Kopelman Publié le 22 novembre 2026 ⏱ 1 h Niveau : Intermédiaire
Outils Meta (Pixel / CAPI) Meta (Pixel / CAPI) Google Tag Manager GTM Server-Side Consent Mode v2
Dans ce tutoriel
  1. Ce que l’audit doit prouver
  2. Ce que Meta documente
  3. Avant de commencer
  4. Le protocole
  5. Le script
  6. Sortie obtenue
  7. Symptôme, cause, correction
  8. Limites du script
  9. Pas suivant

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.

Outils concernés Meta (Pixel / CAPI) GTM Server-Side Google Tag Manager consent-mode

Avant de commencer

⏱ 1 h Niveau : Intermédiaire
  • 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.

Quatre contrôles pour le pixel et la CAPI

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.

PointCe que dit MetaCe que l’audit vérifie
DéduplicationLe 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êtreLes é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.
IdentifiantsMeta recommande d’inclure event_id et external_id pour tous les événements (bonnes pratiques).Présence sur chaque ligne.
Données clientem, 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.
fbcFormat fb.<version>.<subdomainIndex>.<creationTime>.<fbclid>, avec creationTime en millisecondes (fbp et fbc).fbc présent quand un fbclid arrive dans l’URL.
EMQScore de 1 à 10. Meta vise un score d’au moins 6,0 (vérifier la configuration).Score par événement dans Events Manager.
DélaiLes é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

  1. Constituer l'export des deux flux10 min

    Préparez un fichier JSON au format de l’exemple : une liste browser et une liste server. Chaque événement porte event_name, event_id, timestamp (UTC), fbp, fbc et em, et les événements navigateur portent aussi page_url. Pour une recette, travaillez sur une commande de test, puis sur une période courte.

    Résultat attendu : un fichier events.json qui respecte le format de l’exemple.

  2. Lancer le script2 min

    Le script ci-dessous est dans la section suivante. Depuis son dossier :

    python audit_meta_pixel.py events.json

    Ré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.

  3. Lire la déduplication dans Events Manager15 min

    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.

  4. Vérifier la qualité de correspondance10 min

    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 fbc absent 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.

  5. Tester le consentement20 min

    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.

  6. Corriger et relancer10 min

    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 signaleCause probableCorrection
Événement sans event_idIdentifiant non transmis à la CAPI, ou jamais généré côté navigateurGénérer un identifiant par action et le transmettre au pixel et à la CAPI
Même action, nom différentNom d’événement écrit autrement côté serveurAligner event_name sur le nom du pixel
Navigateur seulEnvoi serveur absent, en échec, ou conditionné au consentementLire le journal serveur, puis la condition de consentement
Serveur seulPixel bloqué, absent, ou refusé au consentementMesurer la part refusée avant de conclure
Écart de volumeConsentement, bloqueurs, ou relais côté serveurExpliquer chaque écart, sans forcer l’égalité
fbc vide avec fbclid présentfbc non capturé ni transmisLire le cookie _fbc, ou le construire au format documenté
E-mail non haché, ou avec espaces et majusculesHachage absent, ou normalisation oubliée avant hachageRetirer les espaces, passer en minuscules, puis hacher
Copies espacées de plus de 48 hÉvénement envoyé tardivement, ou horodatage fauxVé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

Ron Kopelman

Vous préférez que je le fasse ?

Je mets en place ce tutoriel sur votre site, avec recette et documentation. Cadrage gratuit de 30 minutes.