Aug 17 2008

funzioni: _addItem()

autore: categoria: funzioni tag: ,

La funzione di oggi serve nel caso in cui abbiamo attivato i rapporti e-commerce dalle opzioni generali del profilo, e appunto popola i relativi report. _addItem(id_ordine, sku, nome, categoria, prezzo, quantità) aggiunge un elemento acquistato da un visitatore all’oggetto di tracciamento specificato; _addItem traccia gli oggetti per sku (Stock Keeping Unit, identificativo univoco del prodotto), per cui se nella stessa sessione viene chiamata due volte per lo stesso sku, viene registrato soltanto l’ultimo oggetto. La funzione prende sei parametri, tutte stringhe, in ingresso, che più precisamente sono:

  • id_ordine: l’identificativo dell’ordine (fortemente consigliato)
  • sku: l’identificativo univoco dell’oggetto (obbligatorio)
  • nome: il nome dell’oggetto (facoltativo)
  • categoria: la categoria merceologica dell’oggetto, se presente (facoltativo)
  • prezzo: il prezzo dell’oggetto (obbligatorio)
  • quantità: il numero di oggetti acquistati (obbligatorio)

Un esempio di uso della funzione è questo:

pageTracker._addItem(
   "12345", // id_ordine
   "TA2676", //sku
   "GAin30sec", // nome
   "Libri", // categoria
   "35.99", // prezzo
   "1"  //quantità
 );

Per i parametri non obbligatori, è facoltativo solo l’inserimento del valore all’interno delle virgolette, non la presenza del parametro nella chiamata alla funzione. Per intenderci, l’esempio soprastante si può modificare così:

pageTracker._addItem(
   "12345", // id_ordine
   "TA2676", //sku
   "",
   "",
   "35.99", // prezzo
   "1"  //quantità
 );

Il parametro id_ordine è fortemente consigliato poiché le documentazioni ufficiali sono contrastanti: la mia interpretazione è che si possa omettere solo nel caso di chiamata a _addItem() senza la relativa _addTrans(), per cui in casi tutto sommato abbastanza anomali. Nelle implementazioni che ho visto il parametro era sempre presente, per cui io consiglio di inserirlo.

Condividi l'articolo:

8 Commenti

  1. Buonasera Marco, forse questo non è il posto giusto ma io ho un e-commerce ma non riesco a capire cosa queste funzioni supplementari facciano e come mi possano essere utili.
    Grazie, ciao Daniele

  2. servono a popolare correttamente la sezione di rapporti “e-commerce”, che ti dà una serie di informazioni aggiuntive che diversamente non avresti: ad esempio il valore degli ordini per sorgente, o per keyword. Quali articoli siano più comprati per paese di origine del visitatore, quali articoli sono maggiormente aggiunti e poi tolti dal carrello, eccetera…

  3. Ciao Marco
    vorrei un’informazione: queste funzioni vanno aggiunte all’interno dello script principale di analytics?
    E come si fa ad agganciarle ai vari elementi della pagina? (ID Ordine, ecc.)?

  4. di norma è il linguaggio lato server che “popola” i parametri della funzione.

  5. Comunque le varie funzioni vanno richiamate all’interno dello script di monitoraggio, giusto? scusami ma non sono una programmatrice :/

  6. si. non è obbligatorio, ma di norma si fa così.

  7. ciao Marco,
    Io ho aggiunto questa funzione nell’ecommerce di un cliente ma quando accedo agli analytics nella sezione ecommerce non vedo nulla, da cosa può dipendere questo?
    Oltre a questa funzione ne devo aggiungere altre?

    Grazie

  8. e si, il trittico per l’ecommerce è _addItem, _addTrans e _trackTrans

Scrivi un Commento