I plug-in sono script che migliorano la funzionalità di analytics.js per facilitare la misurazione dell'interazione degli utenti. In genere, i plug-in sono specifici per un insieme di funzionalità che potrebbero non essere necessarie per tutti gli utenti di Google Analytics, ad esempio l'ecommerce o la misurazione interdominio. Pertanto, i plug-in non sono inclusi in analytics.js per impostazione predefinita.
Questa guida spiega come richiedere e utilizzare i plug-in analytics.js.
Richiesta di plug-in
Il comando require prende il nome di un plug-in e lo registra per l'utilizzo con la coda dei comandi ga(). Se il plug-in accetta le opzioni di configurazione, queste possono essere passate 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 l'utilizzo del plug-in E-commerce avanzato con il tracker predefinito:
ga('require', 'ec');
Ecco come richiedere il plug-in delle funzioni pubblicitarie per un tracker denominato "myTracker" e passare un'opzione di configurazione che sostituisca il valore predefinito del nome del cookie:
ga('myTracker.require', 'displayfeatures', {
cookieName: 'display_features_cookie'
});
Caricamento del codice plug-in
Il comando require inizializza i metodi del plug-in da utilizzare con la coda dei comandi ga(), ma non carica lo script del plug-in. Se utilizzi un plug-in di terze parti o scrivi autonomamente un plug-in, devi aggiungere manualmente il codice del plug-in alla pagina.
Il metodo consigliato per aggiungere il codice del plug-in alla pagina consiste nell'utilizzare un tag <script> con l'attributo async impostato, in modo da garantire che non blocchi il caricamento di altre funzionalità sul tuo sito.
Il seguente codice richiede e carica un plug-in ipotetico di 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 che 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 come di consueto.
Di conseguenza, è estremamente importante testare i plug-in che utilizzi per assicurarti che vengano caricati ed eseguiti correttamente. Se un plug-in non viene caricato o presenta un errore, impedirà l'esecuzione di tutti i comandi analytics.js successivi.
Chiamata ai metodi plug-in
Dopo aver richiesto un plug-in, i relativi metodi diventano disponibili per l'utilizzo con la coda dei comandi ga(). Ecco la firma del comando per chiamare i metodi plug-in:
ga('[trackerName.][pluginName:]methodName', ...args);
Ad esempio, il metodo addProduct del plug-in E-commerce avanzato può essere chiamato come segue:
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 prossima guida spiega come eseguire il debug delle implementazioni di analytics.js per rilevare più facilmente gli errori e capire esattamente cosa sta facendo il tuo codice.