Communitygithub.com

Configuration du Pixel Meta

Configurez le Pixel Meta (suivi des publicités Facebook/Instagram) sur un site web et déclenchez un événement de conversion (Lead, CompleteRegistration, Purchase) de bout en bout. Guide l'utilisateur via Business Suite / Events Manager, la création ou la recherche de l'ID Pixel/Dataset, l'installation du code de base, le déclenchement d'un événement standard et la vérification avec Meta Pixel Helper avant de lancer des annonces.

Qu'est-ce que Configuration du Pixel Meta ?

Cette compétence pour agent IA guide l'utilisateur pas à pas dans la configuration du Pixel Meta (Facebook/Instagram) sur un site web, depuis la récupération de l'ID Pixel/Dataset jusqu'à la vérification d'un événement de conversion réel. Elle commence par évaluer ce que l'utilisateur a déjà configuré (Page Facebook, Business Suite, ID Pixel existant) pour ne pas recréer ce qui existe déjà. La compétence prend en charge les décisions critiques prédéfinies : elle recommande de commencer par le Pixel navigateur uniquement (plus simple, sans backend) plutôt que la Conversions API (plus lourde, nécessitant des données personnelles), et conseille de ne pas cocher de catégories sensibles (finance, santé) dans le Dataset pour éviter de restreindre les données. Les plateformes supportées incluent tous les sites web (Next.js, HTML, WordPress, Shopify, etc.). Elle se distingue en intégrant des vérifications de sécurité pour les données personnelles (ne pas envoyer d'email/téléphone via le pixel) et en imposant une vérification avec l'extension Meta Pixel Helper ou Events Manager avant de dépenser un budget publicitaire.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ooiyeefei/ccc/tree/HEAD/skills/meta-pixel-setup

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Aperçu

Depuis le README du skill

Configuration du Pixel Meta preview

Documentation

Que fait Configuration du Pixel Meta ?

Obtenez le Pixel Meta qui suit une vraie conversion sur un site web, vérifiée, pour que l'optimisation des publicités Facebook/Instagram ait quelque chose de vrai à apprendre. Deux choses bloquent les gens et cette compétence les aborde en premier : la décision Pixel vs Conversions API (l'assistant Meta pousse agressivement la plus lourde) et quelle catégorie de données déclarer (un mauvais choix peut ralentir vos annonces).

Note de nommage : Meta a renommé "Pixel" en "Dataset" dans l'interface utilisateur. Un dataset contient le pixel et son ID Dataset = ID Pixel (un nombre d'environ 15–16 chiffres). Traitez les deux mots comme la même chose.

Commencez là où l'utilisateur se trouve

La configuration est une chaîne : Page Facebook → Portfolio professionnel → Events Manager → Pixel/Dataset (obtenir l'ID) → code de base sur le site → événement de conversion → vérifier. Les gens arrivent au milieu. Demandez d'abord, puis intervenez directement — ne recréez pas ce qui existe (une entreprise a souvent déjà un pixel ; réutilisez-le plutôt que de fragmenter les données entre deux).

Demandez (adaptez à ce qu'ils ont dit) :

  1. Avez-vous déjà une Page Facebook et Meta Business Suite / Portfolio professionnel ?
  2. Avez-vous déjà un Pixel / Dataset (dans Events Manager) ? Si oui, quel est l'ID Dataset (le nombre d'environ 16 chiffres) ? Collez-le — c'est peut-être tout ce dont vous avez besoin.
  3. Quelle est l'unique conversion qui compte (une soumission de prospect/file d'attente, une inscription, un achat) ? C'est ce vers quoi les publicités optimiseront.
  4. La stack + domaine du site (Next.js, HTML simple, WordPress, Shopify) — cela détermine comment le code est intégré.

S'ils ont déjà l'ID Dataset et une Page, passez directement à l'installation (§3). Ne les ramenez pas à la création de compte qu'ils ont déjà faite.

Décision 1 : Pixel uniquement, ou + Conversions API ? (commencez par Pixel uniquement)

