Aggiungere Adobe Analytics

La configurazione dell'estensione, che gestisce le impostazioni della libreria principale AppMeasurement.js e può impostare variabili globali

Azioni di regola per eseguire le operazioni seguenti:

1. Imposta variabili
2. Cancella variabili
3. Inviare il beacon di Analytics

Vai a Estensioni > Catalogo

Individua l’estensione Adobe Analytics

Fai clic su Installa

In Gestione libreria > Suite per report, immetti gli ID suite per report che desideri utilizzare con ogni ambiente di tag. Se gli utenti hanno accesso ad Adobe Analytics, tieni presente che quando inizi a digitare nella casella verrà visualizzato un elenco precompilato di tutte le suite di rapporti. (È possibile utilizzare una suite per report per tutti gli ambienti in questa esercitazione, ma in uno scenario reale dovresti utilizzare suite per report separate, come illustrato nell’immagine seguente).

In Generale > Server di monitoraggio, immettere il server di monitoraggio, ad esempio tmd.sc.omtrdc.net. Immetti Server di tracciamento SSL se il sito supporta https://.

Nella sezione Variabili globali, in Impostazioni aggiuntive, imposta la variabile Nome pagina utilizzando l'elemento dati Page Name. Fai clic sull’icona per aprire il modale e scegli l’Page Nameelemento dati della pagina).

Fai clic su Salva nella libreria

Vai alla sezione Regole nel menu di navigazione a sinistra, quindi fai clic su Aggiungi regola

Denomina la regola All Pages - DOM Ready

Fai clic su Eventi > Aggiungi per aprire la schermata Event Configuration

