Lo script di tracciamento di Flowsery Analytics supporta diversi attributi data per personalizzare il tracciamento. Questa guida copre tutte le opzioni di configurazione disponibili.
Sei nuovo su Flowsery Analytics?
Parti dalla guida all'installazione per aggiungere lo script di tracciamento al tuo sito.Attributi dello script
ID del sito: Data-Fl-Website-ID (obbligatorio)
L'identificativo univoco del tuo sito in Flowsery Analytics. È l'unico attributo obbligatorio.
<script
defer
data-fl-website-id="flid_******"
src="https://cdn.flowsery.com/main.js"
></script>Dominio, Data-Domain (facoltativo)
Imposta l'ambito dei cookie per gli ID di visitatore e sessione. Il valore predefinito è location.hostname, quindi i siti con un solo dominio possono ometterlo. Impostalo quando vuoi un unico cookie del visitatore condiviso tra i sottodomini: ad esempio data-domain="example.com" fa sì che example.com, app.example.com e blog.example.com condividano lo stesso ID visitatore. Non ha effetto in modalità senza cookie.
Tracciamento dei sottodomini
Flowsery Analytics traccia per impostazione predefinita tutti i sottodomini del tuo dominio principale: data-domain controlla l'ambito dei cookie, non quali hostname vengono tracciati. Ad esempio, se il tuo dominio principale è example.com, Flowsery Analytics funziona anche su app.example.com, blog.example.com, shop.example.com, ecc.Hostname consentiti: Data-Allowed-Hostnames (facoltativo)
Elenco separato da virgole di domini aggiuntivi per il tracciamento cross-domain.
- Predefinito: vuoto (nessun tracciamento cross-domain)
- Esempio: app.io,shop.example.com
- Caso d'uso: tracciare gli utenti su domini principali diversi
<script
defer
data-fl-website-id="flid_******"
data-allowed-hostnames="app.io,myapp.org"
src="https://cdn.flowsery.com/main.js"
></script>URL dell'API: Data-API (facoltativo)
Endpoint API personalizzato per l'invio degli eventi. Accetta un URL completo o un percorso relativo.
- Esempio: https://api.example.com/events oppure /custom-events
- Caso d'uso: endpoint API personalizzati, proxy di analytics di terze parti o configurazioni proxy avanzate
Se indichi un percorso relativo, viene aggiunto al tuo dominio.
Rilevamento automatico del proxy
Flowsery Analytics rileva in automatico le configurazioni con proxy. Usa questo attributo solo se ti serve un percorso di endpoint personalizzato o vuoi inviare gli eventi a un server completamente diverso.Consenti localhost: Data-Local (facoltativo)
Attiva il tracciamento su localhost per sviluppo e test. Accetta "true" o "false". Predefinito: false.
Consenti il protocollo file: Data-Allow-File-Protocol (facoltativo)
Attiva il tracciamento quando apri file HTML direttamente nel browser (protocollo file://). Accetta "true" o "false". Predefinito: false.
Modalità debug: Data-Debug (facoltativo)
Attiva la modalità debug per consentire il tracciamento negli iframe. Accetta "true" o "false". Predefinito: false. Per impostazione predefinita, Flowsery Analytics non traccia all'interno degli iframe per evitare tracciamenti duplicati.
Disattiva la console: Data-Disable-Console (facoltativo)
Disattiva tutti i log in console del tracker di Flowsery Analytics. Accetta "true" o "false". Predefinito: false.
Disattiva i pagamenti: Data-Disable-Payments (facoltativo)
Disattiva il tracciamento automatico dei pagamenti e l'attribuzione delle entrate dai parametri URL (session_id di Stripe, order_id di LemonSqueezy, checkout_id di Polar). Accetta "true" o "false". Predefinito: false.
- Caso d'uso: quando usi l'attribuzione delle entrate lato server, per evitare eventi di pagamento duplicati
Tracciamento manuale dei pagamenti
Le chiamate manuali window.flowsery("payment", { email }) continuano a funzionare anche con questa opzione attiva. Viene disattivato solo il rilevamento automatico dai parametri URL.Attributi degli elementi HTML
Questi attributi si aggiungono agli elementi HTML della pagina per attivare il tracciamento automatico.
Monitoraggio degli obiettivi: Data-Fs-Goal (facoltativo)
Traccia i clic su qualsiasi elemento come obiettivo personalizzato. Solo lettere minuscole, numeri, trattini bassi e trattini. Massimo 64 caratteri.
<button data-fs-goal="add_to_cart">Add to Cart</button>Parametri dell'obiettivo: Data-Fs-Goal-* (facoltativo)
Aggiungi parametri personalizzati agli eventi degli obiettivi. Il nome del parametro deriva dal nome dell'attributo (kebab-case, convertito in snake_case). Massimo 10 parametri per evento. Nomi dei parametri: massimo 64 caratteri. Valori: massimo 255 caratteri.
<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>Tracciamento dello scorrimento: Data-Fs-Scroll (facoltativo)
Traccia in automatico quando un elemento diventa visibile durante lo scorrimento. Attivazione predefinita: elemento visibile al 50%. Stesse regole di denominazione di data-fs-goal.
<section data-fs-scroll="viewed_pricing">
<h2>Pricing</h2>
</section>Soglia di scorrimento: Data-Fs-Scroll-Threshold (facoltativo)
Personalizza la soglia di visibilità per il tracciamento dello scorrimento. Decimale tra 0 e 1. Predefinito: 0.5 (50% dell'elemento visibile). Valori comuni: 0.1 (10%), 0.5 (50%), 0.9 (90%), 1.0 (100%).
Ritardo di scorrimento: Data-Fs-Scroll-Delay (facoltativo)
Aggiungi un ritardo in millisecondi prima che l'evento di scorrimento venga tracciato. Predefinito: 0 (nessun ritardo).
<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>Parametri di scorrimento: Data-Fs-Scroll-*
Aggiungi parametri personalizzati agli eventi di scorrimento, come con data-fs-goal-*.
Esempi di configurazione comuni
Ambiente di sviluppo
<script
defer
data-fl-website-id="flid_******"
data-local="true"
src="https://cdn.flowsery.com/main.js"
></script>Produzione con proxy
<script
defer
data-fl-website-id="flid_******"
src="/js/main.js"
></script>Flowsery Analytics rileva in automatico le configurazioni con proxy. Non serve data-api se fai passare dal proxy sia /js/main.js sia /api/track.
Tracciamento cross-domain
<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>Usa la stessa configurazione su tutti i domini tracciati.
Tracciamento della navigazione basata su hash
Per le Single Page Application con routing basato su hash:
<script
defer
data-fl-website-id="flid_******"
src="https://cdn.flowsery.com/main.hash.js"
></script>Riepilogo delle regole di validazione
Nomi di obiettivi ed eventi
- Caratteri: lettere minuscole, numeri, trattini bassi (_), trattini (-)
- Lunghezza: massimo 64 caratteri
Nomi dei parametri personalizzati
- Caratteri: lettere minuscole, numeri, trattini bassi (_), trattini (-)
- Lunghezza: massimo 64 caratteri
- Conversione: gli attributi in kebab-case vengono convertiti in automatico in snake_case
Valori dei parametri personalizzati
- Lunghezza: massimo 255 caratteri
- HTML/XSS: i caratteri pericolosi vengono ripuliti in automatico
- Limite: massimo 10 parametri personalizzati per evento
Soglia di scorrimento
Numero decimale, intervallo da 0.0 a 1.0, predefinito 0.5.
Ritardo di scorrimento
Numero intero (millisecondi), da 0 in su, predefinito 0.
Risoluzione dei problemi
Il tracciamento non funziona su localhost
Aggiungi data-local="true" per attivare il tracciamento in locale.
Gli obiettivi personalizzati non vengono registrati
Verifica che il nome dell'obiettivo rispetti le regole di validazione: solo minuscole, niente spazi o caratteri speciali (tranne _ e -), massimo 64 caratteri.
Il tracciamento cross-domain non funziona
Verifica che: lo stesso data-fl-website-id sia presente su tutti i domini, tutti i domini aggiuntivi siano elencati in data-allowed-hostnames, gli utenti passino da un dominio all'altro facendo clic sui link.
Il tracciamento dello scorrimento non si attiva
Problemi comuni: l'elemento non resta nel viewport abbastanza a lungo, la soglia è troppo alta, IntersectionObserver non è supportato.