Skip to main
← Sommaire

Installer Walityk sur Shopify en 3 étapes

Guide pas à pas pour installer Walityk sur une boutique Shopify et envoyer ses premiers events vers GA4 et Meta CAPI.

Ce guide couvre l’installation de Walityk sur une boutique Shopify, du premier clic à la vérification des events arrivant chez Meta et GA4. Compter moins de 5 minutes.

1. Installer l’application

  1. Connectez-vous à votre admin Shopify.
  2. Ouvrez l’App Store Shopify et recherchez Walityk.
  3. Cliquez Installer, validez les permissions demandées (write_script_tags pour injecter le tag, write_pixels + read_customer_events pour capter les events commerce et checkout).
  4. Vous êtes redirigé vers le dashboard Walityk avec votre boutique déjà connectée.

Aucune modification de thème n’est nécessaire. Walityk déploie deux briques automatiquement :

  • un tag (page vues, scroll, contexte page) injecté via script_tag ;
  • un Web Pixel qui capte les events commerce et checkout (view_item, add_to_cart, begin_checkout, purchase) — seul moyen de tracker les pages de paiement, où les script_tag ne tournent pas.

Servi en first-party. Le tag et l’endpoint de collecte sont servis depuis votre propre domaine (votre-boutique.com/apps/walityk/…) via l’App Proxy Shopify. Résultat : meilleure résistance aux adblockers, requêtes same-origin (zéro souci CORS), TLS géré par Shopify.

2. Connecter ses destinations marketing

Sur la page Destinations du dashboard :

  • GA4 : cliquez « Connecter », collez votre Measurement ID (G-XXXXXXX) et votre API secret (Admin → Data Streams → Measurement Protocol API secrets).
  • Meta CAPI : ouvrez Meta Events Manager, copiez votre Pixel ID et générez un token Conversions API (Paramètres → API Conversions → Générer un token d’accès). Collez les deux dans Destinations → Meta. Optionnel : un Test Event Code pour vérifier la réception sans polluer vos stats. Aucune app Facebook à créer.

Les clés sont stockées chiffrées au repos côté serveur. Elles ne transitent jamais par le navigateur du client final.

3. Vérifier que les events arrivent

  1. Sur le dashboard, ouvrez l’onglet Live debug.
  2. Dans un autre onglet, naviguez sur votre boutique : page d’accueil, fiche produit, ajout panier.
  3. Vous voyez les events apparaître en temps réel : page_view, view_item, add_to_cart.
  4. Sur Meta Events Manager → Test events, l’événement apparaît dans les 30 secondes.
  5. Sur GA4 → Realtime, les utilisateurs apparaissent immédiatement.

Ça ne marche pas ?

  • Aucun event n’arrive : vérifiez que le tag est bien chargé (DevTools → Network → recherche walityk ou tft). Si absent, le script_tag Shopify n’a pas encore été propagé (compter ≤ 1 min après install).
  • Les events arrivent mais Meta ne les reçoit pas : ouvrez Destinations → Meta et vérifiez le statut. Si le token CAPI a expiré, régénérez-en un dans Events Manager et recollez-le.
  • Doublons d’events côté Meta : assurez-vous d’avoir désactivé le Pixel client-side dans votre thème Shopify (sinon Walityk envoie en CAPI et votre Pixel envoie en client-side → doublons).

Et après ?

  • Configurez le Consent Mode v2 si vous avez une CMP (Cookiebot, Axeptio, Didomi).
  • Activez les conversions Google Ads si vous lancez du SEA.
  • Explorez le plan de marquage visuel pour ajouter vos events custom (newsletter, lead form, etc.).

Besoin d’aide ? Écrivez à hi@walityk.com, on répond sous 24h ouvrées.