Seleziona Tipo evento > DOM Ready (tieni presente che l'ordine della regola è "50")

Fai clic su Mantieni modifiche

In Azioni, fai clic su per aggiungere una nuova azione.

Seleziona Estensione > Adobe Analytics

Seleziona Tipo azione > Invia beacon

Lascia Tracking impostato su s.t(). Tieni presente che se desideri effettuare una chiamata s.tl() in una regola di evento clic, puoi farlo utilizzando anche l’azione Invia beacon.

Fai clic sul pulsante Mantieni modifiche

Fai clic su Salva nella libreria e genera

Apri il sito Luma nel browser Chrome.

Fai clic sull'icona Debugger per aprire Adobe Experience Cloud Debugger

Accertati che Debugger mappi la proprietà tag nell'ambiente di sviluppo your, come descritto nella lezione precedente

Fai clic per aprire la scheda Analytics.

Espandi il nome della suite per report per mostrare tutte le richieste ad essa effettuate.

Conferma l’avvio della richiesta con la variabile e il valore Nome pagina.

Fai clic su Elementi dati nel menu di navigazione a sinistra

Fai clic su Aggiungi elemento dati

Denomina l’elemento dati Page Type

Seleziona Tipo elemento dati > Variabile JavaScript

Utilizza digitalData.page.category.type come nome variabile JavaScript

Controlla le opzioni Pulisci testo e Forza lettere minuscole

Fai clic su Salva nella libreria

Fai clic su Elementi dati nel menu di navigazione a sinistra

Fai clic su Aggiungi elemento dati

Denomina l’elemento dati Product Id

Seleziona Tipo elemento dati > Variabile JavaScript

Utilizza digitalData.product.0.productInfo.sku come nome variabile JavaScript

Controlla le opzioni Pulisci testo e Forza lettere minuscole

Fai clic su Salva nella libreria

Vai alla pagina Estensioni > Catalogo.

Trova l'estensione Adobe Analytics Product String dai servizi Adobe Consulting e fai clic su Installa

Leggi le istruzioni.

Fai clic su Salva nella libreria

Vai alla sezione Regole nel menu di navigazione a sinistra, quindi fai clic su Aggiungi regola

Denomina la regola Product Details - DOM Ready - 40

Fai clic su Eventi > Aggiungi per aprire la schermata Event Configuration

Seleziona Tipo evento > DOM Ready

Imposta Ordine su 40, in modo che la regola venga eseguita prima della regola contenente l'azione Analytics > Invia beacon

Fai clic su Mantieni modifiche

In Condizioni, fai clic su per aprire la schermata Condition Configuration

1. Seleziona Tipo condizione > Confronto valori

2. Utilizza il selettore degli elementi dati, scegli Page Type nel primo campo.

3. Seleziona Contiene dal menu a discesa operatore di confronto

4. Nel tipo di campo successivo, digita product-page (questa è la parte univoca del valore di Page Type estratto dal livello dati su PDP).

5. Fai clic su Mantieni modifiche

   

In Azioni, fai clic su per aggiungere una nuova azione.

Seleziona Estensione > Adobe Analytics Product String

Seleziona Tipo azione > Imposta s.products

Nella sezione Analytics E-commerce Event, seleziona prodView

Nella sezione Variabili del livello dati per i dati del prodotto, utilizza il selettore Elemento dati per scegliere l'elemento dati Product Id

Fai clic su Mantieni modifiche

In Azioni, fai clic su per aggiungere una nuova azione.

Seleziona Estensione > Adobe Analytics

Seleziona Tipo azione > Imposta variabili

Seleziona eVar1 > Imposta come e immetti product detail page

Imposta event1, lasciando vuoti i valori facoltativi

In Eventi, fai clic sul pulsante Aggiungi un altro

Imposta l'evento prodView, lasciando vuoti i valori facoltativi

Fai clic su Mantieni modifiche

Fai clic su Salva nella libreria e genera

Apri il sito Luma nel browser Chrome.

Vai a qualsiasi pagina dei dettagli del prodotto.

Fai clic sull'icona Debugger per aprire Adobe Experience Cloud Debugger

Fai clic sulla scheda Analytics.

Espandi la suite per report.

Nota le variabili Product Detail attualmente presenti nel debugger, in particolare che eVar1 è stato impostato su “product detail page”, che la variabile Events è stata impostata su “event1” e “prodView” e che la variabile prodotti è impostata con l’ID prodotto del prodotto che stai visualizzando e che il nome pagina è ancora impostato dall’estensione di Analytics.

Vai alla sezione Regole nel menu di navigazione a sinistra, quindi fai clic su Aggiungi regola

Denomina la regola Homepage - Featured Products enters Viewport

Fai clic su Eventi > Aggiungi per aprire la schermata Event Configuration

Selezionare Tipo evento > Enters Viewport. Viene visualizzato un campo in cui è necessario inserire il selettore CSS che identificherà l’elemento nella pagina che dovrebbe attivare la regola, quando si entra nella visualizzazione nel browser.

Torna alla home page di Luma e scorri verso il basso fino alla sezione Prodotti in primo piano.

Fare clic con il pulsante destro del mouse sullo spazio tra il titolo "PRODOTTI IN PRIMO PIANO" e gli elementi di questa sezione e selezionare Inspect dal menu di scelta rapida. Questo ti porterà vicino a ciò che desideri.

Proprio lì intorno, possibilmente sotto la sezione selezionata, devi trovare un div con class="we-productgrid aem-GridColumn aem-GridColumn--default--12". Individua questo elemento.

Fai clic con il pulsante destro del mouse su questo elemento e seleziona Copia > Copia selettore

Torna ai tag e incolla questo valore dagli Appunti nel campo con etichetta Elements matching the CSS selector.

1. Per inciso, spetta a te decidere come identificare i selettori CSS. Questo metodo è un po’ fragile, in quanto alcune modifiche sulla pagina potrebbero interrompere il selettore. Tienilo presente quando utilizzi qualsiasi selettore CSS nei tag.

Fai clic su Mantieni modifiche

In Condizioni, fai clic su per aggiungere una nuova condizione.

Seleziona Tipo condizione > Confronto valori

Utilizza il selettore degli elementi dati, scegli Page Name nel primo campo.

Seleziona Uguale a dal menu a discesa dell'operatore di confronto

Nel campo successivo, digita content:luma:us:en (si tratta del nome della pagina principale che è stato estratto dal livello dati, vogliamo che questa regola venga eseguita solo sulla pagina iniziale).

Fai clic su Mantieni modifiche

In Azioni, fai clic su per aggiungere una nuova azione.

Seleziona Estensione > Adobe Analytics

Seleziona Tipo azione > Imposta variabili

Imposta eVar3 su Home Page - Featured Products.

Imposta prop3 su Home Page - Featured Products.

Imposta la variabile Events su event3.

Fai clic su Mantieni modifiche

In Azioni, fai clic su per aggiungere una nuova azione.

Seleziona Estensione > Adobe Analytics

Seleziona Tipo azione > Invia beacon

Scegli l'opzione di tracciamento s.tl()

Nel campo Nome collegamento immettere Scrolled down to Featured Products. Questo valore verrà inserito nel report Collegamenti personalizzati in Analytics.

Fai clic su Mantieni modifiche

Fai clic su Salva nella libreria e genera

Apri il sito Luma nel browser Chrome e accertati di essere nella parte superiore della pagina iniziale.

Fai clic sull'icona debugger per aprire Adobe Experience Cloud Debugger

Fai clic sulla scheda Analytics.

Espandi l’hit della suite per report.

Osservate l’hit della visualizzazione pagina normale per la pagina iniziale con il nome della pagina, ecc. (ma niente in eVar3 o prop3).

Lasciando aperto Debugger, scorri verso il basso sul sito fino a visualizzare la sezione Prodotti in primo piano

Visualizza di nuovo il Debugger, ora dovrebbe essere presente un altro hit Analytics. Questo hit deve avere i parametri associati all’hit s.tl() configurato, ovvero:

1. LinkType = "link_o" (questo significa che l’hit è un hit di collegamento personalizzato, non un hit di visualizzazione della pagina).

2. LinkName = "Scrolled down to Featured Products"

3. prop3 = "Home Page - Featured Products"

4. eVar3 = "Home Page - Featured Products"

5. Events = "event3"

   

Vai a Estensioni > Installate

Nell'estensione Adobe Analytics, fai clic su Configura

In Gestione libreria, selezionare la casella con etichetta Make tracker globally accessible. Come è possibile vedere nel fumetto di aiuto, questo determina una delimitazione del tracker a livello globale in window.s, importante quando si fa riferimento a esso nel JavaScript del cliente.

Mentre ti trovi ancora nell’estensione Analytics, scorri verso il basso ed espandi la sezione con titolo Configure Tracker Using Custom Code.

Fai clic su Apri editor

Incolla il seguente codice nell’editor di codice:

/* Plugin Config */
s.usePlugins=true
s.doPlugins=function(s) {
/* Add calls to plugins here */
}

Tieni aperta questa finestra per il passaggio successivo

Copia il seguente codice.

/* Adobe Consulting Plugin: getValOnce v2.01 */
s.getValOnce=function(vtc,cn,et,ep){if(vtc&&(cn=cn||"s_gvo",et=et||0,ep="m"===ep?6E4:864E5,vtc!==this.c_r(cn))){var e=new Date;e.setTime(e.getTime()+et*ep);this.c_w(cn,vtc,0===et?0:e);return vtc}return""};

Incollalo nella finestra del codice nell’estensione Analytics (se non l’hai ancora aperta, riaprila come nel passaggio precedente), posizionandolo completamente sotto la funzione doPlugins (non all’interno).

Copia il seguente codice:

s.campaign = s.Util.getQueryParam("cid");

Incollalo nella funzione doPlugins. Cercherà un parametro chiamato cid nell’URL della pagina corrente, inserendolo nella variabile s.campaign.

Ora chiama la funzione getValOnce copiando il seguente codice e incollandolo appena sotto la chiamata a getQueryParam:

s.campaign=s.getValOnce(s.campaign,'s_cmp',30);

Questo codice assicurerà che lo stesso valore non venga inviato più di una volta alla riga per 30 giorni (consulta la documentazione per i modi in cui personalizzare il codice in base alle tue esigenze).

Salva la finestra del codice.

Fai clic su Salva nella libreria e genera

Apri il sito Luma nel browser Chrome.

Fai clic sull'icona Debugger per aprire Adobe Experience Cloud Debugger

Fai clic sulla scheda Analytics.

Espandi la suite per report.

Nota che la hit Analytics non ha una variabile Campaign.

Lasciando aperto Debugger, torna al sito Luma e aggiungi ?cid=1234 all’URL, quindi premi Invio per aggiornare la pagina con quella stringa di query inclusa.

Controlla Debugger e conferma che ci sia una seconda richiesta Analytics con una variabile Campaign impostata su 1234.

Torna indietro e aggiorna nuovamente la pagina Luma, con la stringa di query ancora nell’URL.

Controlla l’hit successivo nel Debugger e che la variabile Campaign non sia presente, perché il plug-in getValOnce si è accertato che non venga duplicata e che sembri che un’altra persona sia arrivata dal codice di tracciamento della campagna.

BONUS: puoi eseguire il test di nuovo modificando il valore del parametro cid nella stringa query. La variabile Campaign dovrebbe essere disponibile solo se è la prima volta che esegui la pagina con il valore. Se non visualizzi il valore Campaign nel debugger, modifica semplicemente il valore di cid nella stringa query dell’URL e premi Invio per visualizzarlo nuovamente nel debugger.