Questa guida descrive come inviare dimensioni e metriche personalizzate utilizzando analytics.js.
Panoramica
Le dimensioni e le metriche personalizzate sono un modo efficace per inviare dati personalizzati a Google Analytics. Gli sviluppatori web possono utilizzare dimensioni e metriche personalizzate per segmentare e misurare le differenze tra utenti che hanno eseguito l'accesso e non hanno eseguito l'accesso, autori di pagine, livelli di giochi o qualsiasi altro dato aziendale presente in una pagina.
Per una panoramica completa del funzionamento di questa funzionalità, consulta la pagina Riferimento alle funzionalità di dimensioni e metriche personalizzate.
Per inviare i dati sulle dimensioni e sulle metriche personalizzate, utilizza uno o entrambi i seguenti valori:
| Nome campo | Tipo di valore | Obbligatorio | Descrizione |
|---|---|---|---|
| dimensione[0-9]+ | testo | No | L'indice della dimensione. A ogni dimensione personalizzata è associato un indice.Possono essere presenti al massimo 20 dimensioni personalizzate (200 per gli account Analytics 360). Il suffisso dell'indice deve essere un numero intero positivo maggiore di 0 (ad es. dimension3). |
| metrica[0-9]+ | numero intero | No | L'indice della metrica. A ogni metrica personalizzata è associato un indice. È possibile avere un massimo di 20 metriche personalizzate (200 per gli account Analytics 360). Il suffisso dell'indice deve essere un numero intero positivo maggiore di 0 (ad es. metric5). |
Implementazione
Devi prima configurare una dimensione o una metrica personalizzata tramite l'interfaccia di gestione di Google Analytics. Dopo la configurazione, alla dimensione o alla metrica personalizzata verrà assegnato un indice univoco che identifica e differenzia una dimensione o una metrica personalizzata da un'altra. Potrai poi utilizzare l'indice nella libreria analytics.js per inviare i dati relativi a una determinata dimensione o metrica personalizzata.
Invio dati
I dati sulle dimensioni o sulle metriche personalizzate possono essere inviati solo con un hit esistente. Ad esempio, per inviare una dimensione personalizzata per un hit di tipo pageview con l'indice 15, devi utilizzare:
ga('send', 'pageview', {
'dimension15': 'My Custom Dimension'
});
Per inviare una metrica personalizzata per un hit di tipo event con l'indice 18, utilizza:
ga('send', 'event', 'category', 'action', {
'metric18': 8000
});
Se la metrica personalizzata è configurata in modo da avere un tipo di valuta, puoi inviare valori decimali:
ga('send', 'event', 'category', 'action', {
'metric19': 24.99
});
In alcuni casi, potresti voler inviare una dimensione o una metrica personalizzata con tutti gli hit di una determinata pagina (o per la durata dell'oggetto tracker). In questo caso, puoi impostare la dimensione o le metriche personalizzate utilizzando il comando set:
ga('set', 'dimension5', 'custom data');
Per set valori sia per una dimensione che per una metrica, puoi utilizzare:
ga('set', {
'dimension5': 'custom dimension data',
'metric5': 'custom metric data'
});
Per conoscere il formato specifico per l'invio di questi dati, consulta la sezione Dimensioni e metriche personalizzate nel documento Riferimento ai campi.
Esempio
Un ottimo esempio di quando utilizzare le dimensioni personalizzate è avere un sito basato sui contenuti con molti autori. In qualità di analista, potresti voler capire quali autori dispongono dei contenuti più popolari. Per rispondere a questa domanda, puoi visualizzare un report che confronta le visualizzazioni di pagina per autore. Sebbene i dati sull'autore non siano disponibili per impostazione predefinita in Google Analytics, puoi inviarli come dimensione personalizzata a ogni visualizzazione di pagina.
Il primo passaggio della soluzione consiste nel configurare una nuova dimensione personalizzata nell'interfaccia di gestione. Il nome deve essere author e l'ambito sarà di tipo hit. Dopo la configurazione, alla nuova dimensione personalizzata verrà assegnato un indice. Per questo esempio, supponiamo che l'indice sia 5.
Ora che la dimensione personalizzata author è stata configurata e assegnato un indice, può essere utilizzata con la libreria analytics.js per inviare i dati dell'autore come dimensione personalizzata. Ad esempio, se la pagina è scritta in PHP, l'autore effettivo della pagina verrà probabilmente memorizzato in una variabile PHP come $author. Nel modello PHP, puoi utilizzare questa variabile autore per passare il valore autore alla dimensione personalizzata:
ga('send', 'pageview', {
'dimension5': '<?=$author?>'
});