L'assistant de configuration Meta montre "Conversions API et Meta Pixel (Recommandé)" avec une statistique attrayante. Ne l'acceptez pas par réflexe. Voici le compromis honnête :

  • Meta Pixel (navigateur) — un extrait de code sur le site envoie les événements depuis le navigateur du visiteur. Simple, pas de backend, fonctionne aujourd'hui. C'est tout ce dont vous avez besoin pour lancer.
  • Conversions API (CAPI) — votre serveur envoie les événements directement à Meta. C'est serveur-à-serveur, "nécessite un support développeur", et pour être utile, elle a besoin des PII du client (email, téléphone, IP) envoyés à Meta pour l'appariement. Cela signifie plus de développement et une plus grande surface de conformité à la vie privée (RGPD/PDPA/CCPA).

Donc : lancez avec le Pixel navigateur. Ajoutez CAPI plus tard, seulement si la perte de signal du navigateur (bloqueurs de pub, iOS ATT) vous nuit mesurablement et que vous avez résolu la question des PII/consentement. Traitez CAPI comme une optimisation post-lancement, pas comme une étape de configuration. Lisez references/conversions-api.md avant de le câbler — il existe pour vous empêcher d'envoyer accidentellement des données personnelles à Meta.

Décision 2 : la "catégorie" du Dataset — laissez-la vide sauf si elle correspond clairement

Lors de la création du dataset, Meta demande de "sélectionner les catégories applicables." C'est un piège pour les produits financiers/santé/sensibles. La boîte de dialogue prévient : "selon la catégorie et le lieu, le partage des données peut être limité ou bloqué." Les catégories comme "Service financier," "Vulnérabilité économique," "Difficulté personnelle," "Nationalité" déclenchent le traitement restreint des données de Meta et peuvent ralentir ou bloquer votre optimisation publicitaire.

Règle : cochez une catégorie uniquement si elle vous décrit avec précision et inévitablement, et que vous comprenez qu'elle restreint les données. Un outil de budgétisation/productivité/SaaS est un logiciel, pas un "service financier" (cette catégorie est pour les prêteurs, les rapports de crédit, la finance à la consommation). En cas de doute, laissez les catégories vides (c'est facultatif) — vide signifie aucune restriction, ce qui est ce qu'un test normal de file d'attente/inscription souhaite.

