Installer Walityk sur PrestaShop

Ce guide couvre l’installation de Walityk sur une boutique PrestaShop (1.7, 8.x). L’installation se fait via un snippet à poser dans le <head> du thème — aucun module dédié à installer. Compter 10 minutes.

1. Créer votre site dans le dashboard

1. Ouvrez le dashboard Walityk → Sites → Nouveau site.
2. Renseignez le domaine de votre boutique et choisissez la plateforme PrestaShop.
3. Cliquez Créer le site. L’onglet Installation affiche votre snippet (~10 lignes), avec votre site ID déjà renseigné :

<script>
(function(s,i,e){
  s.__tftq=s.__tftq||[];
  s.__tftq.push(['init',{site_id:i,endpoint:e+'/collect'}]);
  var t=document.createElement('script');
  t.async=true;
  t.src=e+'/tag.js';
  document.head.appendChild(t);
})(window,'VOTRE_SITE_ID','https://tag.walityk.com');
</script>

Si vous avez plusieurs boutiques en multistore sur des domaines différents, créez un site Walityk par domaine.

2. Poser le snippet dans le thème

Deux options, au choix :

Via le template du thème (recommandé)

1. Admin PrestaShop → Apparence → Thème et logo pour identifier votre thème actif.
2. Éditez themes/<votre-theme>/templates/_partials/head.tpl (via FTP ou l’éditeur de votre hébergeur).
3. Collez le snippet juste avant </head> (fin du fichier), enregistrez.
4. Videz le cache : Paramètres avancés → Performances → Vider le cache.

Via un module d’insertion HTML

Si vous préférez ne pas toucher au thème, tout module gratuit d’insertion de code (« Custom JS/HTML ») posant du code dans le hook displayHeader fait l’affaire : collez-y le snippet.

Le snippet est non-bloquant (async) : aucun impact sur la vitesse de la boutique.

3. Activer l’auto-détection e-commerce

Sur la page de votre site dans le dashboard, activez Auto-détection e-commerce. Le tag infère les events depuis les données structurées que PrestaShop émet nativement (JSON-LD / Open Graph) et les boutons standard :

• view_item sur les fiches produit
• add_to_cart au clic sur « Ajouter au panier »
• begin_checkout à l’arrivée sur le tunnel (/commande, /checkout)
• purchase sur la page de confirmation de commande

C’est une heuristique : après activation, vérifiez dans les events live que les 4 events remontent bien sur votre thème (thèmes officiels Classic et Hummingbird reconnus ; un thème très personnalisé peut nécessiter un event manuel — voir dépannage). Le tag émet aussi page_view, les jalons de scroll, les clics sortants et form_submit automatiquement.

4. Connecter ses destinations

Sur Destinations dans le dashboard Walityk :

• GA4 : Measurement ID + API secret.
• Meta CAPI : Pixel ID + token Conversions API.
• Google Ads : connectez votre compte si vous diffusez du SEA.

5. Vérifier que les events arrivent

1. Dans le dashboard, ouvrez la page de votre site → Voir les events live.
2. Naviguez sur votre boutique : home, fiche produit, add to cart, checkout.
3. Vérifiez côté Meta Events Manager → Test events et GA4 → Realtime.

Ça ne marche pas ?

• Aucun event : videz le cache PrestaShop (Paramètres avancés → Performances → Vider le cache) puis vérifiez dans le code source de la page que le snippet est bien présent dans le <head>. Ouvrez DevTools → Network et cherchez tag.walityk.com.
• Requête /collect bloquée par CORS : le domaine de la boutique ne correspond pas au domaine déclaré dans le dashboard — corrigez-le.
• purchase manquant : certains tunnels personnalisés ne sont pas reconnus par l’heuristique. Poussez l’event manuellement sur la page de confirmation : __tftq.push(['track', 'purchase', { value: 49.00, currency: 'EUR', transaction_id: 'CMD-1234' }]).

Compatibilité

• ✅ PrestaShop 1.7.6+, 8.x
• ✅ Thèmes officiels (Classic, Hummingbird) pour l’auto-détection e-commerce
• ✅ Multistore (un site Walityk par domaine)
• ⚠️ PrestaShop 1.6 : le snippet fonctionne, mais l’auto-détection n’est pas garantie — prévoyez des events manuels

Besoin d’aide ? hi@walityk.com.