Aggiungere Adobe Analytics

In questa lezione, implementerai l’estensione Adobe Analytics e creerai regole per inviare dati ad Adobe Analytics.

Adobe Analytics è una soluzione leader di settore che ti consente di comprendere i tuoi clienti come persone e gestire la tua attività grazie alle informazioni sul cliente.

NOTE
Adobe Experience Platform Launch viene integrato in Adobe Experience Platform come suite di tecnologie per la raccolta dati. Nell’interfaccia sono state introdotte diverse modifiche terminologiche di cui tenere conto durante l’utilizzo di questo contenuto:

Finalità di apprendimento

Alla fine di questa lezione, potrai:

  1. Aggiungere l’estensione Adobe Analytics
  2. Imposta le variabili globali tramite l'estensione
  3. Aggiungi il beacon di visualizzazione pagina
  4. Aggiungi variabili aggiuntive tramite le regole
  5. Aggiungi il tracciamento dei clic e altri beacon basati su eventi
  6. Aggiungere i plug-in di Analytics

Puoi implementare molti elementi per Analytics nei tag. Questa lezione non è esaustiva, ma fornisce una panoramica delle tecniche principali necessarie da implementare nel tuo sito.

Prerequisiti

Dovresti aver già completato le lezioni in Configurare i tag e Aggiungere il servizio Identity.

Inoltre, devi disporre di almeno un ID suite per report e del tracking server. Se non hai una suite per report test/dev che puoi usare per questa esercitazione, creane una. Se non sai come farlo, consulta la documentazione. Puoi recuperare il tracking server dalla tua implementazione corrente dall’Adobe Consultant o dal rappresentante dell’Assistenza clienti.

Aggiungi l’estensione Analytics

L’estensione di Analytics consiste in due parti principali:

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

  2. Azioni di regola per eseguire le operazioni seguenti:

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

Aggiungere l’estensione Analytics

  1. Passa a Estensioni > Catalogo

  2. Individua l’estensione Adobe Analytics

  3. Fai clic su Installa

    Installare l’estensione Analytics

  4. Sotto Gestione libreria > Suite di rapporti, immetti gli ID suite di rapporti che desideri utilizzare con ogni ambiente di tag. Se gli utenti hanno accesso ad Adobe Analytics, quando inizi a digitare nella casella viene visualizzato un elenco prepopolato 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).

    Inserire gli ID delle suite per report

    note tip
    TIP
    È consigliabile utilizzare l’opzione Gestisci la libreria per me come impostazione di Gestione libreria, in quanto consente di mantenere la AppMeasurement.js libreria aggiornata in modo molto più semplice.
  5. Sotto Generale > Server di tracciamento, immetti il server di tracciamento, ad esempio tmd.sc.omtrdc.net. Immetti Server di tracciamento SSL se il sito supporta https://.

    Immettere i server di tracciamento

  6. In Sezione Variabili globali, Impostazioni aggiuntive, imposta le Nome pagina utilizzando la variabile Page Name elemento dati. Fai clic sull’icona icona dell’elemento dati per aprire il modale e scegli l’Page Nameelemento dati della pagina).

  7. Fai clic su Salva nella libreria

    Impostare la variabile del nome della pagina e salvare

NOTE
Le variabili globali possono essere impostate nella configurazione dell’estensione o nelle azioni di regola. Tieni presente che quando imposti variabili nella configurazione dell’estensione, il livello dati deve essere definito prima i codici di incorporamento del tag.

Invia il beacon Vista pagina

Ora creerai una regola per attivare il beacon di Analytics, che invierà la variabile Page Name impostata nella configurazione dell’estensione.

Hai già creato una regola "All Pages - Library Loaded" nel Aggiungere un elemento dati, una regola e una libreria lezione di questa esercitazione, che viene attivata su ogni pagina al caricamento della libreria di tag. You potrebbe utilizza questa regola anche per Analytics, tuttavia questa configurazione richiede che tutti gli attributi del livello dati utilizzati nel beacon di Analytics siano definiti prima dei codici di incorporamento dei tag. Per consentire una maggiore flessibilità con la raccolta dati, crea una nuova regola “all pages” attivata sul DOM Ready per attivare il beacon Analytics.

