Skip to main
← Sommaire

Installer Walityk via snippet (Webflow, Wix, Squarespace, autres)

Ajouter le tag Walityk en 1 snippet sur n'importe quel site (Webflow, Wix, Squarespace, Framer, sites custom).

Ce guide couvre l’installation de Walityk via snippet HTML. Compatible avec n’importe quel site qui permet d’éditer le <head> : Webflow, Wix, Squarespace, Framer, Carrd, Ghost, Hugo, Jekyll, ou un site fait main.

Compter 5 minutes.

1. Récupérer votre snippet

  1. Connectez-vous au dashboard Walityk.
  2. Sites → Nouveau site : renseignez votre domaine et choisissez la plateforme Custom (HTML/JS).
  3. Cliquez Créer le site.
  4. L’onglet Installation de la page du site affiche votre snippet, avec votre site ID déjà renseigné. Il ressemble à :
<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>

Le snippet est non-bloquant : il se charge en async après le rendu de la page. Aucun impact sur Core Web Vitals.

Le domaine déclaré autorise vos requêtes (CORS) : le domaine exact et ses sous-domaines sont acceptés automatiquement. Un domaine différent = un autre site à créer.

2. Coller le snippet dans le <head>

Webflow

  1. Project Settings → Custom code → Head code.
  2. Collez le snippet, cliquez Save.
  3. Publiez le site.

Wix

  1. Settings → Custom Code → Add Custom Code.
  2. Collez le snippet, sélectionnez Place Code in: Head, Apply to: All pages.
  3. Cliquez Apply.

Squarespace

  1. Settings → Advanced → Code Injection → Header.
  2. Collez le snippet, cliquez Save.

Framer

  1. Site Settings → General → Custom Code → Start of <head> tag.
  2. Collez, cliquez Save.

Site custom / Ghost / Hugo / Jekyll

Ajoutez le snippet dans votre layout principal, entre <head> et </head>.

3. Ce qui est tracké automatiquement

Dès que le snippet est posé, le tag émet sans configuration :

  • page_view avec contexte complet (page, device, viewport, réseau, performance) ;
  • les jalons de scroll (25/50/75/90 %) ;
  • les clics sortants ;
  • les soumissions de formulaire (form_submit) ;
  • les events de votre dataLayer GTM s’il existe.

Sur un site e-commerce, activez l’auto-détection e-commerce sur la page du site (dashboard) : le tag infère view_item, add_to_cart, begin_checkout et purchase depuis les données structurées (JSON-LD / Open Graph) et les boutons d’ajout au panier.

4. Tracker des conversions (optionnel)

Pour signaler une conversion, poussez un event dans la queue __tftq — l’appel fonctionne que le tag soit déjà chargé ou non. Sur la page de remerciement :

<script>
  window.__tftq = window.__tftq || [];
  __tftq.push(['track', 'purchase', { value: 49.00, currency: 'EUR', transaction_id: 'ORD-1234' }]);
</script>

Pour un formulaire de lead :

<script>
  document.querySelector('#contact-form').addEventListener('submit', function () {
    __tftq.push(['track', 'lead', { source: 'contact-form' }]);
  });
</script>

Types d’events standard : page_view, view_item, add_to_cart, begin_checkout, purchase, sign_up, login, lead. Tout autre nom passe en event custom.

5. Connecter ses destinations

Dans le dashboard Walityk → Destinations :

  • GA4 : Measurement ID + API secret
  • Meta CAPI : Pixel ID + token Conversions API
  • Google Ads : OAuth Google

Les events arrivent automatiquement sur ces destinations sans toucher au snippet.

6. Vérifier

  1. Dans le dashboard, ouvrez la page de votre site → Voir les events live.
  2. Visitez votre site dans un autre onglet.
  3. page_view apparaît en temps réel.
  4. Vérifiez GA4 Realtime et Meta Test events si les destinations sont connectées.

Ça ne marche pas ?

  • Snippet non chargé : ouvrez DevTools → Network, filtrez tag.js ou collect. Si rien, vérifiez que vous avez bien publié les changements (Webflow / Wix / Squarespace gardent un staging).
  • Requête /collect bloquée par CORS : le domaine du site ne correspond pas au domaine déclaré dans le dashboard — corrigez le domaine du site (ou créez un site pour ce domaine).
  • Bloqué par un CSP : ajoutez https://tag.walityk.com à votre Content Security Policy (script-src et connect-src).

Consentement

Par défaut le tag tourne en mode cookieless : aucun cookie, aucun identifiant persistant — pas de bannière nécessaire. Si vous utilisez une CMP (Cookiebot, Axeptio, Didomi…), passez le site en mode bannière : le snippet généré porte alors mode:'banner' et le tag démarre en Consent Mode v2 deny-default, détecte la CMP automatiquement et ne libère les events qu’après le choix du visiteur.

Besoin d’aide ? hi@walityk.com.