Integrazione della piattaforma di analisi

Integrazione della piattaforma di analisi è un'estensione di Experience OS che ti consente di monitorare e analizzare le prestazioni delle esperienze personalizzate.

Il connettore di Integrazione della piattaforma di analisi ti consente di integrarti con la piattaforma di analisi di tua scelta per creare rapporti per le tue campagne Dynamic Yield. Puoi visualizzare i dati relativi alle sessioni e al comportamento degli utenti in relazione alle esperienze o alle varianti, oppure taggare gli utenti che sono stati esposti a un'esperienza specifica.

configurazione dell'integrazione di una piattaforma di analisi personalizzata

1. Vai su  App Store Experience OS › Piattaforma di analisi Integrazione e fai clic su Installa.
2. Fai clic su Configura estensione.
   

3. Seleziona i fattori che determineranno l'esecuzione del codice di integrazione personalizzato.

   • Impressioni delle varianti (standard): analizza il comportamento degli utenti ai quali è stata proposta una variante.
   • Impressioni di raccomandazione: analizza il comportamento degli utenti ai quali è stata proposta una strategia specifica.
   • Varianti rese su una pagina: analizza il comportamento degli utenti che hanno fatto clic sulle campagne Contenuto dinamico o Raccomandazione.

4. Scrivi codice JavaScript personalizzato conforme alle API della piattaforma in questione.

   • Il codice JavaScript può includere metadati quali il nome della variante, il nome dell'esperienza o della campagna, la strategia (per le raccomandazioni), e molto altro.

   • Per la scelta degli hook, consulta la documentazione inclusa per le seguenti indicazioni:

     • Come funziona il codice?
     • Esempio di oggetto
     • Descrizioni degli attributi
     • Codice di esempio
       
   • Solo consenso presunto ai cookie: se utilizzi una delle nostre API per la gestione della privacy dei dati dei visitatori, devi usare una API dedicata per assicurarti che non vengano inviati a terzi dati di utenti che non hanno fornito il loro consenso 

   • La nuova sintassi inclusa in Javascript ES6 non è supportata.

5. Per impostazione predefinita, l'integrazione della piattaforma di analisi viene proposta quando viene attivata una qualsiasi campagna in base a questa configurazione. Puoi abilitare o disabilitare manualmente l'integrazione per singole campagne usando la procedura descritta in Abilitazione e disabilitazione di un'integrazione personalizzata per campagna. 

Gestione del connettore di Integrazione della piattaforma di analisi

Nell'app Personalizzazione Web, vai alla scheda Estensioni. Qui puoi selezionare una delle seguenti tre opzioni:

• Attiva
• Disattiva
• Disinstallata 

Abilitazione e disabilitazione di un'integrazione personalizzata per campagna

Per impostazione predefinita, l'integrazione della piattaforma di analisi personalizzata è abilitata per tutte le campagne. Tuttavia, l'integrazione può essere disattivata per campagna, Tale operazione può essere eseguita nelle Impostazioni avanzate della campagna.

1. Durante la modifica o la creazione di una campagna, vai su Impostazioni avanzate. 
2. Disabilita (o Abilita) Monitora le prestazioni delle campagne nella tua piattaforma di analisi:
   

Risoluzione dei problemi relativi alle integrazioni di analisi personalizzate

Se hai configurato la tua integrazione di analisi personalizzata, ma non vedi i dati della campagna Dynamic Yield nella tua piattaforma di analisi, prova questi metodi per risolvere i problemi del codice di integrazione e verificare che stia funzionando nel modo previsto.

Se dopo aver provato queste azioni gli eventi non vengono ancora attivati per le campagne di Dynamic Yield, contatta il supporto tecnico.

Console.log

L'uso di console.log() è un metodo classico nel codice di debugging. Esso scrive stringhe di testo sulla console degli strumenti di sviluppo del tuo browser (premi ⌘+⌥+J per MacOS o Ctrl+Shift+J per Windows). Nel seguente esempio, console.log() viene usato per verificare se il nostro codice viene eseguito correttamente e se i valori vengono assegnati alle nostre variabili.

Per fare un ulteriore passo avanti, puoi usare console.log() per assicurarti che i dati della campagna Dynamic Yield vengano assegnati alle variabili passate nella funzione afterVariationSelected.

Punti di interruzione

Puoi usare i punti di interruzione per interrompere l'esecuzione del codice nel browser, il che ti consente di esaminare il codice riga per riga.

Per aggiungere punti di interruzione al codice contenuto nella tua integrazione di analisi personalizzata:

1. Apri gli strumenti di sviluppo nel tuo browser (premi ⌘+⌥+J per MacOS o Ctrl+Shift+J per Windows).
2. Fai clic sui tre puntino nella barra dei menu, quindi fai clic su Apri file.
3. Cerca "api_dynamic" e apri il file JS facendo clic su di esso.
4. Fai clic su Pretty-Print.
5. Cerca il nome della funzione dal codice della tua integrazione di analisi personalizzata . In questo esempio, abbiamo cercato "afterVariationSelected". Tuttavia, questo nome potrebbe essere diverso a seconda del tipo di integrazione personalizzata che stai usando. Fai riferimento alla tua integrazione in Dynamic Yield se non sicuro di cosa usare nella tua ricerca.
   
6. Fai clic sui numeri di riga per aggiungere punti di interruzione nel punto in cui desideri interrompere l'esecuzione del codice. In questo esempio, abbiamo aggiunto un punto di interruzione per arrestare il codice prima che esegua l'evento gtag.
   
7. Aggiornare la pagina di cui stai risolvendo il problema. Nella console degli strumenti di sviluppo, puoi che la pagina smette di caricarsi e viene visualizzato il punto di interruzione.
   
   Ora puoi vedere quali valori sono assegnati alle variabili minimizzate passate nella funzione afterVariationSelected. Se riprendi l'esecuzione del codice, puoi notare che esso viene ripetuto e si ferma più volte sullo stesso punto di interruzione, se stai lanciando il codice di integrazione dell'analisi per più campagne nella pagina.
   Tieni presente che il codice non verrà iterato nelle campagne che non hanno l'interruttore di abilitazione/disabilitazione dell'integrazione dell'analisi personalizzata abilitato nelle impostazioni della campagna.
8. Fai delle prove aggiungendo altri punti di interruzione nel codice oppure usa Step per scorrere il codice dopo aver raggiunto il punto di interruzione.
   

Uso del codice di misurazione degli eventi corretto per Google Analytics

Se ancora non vedi gli eventi della campagna Dynamic Yield in Google Analytics, è possibile che tu stia utilizzando la sintassi errata per il tuo codice di misurazione degli eventi. A seconda della tua implementazione, devi usare la sintassi ga() o gtag().

Per verificare la corretta sintassi del codice per il tuo sito, consulta l'articolo Google Analytics 4 .