Monitoraggio e-commerce - Monitoraggio web (ga.js)

ga.js è una libreria precedente. Se stai iniziando una nuova implementazione, ti consigliamo di utilizzare la versione più recente di questa libreria, analytics.js. Per le implementazioni esistenti, scopri come eseguire la migrazione da ga.js ad analytics.js.

Prima che Google Analytics possa segnalare l'attività di e-commerce per il tuo sito web, devi attivare il monitoraggio e-commerce nella pagina delle impostazioni della vista (profilo) per il tuo sito web. Successivamente, devi implementare i metodi di monitoraggio e-commerce ga.js nelle pagine del carrello degli acquisti o tramite il software di e-commerce. La raccolta di metodi di e-commerce collabora per inviare le informazioni sulle transazioni di ciascun utente al database di Google Analytics nel momento in cui si verifica. In questo modo, Analytics può collegare una sorgente di referral specifica a una conversione o acquisto. La maggior parte dei motori di e-commerce basata su modelli può essere modificata per includere queste informazioni nascoste nella pagina di conferma dell'ordine.

Processo generale

La procedura di base per monitorare l'e-commerce con Google Analytics può essere descritta al meglio riassumendo i tre metodi richiesti per il monitoraggio delle transazioni e-commerce sul tuo sito. Questi metodi sono descritti nell'ordine in cui devi attivarli nel carrello degli acquisti o nel software di e-commerce.

1. Crea un oggetto Transaction.

   Utilizza il metodo _addTrans() per avviare un oggetto transazione. L'oggetto transazione memorizza tutte le informazioni correlate a una singola transazione, ad esempio l'ID transazione, le spese di spedizione e l'indirizzo di fatturazione. Le informazioni nell'oggetto transazione sono associate ai suoi articoli tramite gli ID transazione della transazione e tutti gli articoli, che devono essere lo stesso ID.

   Nota: le informazioni geografiche facoltative che possono essere incluse in un oggetto transazione non vengono utilizzate per inserire i dati geografici nei report di Google Analytics, ma possono essere utilizzati in un filtro vista.
2. Aggiungere elementi alla transazione.

   Il metodo _addItem() monitora le informazioni su ogni singolo articolo nel carrello degli utenti e associa l'articolo a ciascuna transazione tramite il campo transactionId. Questo metodo monitora i dettagli di un articolo specifico, ad esempio SKU, prezzo, categoria e quantità.

3. Invia la transazione ai server di Analytics.

   Il metodo _trackTrans() conferma che un acquisto è stato effettuato e che tutti i dati creati nell'oggetto Transaction sono finalizzati come transazioni.

Esistono molti modi per recuperare queste informazioni dal motore di e-commerce. Alcuni motori di e-commerce scrivono le informazioni sugli acquisti in un modulo nascosto che puoi utilizzare, altre le conservano in un database che puoi recuperare e altri le memorizzano in un cookie. Alcuni dei motori di e-commerce più popolari che conoscono Google Analytics forniscono i propri moduli per semplificare il monitoraggio degli ordini per Analytics.

Linee guida

Tieni presente i seguenti aspetti durante l'implementazione del monitoraggio e-commerce.

• Il codice SKU è un parametro obbligatorio per ogni articolo che viene aggiunto alla transazione.
  Se una transazione contiene più articoli e lo SKU non viene fornito per ogni elemento, viene inviata una richiesta GIF solo per l'ultimo elemento aggiunto alla transazione per cui viene fornito uno SKU. Inoltre, se l'inventario contiene articoli diversi con lo stesso SKU e un visitatore li acquista entrambi, riceverai i dati solo per gli elementi aggiunti più di recente. Per questo motivo, devi assicurarti che ogni articolo che offri abbia uno SKU univoco.
• L'elenco di argomenti per _addTrans() e _addItem() corrisponde alla posizione.
  Anche se non tutti gli argomenti sono obbligatori, devi fornire un segnaposto vuoto per gli argomenti non specificati per evitare errori. Ad esempio, aggiungi un articolo contenente solo ID transazione, SKU, prezzo e quantità come segue:

  _addItem("54321", "12345", "", "", "55.95", "1");