Inviare il beacon Vista pagina

  1. Vai a Regole nella navigazione a sinistra, quindi fai clic su Aggiungi regola

    Aggiungi regola

  2. Denomina la regola All Pages - DOM Ready

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

    Denominare la regola e aggiungere un evento

  4. Seleziona Tipo evento > DOM Ready (tieni presente che l’ordine della regola è “50”).

  5. Fai clic su Mantieni modifiche.
    Configurare l’evento

  6. In Azioni, fai clic su fai clic sull’icona Più per aggiungere una nuova azione.

    Fare clic sull’icona Più per aggiungere una nuova azione

  7. Seleziona Estensione > Adobe Analytics.

  8. Seleziona Tipo azione > Invia beacon.

  9. 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.

  10. Fai clic sul pulsante Mantieni modifiche

    Fare clic sull’icona Più per aggiungere una nuova azione

  11. Fai clic su Salva nella libreria e genera

    Fare clic su Salva nella libreria e genera

Convalidare il beacon Vista pagina

Dopo aver creato una regola per inviare un beacon Analytics, dovresti essere in grado di visualizzare la richiesta in Experience Cloud Debugger.

  1. Apri il sito Luma nel browser Chrome.

  2. Fai clic sull’icona Debugger Apri Experience Cloud Debugger per aprire Adobe Experience Cloud Debugger.

  3. Assicurati che Debugger mappi la proprietà tag in le Ambiente di sviluppo, come descritto in lezione precedente

    L’ambiente di sviluppo tag visualizzato in Debugger

  4. Fai clic per aprire la scheda Analytics.

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

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

    Convalidare l’hit pagina

NOTE
Se Nome pagina non viene visualizzato, torna indietro nei passaggi della pagina per assicurarti di non aver tralasciato nulla.

Aggiungi variabili con regole

Una volta configurata l’estensione Analytics, hai popolato la variabile pageName nella configurazione dell’estensione. Si tratta di una posizione valida per compilare altre variabili globali, come eVar e proprietà, purché il valore sia disponibile sulla pagina prima del caricamento del codice di incorporamento del tag.

Una posizione più flessibile per impostare le variabili, così come gli eventi, si trova nelle regole, utilizzando l’azioneSet Variables. Le regole consentono di impostare variabili di Analytics ed eventi differenti in condizioni diverse. Ad esempio, puoi impostare prodView solo sulle pagine di dettaglio del prodotto e l’evento purchase solo nelle pagine di conferma degli ordini. In questa sezione ti viene illustrato come impostare le variabili utilizzando le regole.

Caso d'uso

Product Detail Pages (PDP) sono punti importanti per la raccolta di dati sui siti di vendita al dettaglio. In genere, si desidera che Analytics registri la visualizzazione di un prodotto e il prodotto visualizzato. Questo è utile per capire i prodotti più popolari tra i clienti. Su un sito multimediale, le pagine di articolo o video potrebbero utilizzare tecniche di tracciamento simili a quelle che utilizzerai in questa sezione. Quando carichi una pagina di dettagli del prodotto, potrebbe essere utile inserire tale valore in un “Page Type” eVar e impostare alcuni eventi e l’ID prodotto. Questo consente di visualizzare quanto segue nell’analisi:

  1. Quante volte vengono caricate le pagine dei dettagli del prodotto
  2. Quali prodotti specifici vengono visualizzati e quante volte
  3. Come incidono gli altri fattori (campagne, ricerca, ecc.) sul numero di persone PDP che caricano

Crea elemento dati per tipo di pagina

Innanzitutto devi identificare quali sono le pagine dei dettagli prodotto. Puoi farlo con un elemento dati.

Creare l’elemento dati per Page Type

  1. Fai clic su Elementi dati nella navigazione a sinistra

  2. Fai clic su Aggiungi elemento dati

    Aggiungere un nuovo elemento dati

  3. Denomina l’elemento dati Page Type

  4. Seleziona Tipo di elemento dati > Variabile JavaScript

  5. Utilizzo digitalData.page.category.type come Nome della variabile JavaScript

  6. Controlla la Testo pulito e Forza minuscolo options

  7. Fai clic su Salva nella libreria

    Aggiungere un nuovo elemento dati per Page Type

Creare un elemento dati per ID prodotto

Quindi, raccogli l’ID prodotto della pagina dettagli prodotto corrente con un elemento dati.

Creare l’elemento dati per l’ID prodotto

  1. Fai clic su Elementi dati nella navigazione a sinistra

  2. Fai clic su Aggiungi elemento dati

    Aggiungere un nuovo elemento dati

  3. Denomina l’elemento dati Product Id

  4. Seleziona Tipo di elemento dati > Variabile JavaScript

  5. Utilizzo digitalData.product.0.productInfo.sku come Nome della variabile JavaScript

  6. Controlla la Testo pulito e Forza minuscolo options

  7. Fai clic su Salva nella libreria

    Aggiungere un nuovo elemento dati per Page Type

