Codice di monitoraggio: e-commerce

Nota: questo riferimento descrive i metodi utilizzati per l'e-commerce nei report di Google Analytics. Per scoprire di più sulla configurazione del monitoraggio e-commerce, consulta la pagina Monitoraggio e-commerce.

Metodi di e-commerce GATC

  • _addItem(transactionId, sku, name, category, price, quantity)
  • _addTrans(transactionId, affiliation, total, tax, shipping, city, state, country)
  • _trackTrans()

Dettagli del metodo

_addItem()

    _addItem(transactionId, sku, name, category, price, quantity)

    Utilizza questo metodo per monitorare gli articoli acquistati dai visitatori del tuo sito di e-commerce. Questo metodo monitora i singoli articoli in base al relativo SKU. Ciò significa che il parametro sku è obbligatorio. Questo metodo associa quindi l'elemento all'oggetto Transaction padre tramite l'argomento transactionId.

    Gli argomenti di questo metodo vengono soddisfatti in base alla posizione, quindi assicurati di fornire tutti i parametri, anche se alcuni hanno un valore vuoto.

    Questo metodo non esegue calcoli aggiuntivi, ad esempio calcoli di quantità. Pertanto, tieni a mente le seguenti best practice:

    • Calcola quantità con il tuo software.
      • Nella stessa sessione, gli elementi duplicati aggiunti (per SKU) non influiscono sul calcolo della quantità.
      • Nella stessa sessione, se vengono aggiunti due elementi ciascuno con lo stesso SKU, le informazioni sul primo elemento vengono sostituite con la seconda.
    • Assicurati che ogni articolo dell'inventario abbia uno SKU univoco.
      • Se il tuo 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.
    • Assicurati che sia configurato un oggetto Transaction principale per gli elementi aggiunti.
      • Se non esiste un oggetto Transaction padre per un elemento aggiunto, quest'ultimo viene associato a un oggetto Transaction vuoto.
      • Se viene aggiunto un articolo senza un oggetto Transaction principale, i report mostreranno i prodotti per SKU non associati ad alcuna transazione.
    • Fornisci sempre un valore per il parametro name.
      • Mentre il parametro name non è obbligatorio, gli articoli aggiunti a una transazione senza un parametro name non vengono visualizzati nella suddivisione dei prodotti per una transazione. Anche se continuerai a visualizzare le entrate totali della transazione, non potrai visualizzare a quante entrate ha contribuito un determinato articolo al totale della transazione.
       _gaq.push(['_addItem',
      '1234',         // transaction ID - necessary to associate item with transaction
      'DD44',         // SKU/code - required
      'T-Shirt',      // product name - necessary to associate revenue with product
      'Olive Medium', // category or variation
      '11.99',        // unit price - required
      '1'             // quantity - required
   ]);

    Parametri

      String   transactionId Facoltativo ID ordine della transazione da associare all'articolo.
      String   sku Obbligatorio. Codice SKU dell'articolo.
      String   name Obbligatorio. Nome del prodotto. Obbligatorio per visualizzare i dati nel report dettagliato del prodotto.
      String   category Facoltativo. Categoria di prodotto.
      String   price Obbligatorio. Prezzo del prodotto.
      String   quantity Obbligatorio. Quantità di acquisto.

_addTrans()

    _addTrans(transactionId, affiliation, total, tax, shipping, city, state, country)
    Crea un oggetto Transaction con i valori specificati. Come per _addItem(), questo metodo gestisce solo il monitoraggio delle transazioni e non fornisce funzionalità di e-commerce aggiuntive. Di conseguenza, se la transazione è un duplicato di una transazione esistente per la sessione in questione, i valori precedenti delle transazioni vengono sovrascritti con i nuovi valori delle transazioni. Gli argomenti di questo metodo vengono abbinati in base alla posizione, quindi assicurati di fornire tutti i parametri, anche se alcuni hanno un valore vuoto. 
       _gaq.push(['_addTrans',
      '1234',           // transaction ID - required
      'Womens Apparel', // affiliation or store name
      '28.28',          // total - required; Shown as "Revenue" in the
                        // Transactions report. Does not include Tax and Shipping.
      '1.29',           // tax
      '15.00',          // shipping
      'San Jose',       // city
      'California',     // state or province
      'USA'             // country
   ]);

    Parametri

      String   transactionId Obbligatorio. Numero ID interno univoco per questa transazione.
      String   affiliation Facoltativo. Affiliazione del partner o del negozio (non definita se assente).
      String   total Obbligatorio. Importo totale in dollari della transazione. Non include tasse e spese di spedizione e deve essere considerato "Grande Total" solo se includi esplicitamente le spese di spedizione e le tasse.
      String   tax Facoltativo. Importo delle imposte sulla transazione.
      String   shipping Facoltativo. Spese di spedizione per la transazione.
      String   city Facoltativo. Città da associare alla transazione.
      String   state Facoltativo. Stato da associare alla transazione.
      String   country Facoltativo. Paese da associare alla transazione.

    returns

      _gat.GA_EComm_.Transactions_ L'oggetto Transaction che è stato creato o modificato.

_trackTrans()

    _trackTrans()
    Invia i dati sulle transazioni e sugli articoli al server di Google Analytics. Questo metodo deve essere chiamato dopo _trackPageview() e utilizzato in combinazione con i metodi _addItem() e addTrans(). Deve essere richiamato dopo aver configurato gli articoli e le transazioni. 
    _gaq.push(['_setAccount', 'UA-XXXXX-X']);
_gaq.push(['_trackPageview']);
_gaq.push(['_addTrans',
   '1234',           // transaction ID - required
   'Womens Apparel', // affiliation or store name
   '28.28',          // total - required
   '1.29',           // tax
   '15.00',          // shipping
   'San Jose',       // city
   'California',     // state or province
   'USA'             // country
]);
_gaq.push(['_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
]);
_gaq.push(['_trackTrans']);