Le script de suivi Flowsery Analytics prend en charge plusieurs attributs data pour personnaliser le comportement du suivi. Ce guide couvre toutes les options de configuration disponibles.
Nouveau sur Flowsery Analytics ?
Commencez par le guide d'installation pour ajouter le script de suivi à votre site web.Attributs du script
ID du site web, data-fl-website-id (requis)
Votre identifiant unique de site web provenant de Flowsery Analytics. C'est le seul attribut requis.
<script
defer
data-fl-website-id="flid_******"
src="https://cdn.flowsery.com/main.js"
></script>Domaine, data-domain (optionnel)
Définit la portée du cookie pour les identifiants de visiteur et de session. Par défaut, sa valeur est location.hostname, donc les sites mono-domaine peuvent l'omettre. Renseignez-le lorsque vous souhaitez qu'un même cookie de visiteur soit partagé entre plusieurs sous-domaines : par exemple, data-domain="example.com" permet à example.com, app.example.com et blog.example.com de partager le même identifiant de visiteur. Sans effet en mode sans cookies.
Suivi des sous-domaines
Flowsery Analytics suit par défaut tous les sous-domaines de votre domaine racine, data-domain contrôle la portée des cookies, pas les noms d'hôte suivis. Par exemple, si votre domaine racine est example.com, Flowsery Analytics fonctionne aussi sur app.example.com, blog.example.com, shop.example.com, etc.Noms d'hôte autorisés, data-allowed-hostnames (facultatif)
Liste de domaines supplémentaires séparés par des virgules pour le suivi inter-domaines.
- Par défaut : Vide (pas de suivi inter-domaines)
- Exemple : app.io,shop.example.com
- Cas d'utilisation : Suivre les utilisateurs à travers différents domaines racines
<script
defer
data-fl-website-id="flid_******"
data-allowed-hostnames="app.io,myapp.org"
src="https://cdn.flowsery.com/main.js"
></script>URL de l'API, data-api (facultatif)
Point de terminaison API personnalisé pour l'envoi des événements. Accepte une URL complète ou un chemin relatif.
- Exemple : https://api.example.com/events ou /custom-events
- Cas d'utilisation : Points de terminaison API personnalisés, proxys d'analyse tiers ou configurations de proxy avancées
Si vous fournissez un chemin relatif, il est ajouté à votre domaine.
Détection automatique du proxy
Flowsery Analytics détecte automatiquement les configurations avec proxy. N'utilisez ceci que si vous avez besoin d'un chemin de point de terminaison personnalisé ou si vous souhaitez envoyer des événements à un serveur complètement différent.Autoriser Localhost: data-local (facultatif)
Activez le suivi sur localhost pour le développement et les tests. Accepte "true" ou "false". Par défaut : false.
Autoriser le protocole File: data-allow-file-protocol (facultatif)
Activez le suivi lors de l'ouverture de fichiers HTML directement dans un navigateur (protocole file://). Accepte "true" ou "false". Par défaut : false.
Mode debug, data-debug (facultatif)
Activez le mode debug pour permettre le suivi dans les iframes. Accepte "true" ou "false". Par défaut : false. Par défaut, Flowsery Analytics ne suit pas dans les iframes pour éviter le suivi en double.
Désactiver la console, data-disable-console (facultatif)
Désactivez toute la journalisation console du tracker Flowsery Analytics. Accepte "true" ou "false". Par défaut : false.
Désactiver les paiements, data-disable-payments (facultatif)
Désactivez le suivi automatique des paiements et l'attribution des revenus à partir des paramètres URL (Stripe session_id, LemonSqueezy order_id, Polar checkout_id). Accepte "true" ou "false". Par défaut : false.
- Cas d'utilisation : Lorsque vous utilisez l'attribution des revenus côté serveur pour éviter les événements de paiement en double
Suivi manuel des paiements
Les appels manuels window.flowsery("payment", { email }) fonctionnent toujours lorsque cette option est activée. Seule la détection automatique à partir des paramètres URL est désactivée.Attributs des éléments HTML
Ces attributs sont ajoutés aux éléments HTML de votre page pour activer le suivi automatique.
Suivi des objectifs, data-fs-goal (facultatif)
Suivez les clics sur n'importe quel élément comme objectif personnalisé. Lettres minuscules, chiffres, tirets bas, tirets uniquement. Max 64 caractères.
<button data-fs-goal="add_to_cart">Add to Cart</button>Paramètres d'objectif, data-fs-goal-* (facultatif)
Ajoutez des paramètres personnalisés aux événements d'objectif. Le nom du paramètre est dérivé du nom de l'attribut (kebab-case, converti en snake_case). Max 10 paramètres par événement. Noms de paramètres : max 64 caractères. Valeurs : max 255 caractères.
<button
data-fs-goal="product_added"
data-fs-goal-product-id="prod_123"
data-fs-goal-product-name="Premium Plan"
data-fs-goal-price="49">
Add to Cart
</button>Suivi du défilement, data-fs-scroll (facultatif)
Suivez automatiquement quand un élément devient visible lors du défilement. Déclencheur par défaut : l'élément est visible à 50%. Mêmes règles de nommage que data-fs-goal.
<section data-fs-scroll="viewed_pricing">
<h2>Pricing</h2>
</section>Seuil de défilement, data-fs-scroll-threshold (facultatif)
Personnalisez le seuil de visibilité pour le suivi du défilement. Nombre décimal entre 0 et 1. Par défaut : 0.5 (50% de l'élément visible). Valeurs courantes : 0.1 (10%), 0.5 (50%), 0.9 (90%), 1.0 (100%).
Délai de défilement, data-fs-scroll-delay (facultatif)
Ajoutez un délai en millisecondes avant que l'événement de défilement ne soit suivi. Par défaut : 0 (pas de délai).
<section
data-fs-scroll="read_testimonials"
data-fs-scroll-threshold="0.7"
data-fs-scroll-delay="3000">
<!-- Tracks only if element stays visible for 3 seconds -->
</section>Paramètres de défilement, data-fs-scroll-*
Ajoutez des paramètres personnalisés aux événements de suivi du défilement, similaires à data-fs-goal-*.
Exemples de configuration courants
Environnement de développement
<script
defer
data-fl-website-id="flid_******"
data-local="true"
src="https://cdn.flowsery.com/main.js"
></script>Production avec proxy
<script
defer
data-fl-website-id="flid_******"
src="/js/main.js"
></script>Flowsery Analytics détecte automatiquement les configurations proxy. Aucune API de données n'est nécessaire si vous proxy à la fois /js/main.js et /api/track.
Suivi inter-domaines
<script
defer
data-fl-website-id="flid_******"
data-domain="example.com"
data-allowed-hostnames="app.io,shop.example.net"
src="https://cdn.flowsery.com/main.js"
></script>Utilisez la même configuration sur tous les domaines suivis.
Suivi de la navigation par hash
Pour les applications monopage avec routage par hash :
<script
defer
data-fl-website-id="flid_******"
src="https://cdn.flowsery.com/main.hash.js"
></script>Résumé des règles de validation
Noms d'objectifs et d'événements
- Caractères : Lettres minuscules, chiffres, tirets bas (_), tirets (-)
- Longueur : Maximum 64 caractères
Noms de paramètres personnalisés
- Caractères : Lettres minuscules, chiffres, tirets bas (_), tirets (-)
- Longueur : Maximum 64 caractères
- Conversion : les attributs kebab-case sont automatiquement convertis en snake_case
Valeurs de paramètres personnalisés
- Longueur : Maximum 255 caractères
- HTML/XSS : Les caractères dangereux sont automatiquement assainis
- Limite : Maximum 10 paramètres personnalisés par événement
Seuil de défilement
Nombre décimal, plage de 0.0 à 1.0, par défaut 0.5.
Délai de défilement
Entier (millisecondes), plage 0 ou supérieur, par défaut 0.
Dépannage
Le suivi ne fonctionne pas sur localhost
Ajoutez data-local="true" pour activer le suivi local.
Les objectifs personnalisés ne se déclenchent pas
Vérifiez que le nom de votre objectif respecte les règles de validation : minuscules uniquement, pas d'espaces ni de caractères spéciaux (sauf _ et -), max 64 caractères.
Le suivi inter-domaines ne fonctionne pas
Vérifiez : même data-fl-website-id sur tous les domaines, tous les domaines supplémentaires listés dans data-allowed-hostnames, les utilisateurs cliquent sur les liens entre les domaines.
Le suivi du défilement ne se déclenche pas
Problèmes courants : l'élément n'est pas assez longtemps dans le viewport, le seuil est trop élevé, IntersectionObserver n'est pas pris en charge.