Aggiungi l’estensione Adobe Analytics Product String

Se conosci le implementazioni di Adobe Analytics, probabilmente hai già familiarità con le variabili dei prodotti. La variabile dei prodotti ha una sintassi specifica e viene utilizzata modi leggermente diversi a seconda del contesto. Per facilitare la popolazione della variabile prodotti nei tag, sono già state create tre estensioni aggiuntive nel marketplace dell'estensione tag. In questa sezione viene aggiunta un’estensione creata da Adobe Consulting per l’utilizzo nella pagina Product Detail.

Aggiungere l’Adobe Analytics Product Stringestensione

  1. Vai alla pagina Estensioni > Catalogo.

  2. Troverai l’Adobe Analytics Product Stringestensione di Adobe Consulting Services, fai clic su Installa.
    Aggiungere l’estensione Adobe Analytics Product String di Adobe Consulting

  3. Leggi le istruzioni.

  4. Fai clic su Salva nella libreria

    Salvare l’estensione e generarla nella libreria

Crea la regola per le pagine dettagli prodotto

Adesso, utilizza i nuovi elementi di dati e l’estensione per generare la regola per la pagina Product Detail. Per questa funzionalità, creerai un’altra regola di caricamento della pagina, attivata da DOM Ready. Tuttavia, utilizzerai una condizione per attivare solo le pagine di dettaglio del prodotto e l’impostazione dell’ordine in modo che venga attivato prima della regola che invia il beacon.

Creare la regola della pagina Dettagli prodotto

  1. Vai a Regole nella navigazione a sinistra, quindi fai clic su Aggiungi regola

    Aggiungi regola

  2. Denomina la regola Product Details - DOM Ready - 40

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

    Denominare la regola e aggiungere un evento

  4. Seleziona Tipo evento > DOM Ready.

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

  6. Fai clic su Mantieni modifiche.

    Configurare l’evento

  7. In Condizioni, fai clic su fai clic sull’icona Più per aprire la schermata Condition Configuration.
    Fare clic sull’icona Più per aggiungere una nuova condizione

    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 dell’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.

      Definire la condizione

  8. In Azioni, fai clic su fai clic sull’icona Più per aggiungere una nuova azione.

    Fare clic sull’icona Più per aggiungere una nuova azione

  9. Seleziona Estensione > Adobe Analytics Product String.

  10. Seleziona Tipo azione > Imposta s.products.

  11. Nella sezione Analytics E-commerce Event, seleziona prodView.

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

  13. Fai clic su Mantieni modifiche.

    Aggiungere la variabile Product String utilizzando l’estensione Adobe Analytics Product String

  14. In Azioni, fai clic su fai clic sull’icona Più per aggiungere una nuova azione.

    Aggiungere un’altra azione per Product String

  15. Seleziona Estensione > Adobe Analytics.

  16. Seleziona Tipo azione > Imposta variabili.

  17. Seleziona eVar1 > Imposta come e immetti product detail page.

  18. Imposta event1, lasciando vuoti i valori facoltativi.

  19. In Eventi, fai clic sul pulsante Aggiungi un altro

  20. Imposta l’evento prodView, lasciando vuoti i valori facoltativi.

  21. Fai clic su Mantieni modifiche.

    Impostare le variabili di Analytics nella regola PDP

  22. Fai clic su Salva nella libreria e genera

    Salva la regola

Convalida i dati della pagina di dettagli prodotto

È stata appena creata una regola che imposta le variabili prima dell’invio del beacon. Ora dovresti essere in grado di vedere i nuovi dati che escono nell’hit in Experience Cloud Debugger.

Convalidare i dati della pagina di dettagli prodotto

  1. Apri il sito Luma nel browser Chrome.

  2. Vai a qualsiasi pagina dei dettagli del prodotto.

  3. Fai clic sull’icona Debugger Apri Experience Cloud Debugger per aprire Adobe Experience Cloud Debugger.

  4. Fai clic sulla scheda Analytics.

  5. Espandi la suite per report.

  6. 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.

    Convalidare l’hit pagina

Quando viene caricata una pagina, in genere viene attivato un beacon di caricamento della pagina dalla funzione s.t(). Questo incrementa automaticamente una metrica page view per la pagina indicata nella variabile pageName.

Tuttavia, a volte è meglio non incrementare le visualizzazioni di pagina sul sito, perché l’azione che avviene è più piccola, o forse solo diversa, rispetto alla visualizzazione di una pagina. In questo caso, utilizza la funzione s.tl(), comunemente definita richiesta di collegamento di tracciamento. Anche se è definita richiesta di collegamento di tracciamento, non deve essere attivata su un clic di collegamento. Può essere attivato da qualsiasi degli eventi disponibili nel generatore di regole di tag, incluso JavaScript personalizzato.

