getting-started

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.

Balise script de base
<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
Suivi inter-domaines
<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.

Objectif avec paramètres
<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).

Suivi du défilement avec seuil et 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.