I plug-in sono script che migliorano la funzionalità di analytics.js per semplificare la misurazione delle interazioni degli utenti. I plug-in sono in genere specifici per un insieme di funzionalità che potrebbero non essere richieste da tutti gli utenti di Google Analytics, ad esempio l'e-commerce o la misurazione interdominio, e pertanto non sono inclusi in analytics.js per impostazione predefinita.
Questa guida spiega come richiedere e utilizzare i plug-in analytics.js.
Richiedere plug-in
Il comando require prende il nome di un plug-in e lo registra per essere utilizzato con la coda di comandi di ga(). Se il plug-in accetta le opzioni di configurazione, queste possono essere trasmesse come argomento finale al comando require.
Di seguito è riportata la firma completa del comando require:
ga('[trackerName.]require', pluginName, [pluginOptions]);
Ad esempio, ecco come richiedere il plug-in E-commerce avanzato da utilizzare con il tracker predefinito:
ga('require', 'ec');
Ecco come richiedere il plug-in Funzionalità pubblicitarie per un tracker chiamato "myTracker" e passare un'opzione di configurazione che sostituisce il valore predefinito del cookie:
ga('myTracker.require', 'displayfeatures', {
cookieName: 'display_features_cookie'
});
Caricamento del codice del plug-in in corso...
Il comando require inizializza i metodi del plug-in per l'utilizzo con la coda di comandi ga(), ma non carica lo script del plug-in stesso. Se utilizzi un plug-in di terze parti o scrivi un plug-in in autonomia, dovrai aggiungere manualmente il codice del plug-in alla pagina.
Il metodo consigliato per aggiungere il codice del plug-in alla pagina è tramite un tag <script> con l'attributo async impostato per garantire che non blocchi il caricamento di altre funzionalità sul sito.
Il seguente codice richiede e carica un ipotetico plug-in per il monitoraggio dei link:
<script>
ga('create', 'UA-XXXXX-Y', 'auto');
ga('require', 'linkTracker');
ga('send', 'pageview');
</script>
<!--Note: plugin scripts must be included after the tracking snippet. -->
<script async src="/path/to/link-tracker-plugin.js"></script>
In attesa del caricamento dei plug-in
Poiché sia la libreria analytics.js sia i plug-in analytics.js vengono caricati in modo asincrono, può essere difficile sapere quando i plug-in sono completamente caricati e pronti per essere utilizzati.
La libreria analytics.js risolve questo problema interrompendo l'esecuzione della coda di comando quando rileva un comando require per un plug-in non ancora caricato. Una volta caricato il plug-in, l'esecuzione della coda continua normalmente.
Di conseguenza, è estremamente importante testare i plug-in che stai utilizzando per assicurarti che vengano caricati e vengano eseguiti correttamente. Se un plug-in non viene caricato o presenta un errore, verrà impedito l'esecuzione di tutti i comandi analytics.js successivi.
Chiamate dei plug-in
Dopo aver richiesto un plug-in, i relativi metodi diventano disponibili per l'utilizzo con la coda di comandi ga(). Ecco la firma del comando per chiamare i metodi del plug-in:
ga('[trackerName.][pluginName:]methodName', ...args);
Ad esempio, il metodo del plug-in E-commerce avanzato addProduct può essere chiamato in questo modo:
ga('ec:addProduct', {
'id': 'P12345',
'quantity': 1
});
Oppure, su un tracker denominato aggiungendo il nome del tracker alla stringa di comando:
ga('myTracker.ec:addProduct', {
'id': 'P12345',
'quantity': 1
});
Passaggi successivi
Se hai letto tutte le guide di questa sezione, dovresti conoscere la maggior parte delle funzionalità di analytics.js. La guida successiva spiega come eseguire il debug delle implementazioni analytics.js per rilevare più facilmente gli errori e capire esattamente cosa sta facendo il codice.