In questa esercitazione, verrà attivata una chiamata s.tl() utilizzando uno degli eventi JavaScript più interessanti, un evento Enters Viewport.

Caso d’utilizzo

Per questo caso d’uso, vuoi sapere se le persone stanno scorrendo sulla nostra home page Luma, fino a un livello sufficiente per visualizzare il Prodotti sezione della nostra pagina. Nella nostra azienda c’è qualche disaccordo interno sulla possibilità che le persone vedano o meno quella sezione, per cui vuoi usare Analytics per scoprire la verità.

Creare la regola nei tag

  1. Vai a Regole nella navigazione a sinistra, quindi fai clic su Aggiungi regola

    Aggiungi regola

  2. Denomina la regola Homepage - Featured Products enters Viewport

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

    Aggiungi regola prodotti in primo piano

  4. Seleziona Tipo evento > Accesso riquadro visualizzazione. 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.

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

  6. Fai clic con il pulsante destro del mouse sullo spazio tra il titolo "FEATURED PRODUCTS" e gli elementi in questa sezione e seleziona Inspect dal menu di scelta rapida. Questo ti porterà vicino a ciò che desideri.

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

  8. Fai clic con il pulsante destro del mouse su di esso e seleziona Copia > Copia selettore.

    Configurare l’evento Enters Viewport

  9. Torna ai tag e incolla questo valore dagli Appunti nel campo contrassegnato 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. Considera questo quando utilizzi qualsiasi selettore CSS nei tag.
  10. Fai clic su Mantieni modifiche.

    Configurare l’evento Enters Viewport

  11. In Condizioni, fai clic su fai clic sull’icona Più per aggiungere una nuova condizione.

  12. Seleziona Tipo condizione > Confronto valori.

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

  14. Seleziona Uguale a dal menu a discesa dell’operatore di confronto.

  15. 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).

  16. Fai clic su Mantieni modifiche.

    Configurare la condizione della pagina iniziale

  17. In Azioni, fai clic su fai clic sull’icona Più per aggiungere una nuova azione.

  18. Seleziona Estensione > Adobe Analytics.

  19. Seleziona Tipo azione > Imposta variabili.

  20. Imposta eVar3 su Home Page - Featured Products.

  21. Imposta prop3 su Home Page - Featured Products.

  22. Imposta la variabile Events su event3.

  23. Fai clic su Mantieni modifiche.

    Configurare l’evento Enters Viewport

  24. In Azioni, fai clic su fai clic sull’icona Più per aggiungere una nuova azione.

  25. Seleziona Estensione > Adobe Analytics.

  26. Seleziona Tipo azione > Invia beacon.

  27. Scegli la s.tl() opzione di tracciamento

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

  29. Fai clic su Mantieni modifiche.

    Beacon prodotti in primo piano di configurazione

  30. Fai clic su Salva nella libreria e genera

    Salvare la regola e generare

Ora è necessario assicurarsi che questo hit venga inserito quando scorri verso il basso fino alla sezione Prodotti in primo piano della home page del nostro sito. Quando carichi la pagina iniziale, la richiesta non dovrebbe essere effettuata, ma dopo lo scorrimento verso il basso e la visualizzazione della sezione, l’hit dovrebbe venire attivato con i nuovi valori specificati.

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

  2. Fai clic sull’icona Debugger Apri Experience Cloud Debugger per aprire Adobe Experience Cloud Debugger.

  3. Fai clic sulla scheda Analytics.

  4. Espandi l’hit della suite per report.

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

    Debugger con visualizzazione pagina

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

  7. 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"

      Debugger con visualizzazione pagina

Aggiungere un plug-in

Un plug-in è un pezzo di codice JavaScript che puoi aggiungere alla tua implementazione per eseguire una funzione non integrata nel prodotto. I plug-in possono essere creati da voi, da altri clienti o partner Adobe oppure da Adobe Consulting.

Per implementare i plug-in, ci sono tre passaggi:

  1. Includi la funzione doPlugins, in cui verrà fatto riferimento al plug-in.
  2. Aggiungi il codice della funzione principale per il plug-in.
  3. Includi il codice che chiama la funzione e imposta le variabili, ecc.

Rendi l’oggetto Analytics accessibile globalmente.

