Migrazione da Adobe Analytics a Web SDK tramite tag
Scopri i passaggi per migrare un’implementazione di Adobe Analytics utilizzando l’estensione Analytics in Experience Platform Tags (precedentemente nota come Launch) a Web SDK, utilizzando l’estensione Web SDK anche in Tags. Quando si utilizza l’estensione Adobe Analytics nei Tag, viene utilizzato il codice "AppMeasurement.js" in background. Di conseguenza, puoi considerare questo come un’esercitazione per la migrazione di AppMeasurement a Web SDK, ma questa esercitazione si trova completamente all’interno di Tag e NON riguarda lo spostamento da o verso un’implementazione di JavaScript (ad eccezione del codice JavaScript utilizzato all’interno dell’interfaccia utente di Tags). Per la migrazione delle implementazioni di JavaScript, consulta la documentazione.
Cosa otterrai da questa esercitazione
Prima di passare ai passaggi per la migrazione dell'implementazione di Analytics, è importante che tu capisca esattamente cosa farai, ovvero modificare/aggiornare l'implementazione per Analytics. Alla fine di questa esercitazione, quando andate nei vostri rapporti e quando tutto è uguale, vi chiederete, "Ora, perché ho fatto tutto questo?" Esistono altri documenti per delineare i vantaggi dell’utilizzo di Web SDK per l’implementazione di Analytics, ma alcuni sono:
- Supporto per ID dispositivo di prime parti
- Prestazioni migliori
- Garantire la validità futura dell’implementazione man mano che si procede all’utilizzo delle applicazioni Adobe Experience Platform (abilitazione di nuovi casi d’uso)
Per ulteriori informazioni su come utilizzare il Web SDK, rivolgiti al tuo rappresentante Adobe Analytics. Continuando con questa esercitazione, ci concentreremo su come eseguire la migrazione.
Metodo di migrazione
Ci sono probabilmente molti modi per eseguire questo processo di migrazione, ma dobbiamo parlarne due proprio qui:
Metodo 1: Aggiorna la proprietà Tags esistente in Web SDK, creando nuovi elementi dati e apportando modifiche alle regole già esistenti nella proprietà.
Metodo 2: è inoltre possibile creare una nuova proprietà copiando quella esistente o creandone una nuova e quindi configurarla con Web SDK anziché con l'estensione Adobe Analytics.
Per questa esercitazione sulla migrazione verrà utilizzato il metodo 1. In questo modo i codici di incorporamento associati alla proprietà sono già incorporati nei siti di sviluppo, staging e produzione, quindi non sarà necessario modificare alcun codice di incorporamento. Se decidi di utilizzare il metodo 2, non dimenticare di ottenere i nuovi codici di incorporamento per ogni ambiente dalla sezione Ambienti della nuova proprietà e inserirli nella sezione head del sito.
È bene stare attenti, nel caso. Procedi e crea la copia della proprietà. Aspetterò qui finché non ritorni.
Passaggi per migrare l’implementazione di Analytics al Web SDK
Durante l’esecuzione dei passaggi, è importante comprendere alcune avvertenze:
- Innanzitutto, tutti questi passaggi possono essere necessari o meno. Ad esempio, esiste una lezione sulla migrazione del codice personalizzato. Se disponi di un’implementazione di Tag che non utilizza codice personalizzato (incluso l’utilizzo di plug-in), questa lezione non sarà necessaria. Abbiamo cercato di includere le lezioni che sarebbero state necessarie alla maggior parte degli utenti, quindi leggi almeno le lezioni per vedere se è necessario apportare modifiche al sito durante la migrazione.
- Inoltre, non c’è modo di creare un tutorial sulla migrazione che copra il 100% dei casi d’uso che tutti utilizzano. Come affermato nell'articolo precedente, abbiamo cercato di includere le lezioni di cui la maggior parte delle persone avrà bisogno, e che riguarderanno la maggior parte dei casi d'uso principali. Tuttavia, ci saranno sicuramente casi d’uso non trattati in questa esercitazione. In questo caso, verifica se le lezioni incluse ti danno una buona idea di come eseguire la migrazione per il tuo caso d’uso. Puoi anche chiedere ai tuoi colleghi della Community Experience League di raccogliere dati.
Il processo di migrazione prevede i seguenti passaggi chiave:
- Crea una suite di rapporti per la convalida della migrazione.
- Crea e configura un flusso di dati.
- Aggiungi e configura l’estensione Web SDK in Tag (precedentemente Adobe Launch).
- Crea un nuovo elemento dati per inviare dati in tramite Web SDK.
- Esegui la migrazione della regola di caricamento pagina predefinita per utilizzare l'elemento dati e le azioni di Web SDK.
- Esegui la migrazione del codice personalizzato nelle regole o per i plug-in.
- Modifiche all’implementazione di Publish.
- Scopri come eseguire il debug e convalidare le modifiche e convalidare la regola di caricamento pagina predefinita e le variabili associate. La convalida deve quindi continuare per tutta la migrazione man mano che apporti modifiche.
- Eseguire la migrazione di altre regole di caricamento della pagina.
- Eseguire la migrazione delle regole di collegamento personalizzate.
- Dopo la convalida completa, rimuovi i riferimenti all’estensione Analytics e l’estensione stessa.
- Dopo aver apportato tutte le modifiche, invia la libreria allo staging e quindi alla produzione.
- Dopo aver completato tutto, verifica di nuovo. Ciò è necessario perché hai apportato modifiche rimuovendo i riferimenti al vecchio codice Analytics e desideri che tutto funzioni ancora correttamente.