Dimensioni e metriche personalizzate con gtag.js

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 o livelli di giochi. In questa pagina viene descritto come inviare dimensioni e metriche personalizzate a Google Analytics.

Per inviare i valori dei parametri personalizzati a Google Analytics, mappa i parametri ai seguenti parametri di dimensione o metrica di Google Analytics personalizzata:

Custom parameter (Parametro personalizzato)	Tipo di dati	Descrizione
`dimension<Index>`	`string`	Parametro della dimensione personalizzata (ad es. `dimension3`)
`metric<Index>`	`string`	Parametro della metrica personalizzata (ad es. `metric8`)

Configurare e inviare dimensioni personalizzate

Per inviare il valore di un parametro personalizzato a Google Analytics, devi mappare un valore sul tuo sito web a un parametro di Google Analytics. A questo scopo, usa il parametro custom_map.

Per inviare una dimensione personalizzata a Google Analytics, aggiorna il config per la tua proprietà in modo da impostare il parametro custom_map per la dimensione e poi utilizza il parametro personalizzato per inviare il valore della dimensione personalizzata:

// Configures custom dimension<Index> to use the custom parameter
// 'dimension_name' for 'GA_MEASUREMENT_ID', where <Index> is a number
// representing the index of the custom dimension.
gtag('config', 'GA_MEASUREMENT_ID', {
  'custom_map': {'dimension<Index>': 'dimension_name'}
});

// Sends the custom dimension to Google Analytics.
gtag('event', 'any_event_name', {'dimension_name': dimension_value});

Sostituisci 'GA_MEASUREMENT_ID' con il tuo ID Analytics.

Ad esempio, il seguente snippet invierà la dimensione personalizzata dimension2 con valore 55 a Google Analytics:

// Maps 'dimension2' to 'age'.
gtag('config', 'GA_MEASUREMENT_ID', {
  'custom_map': {'dimension2': 'age'}
});

// Sends an event that passes 'age' as a parameter.
gtag('event', 'age_dimension', {'age': 55});

Configurare e inviare metriche personalizzate

Per inviare una metrica personalizzata a Google Analytics, aggiorna il config per la tua proprietà in modo da impostare il parametro custom_map per la metrica, poi utilizza il parametro personalizzato per inviare il valore della metrica personalizzata:

// Configures custom metric<Index> to use the custom parameter
// 'metric_name' for GA_MEASUREMENT_ID, where <Index> is a number
// representing the index of the custom metric.
gtag('config', 'GA_MEASUREMENT_ID', {
  'custom_map': {'metric<Index>': 'metric_name'}
});

// Sends the custom dimension to Google Analytics.
gtag('event', 'any_event_name', {'metric_name': metric_value});

Sostituisci 'GA_MEASUREMENT_ID' con il tuo ID Analytics.

Ad esempio, lo snippet seguente invierà la metrica personalizzata metric5 con valore 1 a Google Analytics:

// Maps 'metric5' to 'avg_page_load_time'.
gtag('config', 'GA_MEASUREMENT_ID', {
  'custom_map': {'metric5': 'avg_page_load_time'}
});

// Sends an event that passes 'avg_page_load_time' as a parameter.
gtag('event', 'load_time_metric', {'avg_page_load_time': 1});

Configurare e inviare dimensioni personalizzate e metriche personalizzate

Puoi aggiornare config della tua proprietà per mappare sia dimensioni personalizzate che metriche personalizzate:

gtag('config', 'GA_MEASUREMENT_ID', {
   'custom_map': {
     'dimension2': 'age',
     'metric5': 'avg_page_load_time'
   }
});

gtag('event', 'foo', {'age': 55, 'avg_page_load_time': 1});