Se desideri aggiungere la funzione doPlugins (sotto) e utilizzare i plug-in, devi spuntare una casella per rendere l’oggetto Analytics disponibile a livello globale nell’implementazione di Analytics.

  1. Vai a Estensioni > Installate.

  2. Nell’estensione Adobe Analytics, fai clic su Configura.

    Configurare Analytics

  3. In Library Management, seleziona la casella etichettata 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.
    Rendere il tracker accessibile a livello globale

Includere la funzione doPlugins

Per aggiungere dei plug-in, devi aggiungere una funzione chiamata doPlugins. Questa funzione non viene aggiunta per impostazione predefinita, ma una volta aggiunta, viene gestita dalla libreria AppMeasurement e viene chiamata per ultima quando un hit viene inviato in Adobe Analytics. Pertanto, puoi utilizzare questa funzione per eseguire un codice JavaScript per impostare variabili più facilmente in questo modo.

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

  2. Fai clic su Apri editor

  3. Incolla il seguente codice nell’editor di codice:

    code language-javascript
    /* Plugin Config */
    s.usePlugins=true
    s.doPlugins=function(s) {
    /* Add calls to plugins here */
    }
    
  4. Tieni aperta questa finestra per il passaggio successivo

Aggiungi codice di funzione per il plug-in

Con questo codice chiamerai due plug-in, ma uno di questi è incorporato nella libreria AppMeasurement, quindi per quello non è necessario aggiungere la funzione da chiamare. Tuttavia, per il secondo, è necessario aggiungere anche il codice della funzione. Questa funzione viene chiamata getValOnce().

Plug-in getValOnce()

Lo scopo di questo plug-in consiste nell’evitare che i valori vengano duplicati erroneamente nel codice quando un visitatore aggiorna una pagina o utilizza il pulsante Indietro del browser per tornare a una pagina in cui è stato impostato un valore. In questa lezione, lo utilizzerai per evitare che l’evento clickthrough venga duplicato.

Il codice di questo plug-in è disponibile nella documentazione Analytics, ma è incluso qui per semplificare la funzione di copia/incolla.

  1. Copia il seguente codice.

    code language-javascript
    /* 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""};
    
  2. 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).

    Aggiungere il codice del plug-in

Ora puoi chiamare questo plug-in da doPlugins.

Chiamata dei plug-in da doPlugins

Ora che il codice è presente e puoi farci riferimento, puoi effettuare le chiamate ai plug-in all’interno della funzione doPlugins.

Innanzitutto, chiamerai un plug-in che è stato incorporato nella libreria AppMeasurement e quindi noto come “utility”. È noto come s.Util.getQueryParam poiché fa parte dell’oggetto s, è un’utility incorporata e acquisirà i valori (basati su un parametro) della stringa query nell’URL.

  1. Copia il seguente codice:

    code language-javascript
    s.campaign = s.Util.getQueryParam("cid");
    
  2. Incollalo nella funzione doPlugins. Cercherà un parametro chiamato cid nell’URL della pagina corrente, inserendolo nella variabile s.campaign.

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

    code language-javascript
    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).

    Chiamare i plug-in da doPlugins

  4. Salva la finestra del codice.

  5. Fai clic su Salva nella libreria e genera

    Chiamare i plug-in da doPlugins

Convalidare i plug-in

Ora puoi verificare che i plug-in funzionino.

Convalida dei plug-in

  1. Apri il sito Luma nel browser Chrome.

  2. Fai clic sull’icona Debugger Apri Experience Cloud Debugger per aprire Adobe Experience Cloud Debugger.

  3. Fai clic sulla scheda Analytics.

  4. Espandi la suite per report.

  5. Nota che la hit Analytics non ha una variabile Campaign.

  6. 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.

    Aggiungere una stringa di query

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

    Passaggio 1 di getQueryParam

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

  9. 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.

    Passaggio 1 di getQueryParam

  10. 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.

    note note
    NOTE
    Esistono in realtà alcuni modi diversi per recuperare un parametro dalla stringa query dell’URL, incluso nella configurazione dell’estensione di Analytics. Tuttavia, queste altre opzioni non plug-in non forniscono la possibilità di interrompere inutili duplicazioni, come fatto qui per il plug-in getValOnce. Questo è il metodo preferito dell’autore, ma è necessario determinare quale metodo funziona meglio per te e le tue esigenze.

Ottimo lavoro. Hai completato la lezione di Analytics. Naturalmente, ci sono molte altre cose che puoi fare per migliorare la nostra implementazione di Analytics, ma spero che questo ti abbia dato alcune delle competenze principali per affrontare il resto delle tue esigenze.

Avanti “Aggiungere Adobe Audience Manager” >

recommendation-more-help
45774420-d03e-4a6b-94b5-cd639ae825b2