Le variabili personalizzate sono tag di coppie nome-valore che puoi inserire nel codice di monitoraggio per perfezionare il monitoraggio di Google Analytics. Con le variabili personalizzate, puoi definire segmenti aggiuntivi da applicare ai visitatori oltre a quelli già forniti da Analytics. Questo documento descrive le variabili personalizzate e come impostarle.
Panoramica
Otterrai il massimo dalle variabili personalizzate se comprendi il modello di base di interazione con i visitatori utilizzato in Google Analytics. In questo modello, il visitatore interagisce con i tuoi contenuti per un determinato periodo di tempo e il coinvolgimento con il sito è suddiviso in una gerarchia.
Il diagramma illustra questo modello per un singolo visitatore del tuo sito, in cui ogni blocco rappresenta il numero di sessioni utente e interazioni di quel particolare utente.
Ogni livello di questo modello è definito come segue:
- Visitatore: il client che visita il sito, ad esempio il browser o il cellulare gestito da una persona.
- Sessione: il periodo di tempo durante il quale il visitatore è attivo sul sito.
- Pagina: attività per conto dell'utente che invia una richiesta GIF ai server di Analytics.
In genere è caratterizzato da una visualizzazione di pagina, ma può includere:
- una visualizzazione di pagina
- un evento (ad esempio un clic su un pulsante filmato)
Ciascuno di questi tre livelli di interazione definisce uno specifico ambito di coinvolgimento dei visitatori. Questa distinzione è importante per le variabili personalizzate perché ogni variabile personalizzata è limitata a un ambito specifico. Ad esempio, potrebbe essere utile conoscere il numero di sessioni in cui i visitatori hanno rimosso un articolo dal carrello degli acquisti. In questo caso specifico, devi definire la variabile personalizzata a livello di sessione, in modo che l'intera sessione per quel visitatore venga contrassegnata come in cui gli articoli sono stati rimossi dai carrelli online.
Utilizzo delle variabili personalizzate
Poiché puoi impostare una serie di variabili personalizzate per monitorare l'attività degli utenti sul tuo sito, generalmente creerai delle utilità JavaScript personalizzate per gestirle. Lo script utilizzerà il metodo di base per creare una variabile personalizzata, come indicato di seguito:
_setCustomVar(index, name, value, opt_scope)
Questo metodo accetta quattro parametri:
- indice: l'area per la variabile personalizzata. Obbligatorio. Questo è un numero il cui valore può essere compreso tra
1e5inclusi. Una variabile personalizzata deve essere inserita in un solo slot e non riutilizzabile in slot diversi. - name: il nome della variabile personalizzata. Obbligatorio. Si tratta di una stringa che identifica la variabile personalizzata e viene visualizzata nel report Variabili personalizzate di primo livello dei report di Analytics.
- value: il valore della variabile personalizzata. Obbligatorio. Si tratta di una stringa abbinata a un nome. Puoi associare una serie di valori a un nome di variabile personalizzata. Il valore viene visualizzato nell'elenco delle tabelle nella UI relative al nome di una variabile selezionata. In genere, per un determinato nome ci saranno due o più valori. Ad esempio, potresti definire il nome di una variabile personalizzata
gendere forniremaleefemalecome due possibili valori. - opt_scope: l'ambito della variabile personalizzata. Facoltativo. Come descritto in precedenza, l'ambito definisce il livello di coinvolgimento degli utenti con il tuo sito. È un numero i cui valori possibili sono
1(a livello di visitatore),2(a livello di sessione) o3(a livello di pagina). Se non viene definito, per impostazione predefinita l'ambito della variabile personalizzata viene impostato sull'interazione a livello di pagina.
Il seguente snippet di codice mostra come impostare una variabile personalizzata per monitorare le visite in cui gli utenti hanno rimosso gli articoli dal carrello degli acquisti. In questo caso, il metodo _setCustomVar() viene chiamato subito prima di un metodo _trackEvent(), in modo che venga consegnato nella richiesta GIF inviata dal metodo _trackEvent().
Utilizza il nome Items Removed con il valore Yes per
definire l'attività degli utenti del sito web. Inoltre, avrebbe
senso impostare una variabile personalizzata predefinita
per Items Removed e No. In questo modo, avrai
un conteggio delle visite in cui gli articoli sono stati rimossi dai carrelli degli acquisti e un
conteggio delle visite che non includevano la rimozione degli articoli.
Snippet asinc (consigliato)
_gaq.push(['_setCustomVar',
1, // This custom var is set to slot #1. Required parameter.
'Items Removed', // The name acts as a kind of category for the user activity. Required parameter.
'Yes', // This value of the custom variable. Required parameter.
2 // Sets the scope to session-level. Optional parameter.
]);
_gaq.push(['_trackEvent',
'Shopping', // category of activity
'Item Removal', // Action
]);
Dopo aver impostato le variabili personalizzate, puoi utilizzare il metodo _deleteCustomVar(index) per rimuoverle.
Esempi di casi d'uso
Le variabili personalizzate possono essere implementate in molti modi diversi, a seconda del modello del tuo sito web e delle esigenze aziendali. Gli esempi esplorano diversi casi d'uso, ognuno dei quali illustra un diverso livello di ambito:
- Variabili personalizzate a livello di pagina
- Variabili personalizzate a livello di sessione
- Variabili personalizzate a livello di visitatore
Variabili personalizzate a livello di pagina
Utilizza le variabili personalizzate a livello di pagina per definire una raccolta di attività a livello di pagina da parte dei tuoi utenti.
Ad esempio, supponiamo che tu gestisca il sito web di un giornale online in cui i visitatori visualizzano molti articoli diversi. Sebbene sia facile determinare quali articoli specifici siano i più popolari, ora puoi anche utilizzare le variabili personalizzate per determinare quali sezioni del giornale sono più popolari. Per farlo, imposta una variabile personalizzata a livello di pagina per ogni articolo, dove la relativa sezione è impostata come variabile personalizzata. Ad esempio, potresti avere sezioni quali Vita e stile, Opinioni e Attività. Potresti impostare una variabile personalizzata per monitorare tutti i tuoi articoli per sezione.
Snippet asinc (consigliato)
_gaq.push(['_setCustomVar',
1, // This custom var is set to slot #1. Required parameter.
'Section', // The top-level name for your online content categories. Required parameter.
'Life & Style', // Sets the value of "Section" to "Life & Style" for this particular aricle. Required parameter.
3 // Sets the scope to page-level. Optional parameter.
]);
Continuiamo con questo esempio e supponiamo che tu voglia taggare la sezione di un determinato articolo, ma anche la sottosezione. Ad esempio, la sezione Vita e stile del tuo giornale potrebbe includere anche varie sottosezioni, tra cui Cibi e bevande, Moda e Sport. Pertanto, per un determinato articolo, puoi monitorare sia la sezione che la sottosezione. Potresti impostare una variabile personalizzata aggiuntiva per monitorare tutti i tuoi articoli per sottosezione.
Snippet asinc (consigliato)
_gaq.push(['_setCustomVar',
2, // This custom var is set to slot #2. Required parameter.
'Sub-Section', // The 2nd-level name for your online content categories. Required parameter.
'Fashion', // Sets the value of "Sub-section" to "Fashion" for this particular article. Required parameter.
3 // Sets the scope to page-level. Optional parameter.
]);
In questo esempio, imposti due variabili personalizzate simultanee a livello di pagina per una singola pagina. Per ogni singola pagina puoi monitorare fino a cinque variabili personalizzate, ciascuna con un'area separata. Ciò significa che puoi assegnare altre 3 variabili personalizzate alla stessa pagina. Per tutti gli articoli del tuo sito web, puoi impostare un array di variabili personalizzate a livello di pagina per monitorarle in base a una vasta gamma di sezioni e sottosezioni. Per ulteriori informazioni su come utilizzare correttamente le variabili personalizzate a livello di pagina, consulta le linee guida per l'utilizzo riportate di seguito.
Variabili personalizzate a livello di sessione
Utilizza le variabili personalizzate a livello di sessione per distinguere le diverse esperienze dei visitatori nelle varie sessioni.
Ad esempio, se il tuo sito web offre agli utenti la possibilità di accedere, puoi utilizzare una variabile personalizzata con ambito a livello di sessione per lo stato di accesso dell'utente. In questo modo, puoi segmentare le visite in base ai visitatori che hanno effettuato l'accesso rispetto ai visitatori anonimi.
Snippet asinc (consigliato)
_gaq.push(['_setCustomVar',
1, // This custom var is set to slot #1. Required parameter.
'User Type', // The name of the custom variable. Required parameter.
'Member', // Sets the value of "User Type" to "Member" or "Visitor" depending on status. Required parameter.
2 // Sets the scope to session-level. Optional parameter.
]);
Supponi di voler monitorare sia il tipo di utente sia se si è verificato un tentativo di acquisto per una determinata sessione. Se presumiamo che ogni pagina offra all'utente la possibilità di eseguire l'accesso, consigliamo di prenotare lo slot n. 1 per la variabile personalizzata Tipo di utente e di utilizzare un altro spazio per il tentativo di acquisto:
Snippet asinc (consigliato)
_gaq.push(['_setCustomVar',
2, // This custom var is set to slot #2. Required parameter.
'Shopping Attempts', // The name of the custom variable. Required parameter.
'Yes', // The value of the custom variable. Required parameter.
// (you might set this value by default to No)
2 // Sets the scope to session-level. Optional parameter.
]);
Variabili personalizzate a livello di visitatore
Utilizza le variabili personalizzate a livello di visitatore per distinguere le categorie di visitatori in più sessioni.
Ad esempio, se il tuo sito web offre contenuti premium ad abbonati paganti, puoi impostare una variabile personalizzata a livello di visita per analizzare quali utenti sono abbonati paganti, a quale livello di pagamento e quali utenti utilizzano il livello di servizio senza costi per il sito. Probabilmente dovrai impostare questa variabile personalizzata come funzione una tantum, in quanto il valore persiste per tutta la durata del cookie del visitatore.
Snippet asinc (consigliato)
_gaq.push(['_setCustomVar',
1, // This custom var is set to slot #1. Required parameter.
'Member Type', // The name of the custom variable. Required parameter.
'Premium', // The value of the custom variable. Required parameter.
// (possible values might be Free, Bronze, Gold, and Platinum)
1 // Sets the scope to visitor-level. Optional parameter.
]);
Linee guida sull'utilizzo
Questa sezione descrive le differenze tra i diversi tipi di variabili personalizzate e come utilizzarle correttamente:
- Tipi di variabili personalizzate
- Presta attenzione quando si combinano diversi tipi di variabili
- Pratiche consigliate
Tipi di variabili personalizzate
La tabella seguente definisce le caratteristiche principali dei diversi tipi di variabili. Tieni presente che esistono alcune limitazioni quando gli stessi slot sono utilizzati da variabili diverse.
La lunghezza totale combinata di qualsiasi nome e valore di una variabile personalizzata non può superare i 128 caratteri.
| Durata | Quando condividi uno slot con altre variabili | Numero consentito | |
|---|---|---|---|
| A livello di pagina | Una singola visualizzazione di pagina, un evento o una chiamata di transazione. |
L'ultima variabile a livello di pagina da richiamare su una pagina è quella applicata a quest'ultima. | Per qualsiasi proprietà web (raccolta di pagine), è possibile impostare molte variabili univoche a livello di pagina e gli spazi possono essere riutilizzati. Limitata solo dal numero di hit in una determinata sessione. Per ogni pagina, puoi impostare fino a cinque variabili personalizzate simultanee. |
| A livello di sessione |
La sessione corrente del visitatore. |
L'ultima variabile a livello di sessione chiamata in una sessione
è quella utilizzata per quella sessione. Esegue l'override di qualsiasi variabile a livello di pagina impostata in precedenza chiamata nella
stessa sessione. |
Per qualsiasi proprietà web, puoi creare tutte le variabili personalizzate a livello di sessione che puoi definire con un limite di 128 caratteri per le coppie chiave-valore. Per ogni sessione utente specifica, puoi impostare fino a cinque variabili a livello di sessione. |
| A livello di visitatore | La sessione corrente e tutte le sessioni future per la durata del cookie del visitatore. |
L'ultimo valore impostato per un visitatore è quello applicato alla sessione attuale e a quelle future. |
Per qualsiasi proprietà web, puoi creare fino a cinque variabili distinte a livello di visitatore. |
Presta attenzione quando si mescolano diversi tipi di variabili
In genere non è consigliabile combinare lo stesso slot delle variabili personalizzate con tipi diversi per evitare strani calcoli delle metriche.
Quando utilizzi più variabili personalizzate a livello di pagina, sessione e visitatore per la tua proprietà web, devi determinare con attenzione se gli slot vengono riutilizzati. Se sul tuo sito web si verifica una situazione in cui una variabile personalizzata a livello di pagina o di sessione utilizza la stessa area contemporaneamente è impostata una variabile a livello di pagina, verrà registrata solo la variabile a livello di sessione (o a livello di pagina).
I seguenti scenari illustrano una combinazione di variabili a livello di pagina, sessione e visitatore impostate da un singolo utente nello stesso browser. In ogni esempio, l'area annuncio è indicata dal numero tra parentesi e S: indica l'ambito della variabile.
Caso 1 - Ha la precedenza la variabile finale a livello di sessione
In questo caso la pagina finale riutilizza una variabile personalizzata a livello di sessione nell'area 1 in modo che abbia la precedenza.
| Visita 1 | Pagina 1 (1) section=opinion a livello di pagina |
Pagina 2 (1) D: a livello di sessione login=true |
Pagina 3 (1) D: a livello di sessione converted=true |
|---|
Il report per le visite sarebbe:
- # visita per la sezione=opinione: 0
- # visite per login=true: 0
- # visita per convertito=true: 1
Caso 2 - Ha la precedenza la variabile iniziale a livello di visitatore
Qui l'area 1 viene utilizzata per la prima volta da una variabile personalizzata a livello di visitatore nella visita 1 seguita da una variabile personalizzata a livello di pagina nella visita 3. In questo ordine, la variabile a livello di visitatore non sovrascrive la variabile a livello di pagina.
| Visita 1 | Pagina 1 (1) S: a livello di visitatore gender=male |
|---|---|
| Visita 2 |
Pagina 1 (2) Livello di sessione: converted=false |
| Visita 3 |
Pagina 1 (1) section=opinion a livello di pagina |
Il report per le visite sarebbe:
- # visite per genere=maschile: 2
- # visita per convertito=false: 1
- # visita per la sezione=opinione: 1
Pratiche consigliate
- Non utilizzare nomi di chiavi duplicati tra gli slot.
- Richiama la funzione
_setCustomVar()quando può essere impostata prima di una richiesta GIF di un evento o di una visualizzazione di pagina.
In alcuni casi questa operazione potrebbe non essere possibile, pertanto dovrai impostare un'altra richiesta_trackPageview()dopo aver impostato una variabile personalizzata. Questa operazione di solito è necessaria solo nelle situazioni in cui l'utente attiva una variabile personalizzata a livello di sessione o visita, dove non è possibile raggruppare questo metodo con una chiamata di monitoraggio di visualizzazione di pagina, evento o e-commerce. - Utilizza una matrice di slot per monitorare un numero elevato di variabili personalizzate.
Se hai requisiti di monitoraggio complessi in cui è presente un mix di variabili a livello di pagina e sessione che potrebbero entrare in conflitto, devi creare una matrice slot per assicurarti che le variabili a livello di sessione non sovraccarichino inavvertitamente le variabili a livello di pagina. - Valuta la possibilità di utilizzare il monitoraggio eventi per determinate applicazioni, anziché variabili personalizzate.
Ad esempio, supponiamo che tu abbia un negozio di musica online e voglia monitorare sia le sessioni di accesso, le sessioni dei tentativi di acquisto, sia le sessioni in cui sono stati riprodotti campioni musicali. Sarebbe utile utilizzare il monitoraggio eventi per monitorare il numero di tentativi di riproduzione di musica anziché utilizzare le variabili a livello di sessione per ottenere questo risultato. In questo caso, puoi utilizzare il quarto parametro del valore della chiamata di monitoraggio degli eventi per trasmettere i dati di sessione dai tuoi cookie. - Non utilizzare le variabili a livello di sessione per monitorare un comportamento che puoi monitorare con le variabili a livello di pagina.
Ad esempio, supponiamo che tu monitori lo stato dell'accesso e dei tentativi di acquisto in base alle sessioni e che il tuo sito offra una pagina "Speciali per gli abbonati" che vuoi monitorare. Poiché una variabile personalizzata a livello di pagina mostra il numero di visite a quella determinata variabile, avrai già a disposizione il numero di visite che hanno incluso quella pagina almeno una volta.