Skip to main
← Sommaire

Installer Walityk sur WordPress

Guide pas à pas pour installer le tag Walityk sur WordPress / WooCommerce et envoyer les premiers events vers GA4 et Meta.

Ce guide couvre l’installation de Walityk sur un site WordPress (ou WooCommerce). L’installation se fait via un snippet à coller dans le <head> — aucun plugin dédié à installer. Compter 5 minutes.

1. Créer votre site dans le dashboard

  1. Connectez-vous au dashboard Walityk.
  2. Sites → Nouveau site : renseignez votre domaine et choisissez la plateforme WooCommerce (ou Custom (HTML/JS) pour un WordPress sans boutique).
  3. Cliquez Créer le site. L’onglet Installation affiche votre snippet (~10 lignes), avec votre site ID déjà renseigné.

2. Coller le snippet dans le <head>

Deux options, au choix :

Via un plugin d’insertion de code (recommandé)

  1. Installez un plugin d’insertion type WPCode (ex-Insert Headers and Footers) : Extensions → Ajouter une extension.
  2. Ouvrez Code Snippets → Header & Footer (ou équivalent).
  3. Collez le snippet Walityk dans la zone Header, enregistrez.

Directement dans le thème

Dans un thème enfant, ajoutez dans functions.php :

add_action('wp_head', function () { ?>
<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>
<?php });

Le snippet est non-bloquant (async) : aucun impact sur la vitesse du site. Si vous utilisez un plugin de cache/optimisation (WP Rocket, LiteSpeed…), excluez tag.walityk.com du report/défèrement de JS pour ne pas retarder la collecte.

3. WooCommerce : 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 alors les events depuis les données structurées (JSON-LD / Open Graph) et les boutons WooCommerce standard :

  • view_item sur les fiches produit
  • add_to_cart au clic sur les boutons d’ajout au panier
  • begin_checkout à l’arrivée sur le 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. Le tag émet aussi automatiquement page_view, les jalons de scroll, les clics sortants et form_submit.

4. Connecter ses destinations

Sur la page Destinations du dashboard Walityk :

  • GA4 : collez votre Measurement ID (G-XXXXXXX) et votre Measurement Protocol API secret.
  • Meta CAPI : Pixel ID + token Conversions API.
  • Google Ads : connectez votre compte, sélectionnez les actions de conversion à recevoir.

5. Vérifier que les events arrivent

  1. Dans le dashboard, ouvrez la page de votre site → Voir les events live.
  2. Dans un autre onglet, naviguez sur votre site : page d’accueil, fiche produit, ajout panier.
  3. Vous voyez les events en temps réel.
  4. Vérifiez côté Meta Events Manager → Test events (≤ 30 s) et GA4 → Realtime (immédiat).

Ça ne marche pas ?

  • Aucun event n’arrive : ouvrez DevTools → Network, cherchez une requête vers tag.walityk.com. Si absente, vérifiez que le snippet est bien dans le <head> (Affichage → Code source de la page) et qu’aucun plugin de cache ne l’a supprimé ou déféré.
  • Requête /collect bloquée par CORS : le domaine du site ne correspond pas au domaine déclaré dans le dashboard — corrigez-le.
  • add_to_cart / purchase manquants : l’auto-détection est une heuristique ; certains thèmes très personnalisés ne sont pas reconnus. Poussez l’event manuellement : __tftq.push(['track', 'purchase', { value: 49.00, currency: 'EUR', transaction_id: 'ORD-1234' }]) sur la page de confirmation.
  • Doublons Meta : désactivez votre Pixel client-side (souvent posé via un autre plugin GTM/PixelYourSite). Walityk envoie en CAPI, le pixel doublonne.

Et après ?

  • Par défaut le tag tourne en mode cookieless (aucun cookie, pas de bannière requise). Si vous utilisez Cookiebot, Axeptio ou Didomi, passez le site en mode bannière (Consent Mode v2, CMP auto-détectée).
  • Activez les conversions Google Ads pour vos campagnes SEA.
  • Ajoutez vos events custom (newsletter, lead form) via le plan de marquage.

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