Installer le pixel Meta sur une boutique Qweekle V3
Le module Meta livré par Qweekle apporte le pixel, les quatre événements de parcours et l'Advanced Matching alimenté par l'email déjà haché. Un réglage mérite l'attention : la boutique étant une application monopage, la détection automatique de changement d'URL doit être désactivée.
Version 3 — la version actuelle. Vous êtes concerné si votre boutique est sur une adresse en .qweekle.shop.
Le module Meta livré par Qweekle apporte le pixel, les quatre événements de parcours et l'Advanced Matching alimenté par l'email déjà haché. Un réglage mérite l'attention : la boutique étant une application monopage, la détection automatique de changement d'URL doit être désactivée.
Avant de commencer
- Le module Base est importé et le Consent Mode est branché.
- Un identifiant de pixel Meta à 15 ou 16 chiffres.
Les variables à créer
000000000000000user.email_sha256Alimente l'Advanced Matching. Le hash est fourni par Qweekle, il n'y a rien à calculer.
ecommerce.transaction_idSert d'identifiant d'événement pour la déduplication avec l'API de conversions.
Les déclencheurs
toutes les pagesview_itemadd_to_cartbegin_checkoutpurchaseLes balises
Les noms suivent la convention que nous utilisons en production : le rôle de la balise se lit d'un coup d'œil dans la liste, même après plusieurs années.
Module à importer : qweekle-3-meta.json
- Prérequis
- qweekle-1-base.json déjà importé
- À renseigner
- la constante Meta Pixel ID
[Meta] Pixel Base + PageView
C'est cette balise qui porte le réglage SPA. Vérifiez que la détection automatique de changement d'URL est désactivée, sans quoi chaque navigation compte une vue de page en trop.
[Meta] ViewContent
[Meta] AddToCart
[Meta] InitiateCheckout
[Meta] Purchase
Porte la valeur de commande et l'identifiant de transaction. Ce dernier est ce qui permettra de brancher l'API de conversions sans compter chaque achat deux fois.
Ce qui casse le plus souvent
Laisser la détection automatique d'URL active
La boutique est une application monopage : chaque navigation déclencherait une vue de page supplémentaire. Le module prévoit le réglage, encore faut-il vérifier qu'il est bien en place après l'import.
Poser un second pixel par-dessus le module
Si le pixel était déjà installé avant l'import, vous vous retrouvez avec deux chargements et des événements en double. Faites le ménage avant d'importer.
Ignorer l'Advanced Matching
Qweekle fournit l'email haché prêt à l'emploi. Ne pas le brancher revient à se priver gratuitement de précision sur les audiences comme sur les conversions.
Vérifier que ça fonctionne
- Installer l'extension Meta Pixel Helper et parcourir un achat complet.
- Vérifier que la vue de page n'est envoyée qu'une fois par navigation — c'est le contrôle prioritaire sur une application monopage.
- Contrôler dans le Gestionnaire d'événements que les quatre événements arrivent avec leurs valeurs.
- Vérifier que l'Advanced Matching est bien reçu.
- Contrôler qu'aucune balise ne part avant acceptation du bandeau cookies.
Aucun module n'est fourni sur cette version : tout passe par des balises HTML personnalisées. C'est simple, mais c'est aussi là que les erreurs de valeur et de devise se glissent le plus souvent.
Avant de commencer
- Le conteneur Google Tag Manager du parc est installé sur le site et sur la boutique.
- Un identifiant de pixel Meta à 15 ou 16 chiffres.
- Les variables de couche de données sont créées.
Les variables à créer
ecommerce.valueecommerce.currencyecommerce.transaction_idSert d'identifiant d'événement pour la déduplication.
Les déclencheurs
view_itemadd_to_cartbegin_checkoutpurchaseLes balises
Les noms suivent la convention que nous utilisons en production : le rôle de la balise se lit d'un coup d'œil dans la liste, même après plusieurs années.
Meta Ads | Main Tag
<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_PIXEL_ID');
fbq('set', 'agent', 'tmgoogletagmanager', 'VOTRE_PIXEL_ID');
fbq('track', 'PageView');
</script>Doit se déclencher sur le site du parc comme sur la boutique. Si la balise de socle manque sur la boutique, les événements d'achat disparaissent sans erreur.
Event Meta Ads | Add To Cart
<script>
fbq('track', 'AddToCart', {
value: {{ecommerce.value}},
currency: {{ecommerce.currency}}
});
</script>La valeur et la devise sont indispensables. Sans elles, l'algorithme ne distingue pas un billet à 15 € d'un anniversaire à 300 €.
Event Meta Ads | Initiate Checkout
<script>
fbq('track', 'InitiateCheckout', {
value: {{ecommerce.value}},
currency: {{ecommerce.currency}}
});
</script>Event Meta Ads | Purchase
<script>
fbq('track', 'Purchase', {
value: {{ecommerce.value}},
currency: {{ecommerce.currency}}
}, {
eventID: {{ecommerce.transaction_id}}
});
</script>L'identifiant d'événement permettra d'ajouter l'API de conversions plus tard sans doubler les achats.
Ce qui casse le plus souvent
L'ajout au panier sans valeur
fbq('track', 'AddToCart') sans paramètre est le cas le plus répandu. L'événement remonte, mais sans montant : impossible d'optimiser sur la valeur du panier.
La devise écrite en dur
currency: 'EUR' codé dans la balise au lieu de lire la couche de données. Sans conséquence en France, mais l'incohérence avec GA4 rend les rapprochements impossibles.
L'achat sans identifiant d'événement
Sans eventID, l'ajout ultérieur de l'API de conversions double tous les achats.
Le pixel de socle absent de la boutique
Si la balise de socle ne se déclenche que sur le site du parc, les événements envoyés depuis la boutique n'ont pas de bibliothèque à appeler et disparaissent silencieusement.
Vérifier que ça fonctionne
- Installer l'extension Meta Pixel Helper et parcourir un achat complet.
- Vérifier que le pixel de socle se charge aussi sur les pages de la boutique.
- Contrôler que les trois événements arrivent avec leur valeur et leur devise.
- Vérifier que l'achat porte bien un identifiant d'événement.
Vos conversions ne collent pas avec votre caisse ?
C'est le symptôme le plus courant, et il a presque toujours l'une des causes listées ci-dessus. Nous auditons votre installation et vous disons ce qui se perd, où, et combien ça coûte.