Metti Personyze in funzione in pochi minuti.
Una risorsa passo-passo per sviluppatori e team tecnici — installa il codice di tracking, definisci i placeholder di contenuto, configura gli obiettivi e collega il tuo stack di dati.
Inizia ora →1Installa Personyze sul tuo sito
Per abilitare la personalizzazione, devi installare lo snippet di tracking su ogni pagina del tuo sito. Scegli il metodo che corrisponde alla tua piattaforma.
Opzione 1: Google Tag Manager (GTM)
Opzione A: HTML personalizzato (manuale)
Crea un tag « Custom HTML », incolla l'intero snippet JS Personyze e attivalo su « All Pages ».
Opzione B: integrazione template (la più semplice)
Cerca nella GTM Community Gallery « Personyze Tracking Code ». Aggiungilo, inserisci il tuo Site ID e attivalo su « All Pages ». Questo mantiene pulito il tuo container.
Opzione 2: HTML standard
Incolla lo snippet direttamente nel tag <head> del tuo file template principale. Assicurati che sia posizionato il più in alto possibile, subito dopo i tuoi meta tag charset e viewport.
Opzione 3: istruzioni CMS
theme.liquid. Incolla il codice prima di </head>.header.ftl template.2Definisci i placeholder (zone)
I placeholder sono aree del tuo sito dove Personyze inietta contenuti. Usare placeholder invece di popup rende la personalizzazione nativa.
Opzione A: il selettore visuale (no-code)
- Crea una nuova campagna e aggiungi un'azione « Banner ».
- In Impostazioni di visualizzazione, scegli « Show in placeholder ».
- Clicca « Find on pages » per aprire il simulatore.
- Naviga il tuo sito e clicca semplicemente sull'elemento (es. Hero Banner) che vuoi trasformare in una zona.
Opzione B: selettori CSS manuali
Inserisci manualmente ID o classi come #home-hero o .sidebar-widget.
Max azioni simultanee: Permette di impilare più banner verticalmente (es. mostrare Banner A E Banner B).
3Obiettivi di conversione e tracking dei KPI
Misura il ROI definendo a cosa assomiglia il successo. Puoi tracciare click semplici o dati di ricavo complessi.
1. Tipi di obiettivo
- URL di destinazione: Attivato quando l'utente visita un URL specifico come
/thank-youo/order-confirmed. Ottimo per la generazione di lead. - Traccia l'attività: Traccia interazioni specifiche come cliccare « Aggiungi al carrello », passare il mouse su un menu o guardare un video. Usa il Selettore visuale per scegliere l'elemento.
- Grab Data (ricavi): Estrai valori dinamici (es. « $150.00 ») dall'HTML della pagina o da un cookie. Essenziale per calcolare ROI e ricavi.
- Eventi esterni: Cattura automaticamente gli eventi inviati al Data Layer GTM o agli eventi Google Analytics senza configurazione aggiuntiva.
2. Impostazioni avanzate
- Valore dell'obiettivo: Imposta un Valore fisso (es. Lead = $10) o un Valore dinamico (catturato dalla pagina, come il totale di acquisto).
- Frequenza: Imposta « Once per visit » per i lead (per evitare conteggi duplicati al refresh) o « No Limit » per gli acquisti (per tracciare ogni transazione).
3. Metriche e-commerce
Se abiliti il tracking di prodotto/ricavi, Personyze calcola automaticamente Ricavi totali, AOV (valore medio dell'ordine) e tasso di contribuzione (quanto ricavo è stato influenzato dalla personalizzazione).
4Estrai i dati del sito (variabili)
Migliora il targeting « grabbando » dati dal browser del visitatore o dalla sessione della pagina per costruire un profilo utente ricco.
Sorgenti di dati supportate
Puoi creare una « User Profile Variable » da una qualsiasi di queste sorgenti:
- Elementi della pagina (HTML): Estrai testo visibile nella pagina (es. « Ciao, [Nome] » o « Punti: 500 »). Usa il Selettore visuale.
- Cookie: Leggi valori memorizzati nei cookie del browser (es.
login_status,affiliate_id). - Variabili JavaScript: Leggi variabili JS globali (es.
window.userLevelodataLayer[0].userId). - Meta Tag: Leggi i meta tag SEO per capire il contesto dei contenuti (es.
<meta name="author" content="John">). - Parametri URL: Leggi UTM o query string (es.
?campaign=summer_sale).
5CRM interno e integrazione dei dati
Connetti i tuoi database interni (CRM custom, SQL, ERP) con il comportamento del sito in tempo reale.
Metodi di integrazione:
- Upload CSV: Carica manualmente liste di User ID + attributi (stato VIP, settore, acquisti offline).
- Feed in tempo reale: Sincronizza tramite un URL Google Sheet o un feed HTTP che si aggiorna automaticamente.
- API: Usa l'API Personyze per inviare aggiornamenti utente in tempo reale dal tuo backend.
6Feed di prodotti e contenuti
Questo è necessario per eseguire Raccomandazioni di prodotto E Raccomandazioni di articoli/contenuti.
1. Prepara il tuo feed
Personyze accetta feed CSV, XML, JSON, RSS, Atom o Google Merchant.
2. Mappa le tue colonne
Vai a Settings > Data & Content > Product Feed. Devi mappare i campi del tuo feed agli attributi Personyze:
- ID interno: DEVE corrispondere all'ID del prodotto/articolo trovato sulla tua pagina live (SKU/ID) o variabile GTM. Questo permette a Personyze di sapere quale articolo l'utente sta visualizzando attualmente.
- Titolo: Il nome del prodotto o dell'articolo.
- URL immagine: Per la visualizzazione nei widget di raccomandazione.
- URL link: Dove porta il click sulla raccomandazione.
- Prezzo / categoria: Per filtraggio e logica.
Metodi alternativi
- Site Crawler: Se non hai un feed, contatta il tuo account manager per configurare un crawler che costruisca il feed dal tuo sito automaticamente.
- Upload SFTP: Per cataloghi enterprise di grandi dimensioni, chiedi al tuo account manager di abilitare l'upload SFTP sicuro.
7Privacy e opt-out
Garantisci la conformità GDPR/CCPA integrandoti con il tuo Consent Management Platform (CMP).
API JavaScript:
Usa questi comandi nella logica « Accept » o « Decline » del tuo cookie banner:
_S_T.system.off(): Ferma il tracking. Chiama questo se un utente rifiuta i cookie. Nessun dato sarà inviato._S_T.system.on(): Avvia il tracking. Chiama questo quando un utente accetta i cookie._S_T.system.is_on(): restituiscetrue/falseper controllare lo stato attuale.
Modalità rigorosa: Puoi configurare Personyze per girare in « Modalità rigorosa » dove non traccia IP o PII per impostazione predefinita finché non viene dato il consenso esplicito tramite il comando sopra.
8Integrazioni di terze parti
Integrazioni plug-and-play con gli strumenti che già usi. Per accedere a queste, vai a: Settings > Integrations.
Analytics e dati
Invia i dati di audience e campagne Personyze ai tuoi strumenti di analytics per il reporting.CRM e marketing
Sincronizzazione bidirezionale di lead e attributi utente tra Personyze e il tuo CRM.ABM e dati B2B
Arricchisci il traffico anonimo con dati di nome azienda, settore e ricavi.Infrastruttura
Connetti sistemi backend, autenticazione e automazione del workflow.9Configurazione del mittente email
Configura come Personyze invia le tue email triggerate e newsletter.
Opzione A: mittente predefinito (Amazon SES)
Per impostazione predefinita, Personyze usa Amazon SES. Puoi autorizzare il tuo indirizzo « From » (es. info@tuodominio.com).
- Aggiungi l'email desiderata nelle impostazioni Personyze.
- Riceverai una richiesta di verifica da AWS.
- Raccomandazione: Contatta il tuo account manager per ottenere i record DKIM da caricare nel tuo DNS per una migliore deliverability.
Opzione B: SMTP personalizzato
Usa il tuo server di posta (SendGrid, Mailgun, Outlook, ecc.) per un controllo completo.
- Seleziona « Mail provider (SMTP) ».
- Inserisci Host, Porta (es. 465 o 587), Utente e Password.
Opzione C: webhook (HTTP POST)
Invia il payload dei dati email al tuo endpoint o strumento di automazione (come Zapier) per attivare l'invio esternamente.
10Configurazione delle notifiche web push
Per abilitare le notifiche push del browser, devi installare un Service Worker.
1. Scarica il Service Worker
Scarica il file standard: sw.js
2. Installa sul tuo server
- Scenario A (nessun Service Worker esistente): Carica il file `sw.js` nella cartella root del tuo sito web (es. `tuosito.com/sw.js`).
- Scenario B (hai già un Service Worker): NON sovrascrivere il tuo file. Invece, chiedi al tuo sviluppatore di unire il contenuto del nostro `sw.js` in cima al tuo file service worker esistente.
Nota: ogni sito può avere un solo file Service Worker attivo.
11REST API Personyze
Integra Personyze in modo programmatico con i tuoi sistemi backend per leggere o scrivere dati.
Capacità
- Dati utente: Invia dati CRM o aggiorna i profili utente.
- Contenuti: Aggiorna il tuo catalogo di prodotti o contenuti.
- Eventi: Riporta conversioni offline o eventi backend.
12Mobile SDK (iOS e Android)
Estendi la personalizzazione alle tue applicazioni mobile native.
Funzionalità
- Profilo unificato: Traccia gli utenti tra Web e App.
- Targeting nativo: Usa comportamenti specifici dell'app per la segmentazione.
- Notifiche push: Attiva avvisi personalizzati.
13Single Sign-On (SSO)
Gestisci l'accesso alla dashboard Personyze usando il tuo enterprise identity provider.
Gestione centralizzata degli utenti, accesso con un click per i dipendenti e maggiore conformità di sicurezza.
Provider supportati
- Auth0
- Okta
- OneLogin
- Xecurify
Istruzioni di configurazione
- Vai a Settings > Integrations > Single Sign On nella console Personyze.
- Seleziona il tuo provider dalla lista.
- Inserisci l'URL dei metadati richiesto o i dettagli del certificato del tuo IdP.
- Salva e testa la connessione.
Domande di configurazione, con risposta.
Le cose che i team chiedono prima del go-live. Per il resto, il nostro team è a un messaggio di distanza.
Il codice di tracking rallenterà il mio sito web?
No. Il tag Personyze si carica in modo asincrono, ovvero gira in background e non blocca il rendering del contenuto principale della tua pagina. Questo garantisce un impatto trascurabile sulla velocità del tuo sito o sui Core Web Vitals.
Posso installare tramite Google Tag Manager?
Sì. Questo è il metodo consigliato. Puoi usare il nostro template ufficiale GTM (cerca « Personyze ») o creare un tag HTML personalizzato. Assicurati solo di impostare il tag perché si attivi su « All Pages ».
Personyze è conforme al GDPR?
Sì. Offriamo strumenti per aiutarti a essere conforme, inclusa una « Modalità rigorosa » che disabilita il tracking finché non viene dato il consenso. Puoi anche attivare il tracking solo dopo che un utente ha accettato i cookie tramite il tuo CMP (Consent Management Platform).
Come sincronizzo il mio catalogo prodotti?
Puoi caricare un Product Feed (CSV, XML, JSON) o sincronizzare direttamente da Google Merchant Center. Se non hai un feed, il nostro Site Crawler può estrarre automaticamente i dati di prodotto dalle tue pagine.
E se ho una Single Page Application (SPA)?
Personyze supporta completamente le SPA (React, Angular, Vue). Il nostro tracker rileva automaticamente le « virtual pageview » quando l'URL cambia senza un ricaricamento completo, garantendo che il comportamento sia tracciato correttamente nella sessione.
Posso tracciare gli utenti tra dispositivi?
Sì. Se un utente fa login sia su desktop che su mobile (o clicca un link email su entrambi), Personyze unisce i loro profili usando un identificatore unico (come User ID o Email Hash), dandoti una vista unificata del suo percorso.
Mi serve uno sviluppatore per configurare gli obiettivi?
Non necessariamente. Obiettivi semplici come « URL Visits » o « Button Clicks » possono essere configurati con la nostra interfaccia visuale. Obiettivi più complessi, come catturare valori di ricavo dinamici, potrebbero richiedere la conoscenza del selettore CSS o del nome della variabile JavaScript.
Come funziona l'integrazione CRM?
Sincronizziamo i dati in modo bidirezionale. Puoi inviare il comportamento del sito (es. « Ha visualizzato la pagina pricing ») al tuo CRM, e tirare attributi CRM (es. « Cliente VIP ») in Personyze per personalizzare l'esperienza sul sito.
Posso usare il mio mittente email?
Sì. Sebbene forniamo un mittente predefinito tramite Amazon SES, puoi configurare il tuo server SMTP (SendGrid, Mailgun, Outlook) nelle impostazioni per garantire che le email vengano dal tuo dominio con un controllo completo della deliverability.
Cosa succede se cambio il tema del mio sito web?
Se cambi la tua struttura HTML (ID o classi CSS), alcuni placeholder o regole « grab data » potrebbero rompersi. Raccomandiamo di controllare le tue campagne Personyze dopo qualsiasi redesign importante del sito per garantire che i selettori siano ancora validi.
Posso escludere il traffico interno?
Sì. Puoi filtrare il traffico da indirizzi IP specifici (come l'IP del tuo ufficio) nelle impostazioni dell'account in modo che le visite dei dipendenti non distorcano i tuoi dati analytics.
Il tracking funziona offline?
Per il tracking web, è necessaria una connessione internet. Tuttavia, se usi il nostro Mobile SDK, possiamo mettere in cache gli eventi localmente sul dispositivo e sincronizzarli una volta che l'utente torna online.
Quanto è sicuro il trasferimento dei dati?
Tutti i dati vengono trasmessi tramite cifratura HTTPS. Aderiamo a protocolli di sicurezza rigorosi, inclusa la conformità SOC 2, per garantire che i dati dei tuoi clienti rimangano al sicuro.
Posso gestire più domini in un unico account?
Sì. Personyze supporta il tracking multi-dominio. Puoi gestire siti separati sotto un unico account o collegarli per condividere i dati utente tra domini diversi (Cross-Domain Tracking).
Cos'è un « Service Worker » per le notifiche push?
Un Service Worker è uno script che gira in background nel browser. È necessario per ricevere messaggi push anche quando l'utente non è attivamente sul tuo sito web. Devi caricare questo file nella directory root del tuo server.
Attiva la personalizzazione in tempo reale sul tuo sito.
Hai il playbook di configurazione completo — ora mettilo all'opera. Installa il tracker, definisci il tuo primo placeholder, e guarda il tuo sito adattarsi a ogni visitatore.