Custom Script
Un unico script. Tutte le funzionalità. Aggiungi un breve snippet al codice sorgente del tuo sito web e sfrutta appieno tutte le potenzialità di Positive User: monitoraggio dei visitatori, chat in tempo reale, identificazione dei contatti e automazione basata sugli eventi. Nessun plugin, nessuna dipendenza dal CMS, non è necessario nessuno sviluppatore: è sufficiente avere accesso al codice HTML.
Un solo snippet per potenziali tutta la tua piattaforma
Funziona su qualsiasi sito
Non hai un plugin CMS? Nessun problema. Lo script Positive User si integra con qualsiasi sito web: HTML statico, applicazioni personalizzate, architetture headless o piattaforme prive di un plugin dedicato. Incolla il frammento di codice prima del tag di chiusura </body> e il tracciamento inizierà immediatamente.
Da visitatore anonimo a contatto identificato
Non appena lo script viene caricato, Positive User assegna una chiave univoca a ciascun visitatore e inizia a tracciare le visualizzazioni delle pagine, il dispositivo, il browser e la posizione, il tutto in forma anonima. Quando sei pronto a identificare gli utenti, invia allo script attributi quali l'indirizzo email, il nome o il numero di telefono. Ogni attività precedente all'identificazione viene quindi integrata nel profilo del contatto identificato.
Trasferisci i dati di cui hai bisogno
L'oggetto window.civchat accetta attributi standard (nome, email, numero di telefono, stato, punteggio) e dati aziendali (nome dell'azienda, ID, fatturato), il tutto in un unico blocco di codice. Per popolare l'oggetto è possibile utilizzare valori statici, variabili GTM o JavaScript dinamico. Qualunque dato venga inserito, viene immediatamente riportato nel profilo del contatto.
Tre semplici passaggi per iniziare
Copia il tuo script
Nella tua app Positive User, vai su Impostazioni > Configurazione e Integrazioni > Integrazione basic. 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 web, quindi controlla la sezione “Contatti” in Positive User. I nuovi record relativi ai visitatori anonimi dovrebbero comparire nel giro di pochi secondi. Per effettuare una verifica tecnica, apri la console del browser, digita “civchat” e verifica che l'oggetto sia definito. Il tracciamento è attivo.
Guide pratiche più popolari
- 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 →
Domande frequenti
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) per incollare 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, non serve altro.
Qual è la differenza tra lo script base e lo script avanzato?
Lo script di base contiene solo la tua chiave API. Consente il monitoraggio dei visitatori anonimi, la registrazione delle visualizzazioni di pagina e l'utilizzo del widget di chat. Lo script avanzato aggiunge un oggetto window.civchat a cui è possibile passare gli attributi dell'utente (email, nome, numero di telefono) e i dati aziendali, in modo che i visitatori vengano registrati fin dall'inizio 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ì. È possibile implementare lo script Positive User come tag HTML personalizzato in GTM. Imposta il trigger in modo che si attivi su tutte le pagine. Questo è l'approccio consigliato se il tuo team gestisce già altri tag tramite GTM o se non hai accesso diretto al codice sorgente del sito web.
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 quali name, company_id e revenue. In questo modo, con un'unica chiamata, vengono creati o aggiornati sia il profilo del contatto che il record aziendale associato in Positive User, mantenendo automaticamente il collegamento tra i due.
E se non voglio far comparire il widget di chat?
Puoi comunque utilizzare lo script esclusivamente per il monitoraggio e la raccolta dei dati. Vai su Impostazioni > Impostazioni widget chat > Visibilità widget e imposta lo stato del widget su “Nascosto”. Lo script continuerà a funzionare in modo silenzioso 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.