1. Créer ou trouver le Pixel/Dataset (obtenir l'ID)

Dans Events Manager :

  1. Rail gauche → Connecter les données (vert +) → Web → Meta Pixel → Connecter. (Ou si un dataset existe, cliquez dessus — l'ID est juste en dessous de son nom.)
  2. Nommez-le d'après l'entreprise (ex. "Acme Web"). Pour la catégorie, voir Décision 2 (généralement laissez vide).
  3. Copiez l'ID Dataset — le nombre d'environ 16 chiffres sous le nom. Également toujours visible plus tard sous Events Manager → Datasets.
  4. Si un assistant "configurer / connecter votre site web" s'ouvre proposant Conversions-API vs Pixel uniquement — vous pouvez le fermer/ignorer. Vous n'avez besoin que de l'ID ; le code s'installe manuellement (§3). Si vous continuez, choisissez Meta Pixel uniquement (Décision 1).

2. (Facultatif) Réutiliser un pixel existant

Un pixel n'est pas un mur de rapports rigide comme une propriété GA4. Un pixel peut couvrir tout un domaine — l'application principale et une page d'atterrissage /waitlist. Distinguez les entonnoirs par l'événement + les paramètres personnalisés (ex. content_name: 'waitlist'), pas par un second pixel. Si l'entreprise en a déjà un, réutilisez son ID.

3. Installer le code de base

Collez dans <head> sur chaque page, en remplaçant YOUR_PIXEL_ID. Il déclenche PageView automatiquement. (Copiez votre extrait exact depuis Events Manager — il a l'ID pré-rempli — ou utilisez cette forme canonique.)

<!-- Meta Pixel Code -->
<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', 'YOUR_PIXEL_ID');
fbq('track', 'PageView');
</script>
<noscript><img height="1" width="1" style="display:none"
  src="https://www.facebook.com/tr?id=YOUR_PIXEL_ID&ev=PageView&noscript=1"/></noscript>
<!-- End Meta Pixel Code -->

N'ajoutez PAS de hash integrity/SRI — fbevents.js est un chargeur versionné que Meta met à jour sur place et ne publie pas de hash stable pour ; le SRI le cassera. L'installation spécifique au framework (Next.js next/script, WordPress, Shopify, GTM) se trouve dans references/install-by-platform.md.

4. Déclencher l'événement de conversion sur l'action

Utilisez un événement standard pour que l'optimisation et le reporting de Meta le reconnaissent — Lead (file d'attente/contact), CompleteRegistration (inscription), Purchase (vente). Liste complète + quand utiliser chacun : references/standard-events.md. Déclenchez-le uniquement après que l'action a vraiment réussi, jamais sur une erreur attrapée.

<script>
form.addEventListener('submit', async function (e) {
  e.preventDefault();
  try {
    await saveTheLead(/* ... */);          // 1. persister D'ABORD — le vrai succès
    if (window.fbq) fbq('track', 'Lead', { // 2. seulement ensuite, le compter (garde pour bloqueurs)
      content_name: 'waitlist',            // paramètres segmentables, NON-PII uniquement
      value_bucket: 'high'
    });
    window.location.href = '/thank-you';
  } catch (err) {
    showError('Quelque chose s'est mal passé, veuillez réessayer.');  // pas d'événement, pas de faux succès
  }
});
</script>

Règle des PII — n'envoyez pas de données personnelles via le Pixel navigateur

Ne passez jamais d'email, téléphone, nom ou adresse comme paramètres d'événement. Envoyez des catégories/seaux (content_name, une bande de valeur, un persona) — assez pour segmenter, pas pour identifier. (Le seul endroit où Meta utilise des PII hachés est l'Appariement avancé de la CAPI, qui est un choix délibéré, consenti et côté serveur — voir references/conversions-api.md, pas quelque chose à ajouter dans des événements navigateur.)

5. Vérifier AVANT de dépenser — la porte

Effectuez une vraie conversion sur le site en direct/aperçu, puis confirmez :

  • Installez l'extension Chrome Meta Pixel Helper. Chargez la page → elle montre le pixel + PageView. Soumettez le formulaire → elle montre l'événement Lead avec vos paramètres.
  • Ou Events Manager → votre dataset → Tester les événements, entrez l'URL du site, et regardez les événements arriver en direct.
  • Ne déclenche qu'en cas de succès : provoquez un échec et confirmez que l'événement NE se déclenche PAS.

Ce n'est qu'après avoir vu l'événement de conversion se déclencher correctement que le budget publicitaire devrait être mis en ligne. Une conversion mal câblée fait optimiser Meta vers les mauvaises personnes et vous ne pouvez pas le voir depuis le tableau de bord. Liste de vérification complète : references/verify-checklist.md.

"Pouvez-vous configurer cela pour moi ?"

La création compte/Page/Business-Suite/Pixel nécessite la propre connexion Meta de l'utilisateur — ne peut pas être faite pour leur compte ; c'est une courte procédure d'interface (cette compétence la guide). Obtenir l'ID Dataset est le seul travail de l'utilisateur. L'assistant peut écrire le code de base + l'événement dans le site une fois qu'il a l'ID. Répartissez-le de cette façon — et éloignez-les de l'assistant CAPI et des catégories sensibles conformément aux deux décisions ci-dessus.

Fichiers de référence

  • references/install-by-platform.md — installation du code de base pour Next.js, HTML, WordPress, Shopify, GTM.
  • references/standard-events.md — noms d'événements standard Meta + paramètres pour les conversions courantes.
  • references/conversions-api.md — qu'est-ce que la CAPI, quand elle vaut le coup, et les garde-fous PII/consentement AVANT de la câbler.
  • references/verify-checklist.md — la porte de vérification pré-dépenses (Pixel Helper, Tester les événements, échecs courants).

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

Skills associés