Custom Script
Un solo script. Tutte le funzionalità. Aggiungi uno snippet leggero al codice sorgente del tuo sito e sblocca tutta la potenza di Positive User: tracking dei visitatori, chat dal vivo, identificazione dei contatti e automation guidate dagli eventi. Nessun plugin, nessuna dipendenza da CMS, nessuno sviluppatore necessario oltre all'accesso all'HTML.
Un solo snippet per alimentare tutta la tua piattaforma
Funziona su qualsiasi sito
Niente plugin CMS? Nessun problema. Lo script Positive User si integra con qualsiasi sito: HTML statico, applicazioni sviluppate ad hoc, architetture headless o piattaforme senza plugin dedicato. Incolla lo snippet subito prima del tag </body> e il tracking parte immediatamente.
Dal visitatore anonimo al contatto identificato
Nel momento in cui lo script si carica, Positive User assegna una chiave univoca a ciascun visitatore e inizia a tracciare pageview, dispositivo, browser e posizione, il tutto in modo anonimo. Quando sei pronto a identificare gli utenti, trasmetti tramite lo script attributi come email, nome o numero di telefono. Tutta l'attività precedente all'identificazione viene quindi unita al profilo del contatto identificato.
Trasmetti qualsiasi dato ti serva
L'oggetto window.civchat accetta attributi standard (nome, email, numero di telefono, status, score) e dati aziendali (nome azienda, ID, fatturato), il tutto in un singolo blocco di codice. Usa valori statici, variabili GTM o JavaScript dinamico per alimentare l'oggetto. Qualsiasi cosa tu invii, arriva istantaneamente nel profilo del contatto.
Tre semplici passi per iniziare
Copia il tuo script
Nella tua app Positive User, vai su Settings > Setup & Integrations > Basic Integration. Copia lo script. Contiene già la tua chiave API e il dominio dell'app.
Aggiungilo al tuo sito
Incolla lo script subito prima del tag </body> nel codice sorgente del tuo sito. In alternativa, distribuiscilo tramite Google Tag Manager con un trigger configurato per attivarsi su tutte le pagine.
Verifica il tracking
Apri il tuo sito, poi controlla la sezione Contatti in Positive User. Nel giro di pochi secondi dovrebbero comparire nuovi record di visitatori anonimi. Per una verifica tecnica, apri la console del browser, digita civchat e conferma che l'oggetto sia definito. Il tracking è attivo.
Popular implementation guides
- Integrazione tramite implementazione dello script: Guida passo dopo passo per il setup base e avanzato dello script, inclusa la trasmissione di attributi utente e dati aziendali. Leggi la guida →
- Implementare Positive User con Google Tag Manager: Distribuisci lo script Positive User tramite GTM invece di modificare direttamente il codice sorgente. Ideale per i team che gestiscono i tag in modo centralizzato. Leggi la guida →
- Impostazioni del widget di chat: Configura visibilità, aspetto e comportamento del widget. Utile se distribuisci lo script solo per il tracking e vuoi nascondere o personalizzare il widget di chat. Vai al tutorial →
- Impostare ID personalizzati per utenti, aziende e trattative: Scopri come funzionano user_id e company_id per associare i visitatori del sito ai record esistenti nel database ed evitare i duplicati. Vai al tutorial →
Frequently Asked Questions
Servono competenze di programmazione per integrare lo script?
Davvero poche. Ti serve l'accesso al codice sorgente HTML del sito (oppure a Google Tag Manager) e incolli uno snippet già pronto. Lo script si copia direttamente dalle tue impostazioni Positive User, senza alcuna modifica. Se sai aprire un file del sito o incollare un tag in GTM, sei a posto.
Qual è la differenza tra lo script base e lo script avanzato?
Lo script base contiene solo la tua chiave API. Attiva il tracking anonimo dei visitatori, la registrazione delle pageview e il widget di chat. Lo script avanzato aggiunge un oggetto window.civchat in cui passare attributi utente (email, nome, telefono) e dati aziendali, così i visitatori arrivano direttamente come contatti identificati in Positive User.
Lo script rallenterà il mio sito?
No. Lo script si carica in modo asincrono ed è leggero. Non blocca il rendering delle pagine né influisce sulle performance del sito.
Posso usare questa integrazione con Google Tag Manager invece di modificare il codice sorgente?
Sì. Puoi distribuire lo script Positive User come tag HTML personalizzato in GTM. Imposta il trigger in modo che si attivi su tutte le pagine. È l'approccio consigliato se il tuo team gestisce già altri tag tramite GTM, oppure se non hai accesso diretto al codice sorgente del sito.
Come funziona il tracking dei visitatori anonimi?
Quando lo script si carica, genera una user_key univoca e memorizza un cookie nel browser del visitatore. Ogni pageview viene registrata e associata a quella chiave. Il visitatore appare come record anonimo in Positive User finché non si identifica (interazione in chat, invio di un form o attributi trasmessi tramite lo script avanzato).
Quali formati di dati sono richiesti per gli attributi?
Le date devono seguire il formato ISO 8601 (ad esempio 2017-07-25T14:14:08.612Z). I numeri di telefono devono usare il formato E.164 (ad esempio +44754123434). Gli altri attributi accettano stringhe, numeri o booleani a seconda del tipo di campo definito nella tua app Positive User.
Posso trasmettere dati aziendali insieme ai dati utente?
Sì. L'oggetto window.civchat accetta un oggetto company annidato con attributi come name, company_id e revenue. In una sola chiamata viene creato o aggiornato sia il profilo del contatto sia il record aziendale associato in Positive User, mantenendo automaticamente il collegamento tra i due.
E se non voglio che il widget di chat appaia?
Puoi comunque usare lo script solo per il tracking e la raccolta dati. Vai su Settings > Chat Widget Settings > Widget Visibility e imposta lo stato del widget su "Hidden". Lo script continua a girare silenziosamente in background.
Come verifico che lo script funzioni?
Due metodi. Primo, controlla la sezione Contatti nella tua app Positive User: dopo una visita al sito dovrebbero comparire nuovi record anonimi. Secondo, apri la console di sviluppo del browser sul tuo sito e digita civchat. Se l'oggetto è definito, lo script è caricato e il tracking è attivo.
Posso tracciare eventi personalizzati con questo script?
Lo script di per sé gestisce l'identificazione dei visitatori e la trasmissione degli attributi. Per inviare eventi personalizzati (acquisti, invii di form, clic sui pulsanti), dovrai aggiungere separatamente chiamate di tracking degli eventi, tramite l'API JavaScript di Positive User o tramite trigger di Google Tag Manager. Il nostro team può aiutarti a definire l'approccio più adatto al tuo caso d'uso.