• I valori dei parametri price e total non rispettano la formattazione della valuta.
  Per entrambi i parametri, la prima istanza di una virgola o di un punto indica un valore frazionario. Pertanto, se fornisci 1,996.00 come valore del parametro total, viene registrato come 1.996, non come 1996,00 $. Poiché il valore non è affiliato a nessuna valuta, il software di e-commerce deve gestire qualsiasi conversione di valuta prima di trasmettere i dati ad Analytics.
• Se implementi il monitoraggio e-commerce e utilizzi un carrello degli acquisti di terze parti, probabilmente dovrai configurare anche il monitoraggio interdominio.
  Per informazioni dettagliate, consulta la sezione su "Monitoraggio interdominio".
• Sebbene non sia strettamente obbligatorio, è buona norma chiamare _trackPageview() nella pagina di ricevuta se vuoi associare la pagina specifica ai dati delle transazioni.

Esempio completo

Il seguente esempio illustra una configurazione di esempio di monitoraggio e-commerce nella pagina di una ricevuta utilizzando tutti e tre i metodi. L'uso di _trackPageview() associa la transazione alla pagina intitolata Ricevuta per l'acquisto di abbigliamento da Acme Abbigliamento.

Sintassi asincrona (consigliata)

<html>
<head>
<title>Receipt for your clothing purchase from Acme Clothing</title>
<script type="text/javascript">

  var _gaq = _gaq || [];
  _gaq.push(['_setAccount', 'UA-XXXXX-X']);
  _gaq.push(['_trackPageview']);
  _gaq.push(['_addTrans',
    '1234',           // transaction ID - required
    'Acme Clothing',  // affiliation or store name
    '11.99',          // total - required
    '1.29',           // tax
    '5',              // shipping
    'San Jose',       // city
    'California',     // state or province
    'USA'             // country
  ]);

   // add item might be called for every item in the shopping cart
   // where your ecommerce engine loops through each item in the cart and
   // prints out _addItem for each
  _gaq.push(['_addItem',
    '1234',           // transaction ID - required
    'DD44',           // SKU/code - required
    'T-Shirt',        // product name
    'Green Medium',   // category or variation
    '11.99',          // unit price - required
    '1'               // quantity - required
  ]);
  _gaq.push(['_trackTrans']); //submits transaction to the Analytics servers

  (function() {
    var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
    ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
    var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
  })();

</script>
</head>
<body>

  Thank you for your order.  You will receive an email containing all your order details.

</body>
</html>

Sintassi tradizionale

<html>
<head>
<title>Receipt for your clothing purchase from Acme Clothing</title>
</head>

<body>

  Thank you for your order.  You will receive an email containing all your order details.


<script type="text/javascript">
  var gaJsHost = (("https:" == document.location.protocol ) ? "https://ssl." : "http://www.");
  document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
</script>
<script type="text/javascript">
try{
  var pageTracker = _gat._getTracker("UA-xxxxx-x");
  pageTracker._trackPageview();
  pageTracker._addTrans(
      "1234",            // transaction ID - required
      "Womens Apparel",  // affiliation or store name
      "11.99",           // total - required
      "1.29",            // tax
      "15.00",           // shipping
      "San Jose",        // city
      "California",      // state or province
      "USA"              // country
    );


   // add item might be called for every item in the shopping cart
   // where your ecommerce engine loops through each item in the cart and
   // prints out _addItem for each 
   pageTracker._addItem(
      "1234",           // transaction ID - necessary to associate item with transaction
      "DD44",           // SKU/code - required
      "T-Shirt",        // product name
      "Olive Medium",   // category or variation
      "11.99",          // unit price - required
      "1"               // quantity - required
   );

   pageTracker._trackTrans(); //submits transaction to the Analytics servers
} catch(err) {}
</script>
</body>
</html>

 

Torna all'inizio

Valute locali

Per impostazione predefinita, puoi configurare una valuta globale comune per tutte le transazioni e gli articoli tramite l'interfaccia web di gestione di Google Analytics. Per impostazione predefinita, viene utilizzata la valuta globale per tutti gli articoli e le transazioni. Per i siti web che eseguono transazioni in più valute, la funzionalità di monitoraggio e-commerce ga.js consente di specificare la valuta locale della transazione utilizzando il seguente comando, prima che la chiamata a _trackTrans venga eseguita:

_gaq.push(['_set', 'currencyCode', 'EUR']);

La valuta locale deve essere specificata nello standard ISO 4217. Leggi il documento Riferimento ai codici di valuta per un elenco completo delle valute di conversione supportate.