I plugin sono script che migliorano la funzionalità di analytics.js per aiutare a misurare l’interazione dell’utente. I plugin sono in genere specifici per una serie di caratteristiche che potrebbero non essere richieste da tutti gli utenti di Google Analytics, come l’e-commerce o la misurazione di più domini, e quindi non sono inclusi in analytics.js per impostazione predefinita.

Questa guida spiega come richiedere e utilizzare i plugin di analytics.js.

Richiedere i plugin

Il comando require prende il nome di un plugin e lo registra per l’uso nella ga() coda dei comandi. Se il plugin accetta opzioni di configurazione, queste opzioni possono essere passate come argomento finale al comando require.

Quella che segue è la firma completa del comando require:

ga('require', pluginName, );

Per esempio, ecco come si potrebbe richiedere il plugin Enhanced Ecommerce per l’uso con il tracker di default:

ga('require', 'ec');

Ed ecco come si potrebbe richiedere il plugin Advertising Features per un tracker chiamato “myTracker” e passare un’opzione di configurazione che sovrascrive il valore predefinito del nome del cookie:

ga('myTracker.require', 'displayfeatures', { cookieName: 'display_features_cookie'});

Caricamento del codice del plugin

Il comando require inizializza i metodi del plugin da usare con la coda dei comandi ga(), ma non carica lo script del plugin stesso. Se stai usando un plugin di terze parti, o stai scrivendo un plugin tu stesso, dovrai aggiungere manualmente il codice del plugin alla pagina.

Il metodo raccomandato per aggiungere il codice del plugin alla pagina è tramite un tag <script> con l’attributo async impostato per assicurarsi che non blocchi il caricamento di altre funzioni sul tuo sito.

Il seguente codice richiede e carica un ipotetico link tracking plugin:

<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 plugin

Perché sia la libreria analytics.js che i plugin analytics.js sono caricati in modo asincrono, può essere una sfida sapere quando i plugin sono completamente caricati e pronti per essere utilizzati.

La libreria analytics.js risolve questo problema fermando l’esecuzione della coda dei comandi quando incontra un require comando per un plugin che non è ancora caricato. Una volta che il plugin è caricato, l’esecuzione della coda continua normalmente.

Di conseguenza, è estremamente importante testare i plugin che stai usando per assicurarti che siano caricati ed eseguiti correttamente. Se un plugin non riesce a caricarsi o ha un errore, impedirà l’esecuzione di tutti i successivi comandi di analytics.js.

Chiamare i metodi dei plugin

Dopo aver richiesto un plugin, i suoi metodi diventano disponibili per l’uso con la ga() coda dei comandi. Ecco la firma di comando per chiamare i metodi dei plugin:

ga('methodName', ...args);

Per esempio, il metodo addProduct del plugin Enhanced Ecommerce può essere chiamato così:

ga('ec:addProduct', { 'id': 'P12345', 'quantity': 1});

O su un tracker nominato aggiungendo il nome del tracker alla stringa di comando:

ga('myTracker.ec:addProduct', { 'id': 'P12345', 'quantity': 1});

Se hai letto tutte le guide in questa sezione, dovresti avere familiarità con la maggior parte delle caratteristiche di analytics.js. La prossima guida spiega come eseguire il debug delle vostre implementazioni di analytics.js per individuare più facilmente gli errori e vedere esattamente cosa sta facendo il vostro codice.