Documentazione Analytics Guida all'implementazione

Migrare dall’estensione tag Adobe Analytics all’estensione tag Web SDK

Ultimo aggiornamento: 18 luglio 2024

Creato per:

Utente
Amministratore

Questo percorso di implementazione prevede un approccio metodologico di migrazione per passare dall’estensione tag Adobe Analytics all’estensione tag Web SDK. Altri percorsi di implementazione sono trattati in pagine separate:

AppMeasurement alla libreria JavaScript dell'SDK Web: un approccio fluido e metodico per la migrazione all'SDK Web, ma non utilizza i tag. È invece possibile rimuovere manualmente la raccolta dati di Adobe Analytics (AppMeasurement.js) e sostituirla con la raccolta JavaScript di Web SDK (alloy.js).
Estensione tag Web SDK: una nuova installazione di Web SDK in cui è possibile gestire l'implementazione utilizzando i tag in Raccolta dati di Adobe Experience Platform. Richiede il gruppo di campi ExperienceEvent di Adobe Analytics, che include le variabili Analytics tipiche da includere nello schema XDM.
Libreria Web SDK JavaScript: una nuova installazione di Web SDK utilizzando la libreria Web SDK JavaScript (alloy.js). Gestisci autonomamente l’implementazione anziché utilizzare l’interfaccia utente dei tag. Richiede il gruppo di campi ExperienceEvent di Adobe Analytics, che include le variabili Analytics tipiche da includere nello schema XDM.

Vantaggi e svantaggi di questo percorso di implementazione

L’utilizzo di questo approccio alla migrazione presenta sia vantaggi che svantaggi. Valuta attentamente ogni opzione per decidere quale approccio è meglio per la tua organizzazione.

Vantaggi Svantaggi

Vantaggi	Svantaggi
Nessuna modifica al codice nel sito: poiché l'implementazione dispone già di tag installati, è possibile eseguire tutti gli aggiornamenti della migrazione nell'interfaccia dei tag. Utilizza l'implementazione esistente: questo approccio non richiede una nuova implementazione. Anche se richiede nuove azioni della regola, puoi riutilizzare gli elementi dati e le condizioni della regola esistenti con modifiche minime. Non richiede uno schema: per questa fase della migrazione all'SDK Web, non è necessario uno schema XDM. È invece possibile popolare l'oggetto `data`, che invia i dati direttamente ad Adobe Analytics. Una volta completata la migrazione all’SDK per web, puoi creare uno schema per la tua organizzazione e utilizzare la mappatura dello stream di dati per popolare i campi XDM applicabili. Se in questa fase del processo di migrazione fosse necessario uno schema, l’organizzazione sarebbe costretta a utilizzare uno schema XDM di Adobe Analytics. L’utilizzo di questo schema rende più difficile per l’organizzazione utilizzare il proprio schema in futuro.	Debito tecnico per l'implementazione: poiché questo approccio utilizza una forma modificata dell'implementazione esistente, può essere più difficile tenere traccia della logica di implementazione ed eseguire modifiche quando necessario. Il debug del codice personalizzato può essere particolarmente difficile. Richiede la mappatura per inviare i dati a Platform: quando l’organizzazione è pronta per utilizzare Customer Journey Analytics, devi inviare i dati a un set di dati in Adobe Experience Platform. Questa azione richiede che ogni campo nell'oggetto `data` sia una voce nello strumento di mappatura dello stream di dati che lo assegna a un campo dello schema XDM. La mappatura deve essere eseguita solo una volta per questo flusso di lavoro e non implica l’apportazione di modifiche all’implementazione. Tuttavia, si tratta di un passaggio aggiuntivo non richiesto quando si inviano dati in un oggetto XDM.

Nessuna modifica al codice nel sito: poiché l'implementazione dispone già di tag installati, è possibile eseguire tutti gli aggiornamenti della migrazione nell'interfaccia dei tag.
Utilizza l'implementazione esistente: questo approccio non richiede una nuova implementazione. Anche se richiede nuove azioni della regola, puoi riutilizzare gli elementi dati e le condizioni della regola esistenti con modifiche minime.
Non richiede uno schema: per questa fase della migrazione all'SDK Web, non è necessario uno schema XDM. È invece possibile popolare l'oggetto data, che invia i dati direttamente ad Adobe Analytics. Una volta completata la migrazione all’SDK per web, puoi creare uno schema per la tua organizzazione e utilizzare la mappatura dello stream di dati per popolare i campi XDM applicabili. Se in questa fase del processo di migrazione fosse necessario uno schema, l’organizzazione sarebbe costretta a utilizzare uno schema XDM di Adobe Analytics. L’utilizzo di questo schema rende più difficile per l’organizzazione utilizzare il proprio schema in futuro.

Debito tecnico per l'implementazione: poiché questo approccio utilizza una forma modificata dell'implementazione esistente, può essere più difficile tenere traccia della logica di implementazione ed eseguire modifiche quando necessario. Il debug del codice personalizzato può essere particolarmente difficile.
Richiede la mappatura per inviare i dati a Platform: quando l’organizzazione è pronta per utilizzare Customer Journey Analytics, devi inviare i dati a un set di dati in Adobe Experience Platform. Questa azione richiede che ogni campo nell'oggetto data sia una voce nello strumento di mappatura dello stream di dati che lo assegna a un campo dello schema XDM. La mappatura deve essere eseguita solo una volta per questo flusso di lavoro e non implica l’apportazione di modifiche all’implementazione. Tuttavia, si tratta di un passaggio aggiuntivo non richiesto quando si inviano dati in un oggetto XDM.

L’Adobe consiglia di seguire questo percorso di implementazione nei seguenti scenari:

È presente un’implementazione tramite l’estensione tag Adobe Analytics. Se hai un'implementazione che utilizza AppMeasurement, segui invece Migrare da AppMeasurement a Web SDK.
Intendi utilizzare il Customer Journey Analytics in futuro, ma non desideri sostituire l’implementazione di Analytics con un’implementazione Web SDK da zero. La sostituzione dell’implementazione da zero su Web SDK richiede il massimo impegno, ma offre anche l’architettura di implementazione a lungo termine più efficiente. Se la tua organizzazione è disposta a passare attraverso l'implementazione di un Web SDK pulito, consulta Inserire dati tramite Adobe Experience Platform Web SDK nella guida utente del Customer Journey Analytics.

Passaggi necessari per migrare a Web SDK

Le seguenti fasi contengono obiettivi concreti da perseguire. Fai clic su ogni passaggio per istruzioni dettagliate su come eseguirlo.

1. Crea e configura un flusso di dati

Creare uno stream di dati in Raccolta dati di Adobe Experience Platform. Quando invii dati a questo stream di dati, questi vengono inoltrati ad Adobe Analytics. In futuro, lo stesso flusso di dati inoltra i dati al Customer Journey Analytics.

Passa a experience.adobe.com e accedi con le tue credenziali.
Utilizzare la home page o il selettore di prodotti in alto a destra per passare a Data Collection.
Nel menu di navigazione a sinistra, selezionare Datastreams.
Seleziona New Datastream.
Immettere il nome desiderato, quindi selezionare Save.
Una volta creato lo stream di dati, selezionare Add Service.
Nel menu a discesa del servizio, selezionare Adobe Analytics.
Immetti lo stesso ID suite di rapporti del sito a cui invii attualmente i dati di analisi. Fai clic su Save.

Aggiungi servizio Adobe Analytics

Il flusso di dati è ora pronto per ricevere e trasmettere dati ad Adobe Analytics.

2. Aggiungi l<>estensione Web SDK alla proprietà tag

Questa sezione prepara il tag per la maggior parte dell’impegno di migrazione che verrà eseguito nel passaggio successivo.

Fai clic sull'icona dell'hamburger in alto a sinistra nell'interfaccia di Adobe Experience Platform, quindi seleziona Tags.
Seleziona la proprietà tag desiderata.
Nel menu di navigazione a sinistra della proprietà tag, seleziona Extensions.
Seleziona Catalog nella parte superiore per visualizzare un elenco di tutte le estensioni disponibili.
Cerca e seleziona l'estensione Adobe Experience Platform Web SDK, quindi fai clic su Install a destra.
Vengono visualizzate le impostazioni di configurazione dell’estensione. Individuate la sezione Flussi di dati e selezionate lo stream di dati creato nel passaggio precedente.
Seleziona Save.

L’SDK web è ora installato nella proprietà del tag.

3. Crea un elemento dati dell<>oggetto dati

L’elemento dati dell’oggetto dati fornisce un framework intuitivo per configurare un payload che l’SDK web utilizza per inviare a un flusso di dati. La maggior parte delle regole che aggiorni nel passaggio seguente interagisce con questo elemento dati.

Nel menu di navigazione a sinistra dell'interfaccia dei tag, selezionare Data Elements.
Seleziona Add Data Element
Attribuisci all’elemento dati le seguenti impostazioni:
- Name: qualsiasi cosa desideri, ad esempio "Livello dati" o "Oggetto dati"
- Extension: Adobe Experience Platform Web SDK
- Data Element Type: Variable
- Le caselle di controllo possono rimanere invariate
A destra, seleziona le impostazioni seguenti:
- Pulsante di scelta Proprietà: Data
- Soluzione: Adobe Analytics
Seleziona Save.

Crea elemento dati

La proprietà tag ora dispone di tutto il necessario per aggiornare ogni regola.

4. Aggiorna le regole per utilizzare l<>estensione Web SDK invece dell<>estensione Analytics

Questo passaggio contiene la maggior parte dello sforzo necessario per migrare all’SDK per web e richiede la conoscenza di come funziona l’implementazione. Di seguito è riportato un esempio di come modificare una tipica regola di tag. Aggiorna tutte le regole di tag nell’implementazione per sostituire tutti i riferimenti all’estensione Adobe Analytics con l’estensione Web SDK.

Nel menu di navigazione a sinistra dell'interfaccia dei tag, selezionare Rules.
Seleziona una regola da modificare.
Selezionare l'azione Adobe Analytics - Set Variables
Nota tutte le variabili di Analytics impostate all’interno di questa regola. Includi sia le variabili impostate nei menu a discesa che le variabili impostate nel codice personalizzato.
Cambia Action Configuration con le impostazioni seguenti:
- Extension: Adobe Experience Platform Web SDK
- Action type: Aggiorna variabile
Assicurati che l’oggetto dati sia selezionato nel menu a discesa a destra.
Imposta le variabili Analytics sugli stessi valori configurati nell’estensione Analytics.
- Le variabili impostate nell’interfaccia dei tag possono tradursi direttamente negli stessi valori.
- Le variabili stringa impostate nel codice personalizzato richiedono regolazioni minime. Anziché utilizzare l'oggetto s, utilizzare data.__adobe.analytics. s.eVar1, ad esempio, tradurrebbe in data.__adobe.analytics.eVar1.
- Le variabili di configurazione e le chiamate ai metodi di Analytics nel codice personalizzato possono richiedere una logica di implementazione modificata. Consulta ogni rispettiva variabile per determinare come ottenere il suo equivalente utilizzando Web SDK.
Dopo aver replicato tutta la logica della regola utilizzando l'estensione Web SDK, selezionare Keep Changes.
Ripeti questi passaggi per ogni configurazione di azione che utilizza l'estensione Adobe Analytics per impostare i valori. Questo passaggio include sia le variabili impostate tramite l’interfaccia tag che quelle impostate tramite il codice personalizzato. I blocchi di codice personalizzato non possono fare riferimento all'oggetto s in alcun punto.

I passaggi precedenti si applicano solo alle regole che impostano valori. I passaggi seguenti sostituiscono tutte le azioni che utilizzano Action Configuration Send Beacon.

Seleziona una regola che invia un beacon.
Selezionare l'azione Adobe Analytics - Send Beacon.
Si noti il valore corrente del pulsante di scelta Tracking a destra (s.t() o s.tl()).
Cambia Action Configuration con le impostazioni seguenti:
- Extension: Adobe Experience Platform Web SDK
- Action type: Send event
A destra, modifica le impostazioni delle azioni come segue:
- Type: Per s.t(), utilizzare Web Webpagedetails Page Views. Per s.tl(), utilizzare Web Webinteraction Link Clicks. Se utilizzi s.tl(), devi includere anche i seguenti campi nell'oggetto dati. Questi campi sono elencati in Additional properties durante l'esecuzione della configurazione dell'azione Update variable:
Seleziona Keep Changes.
Ripeti questi passaggi per ogni configurazione di azione che utilizza Adobe Analytics per inviare un beacon.

5. Regole aggiornate di Publish

La pubblicazione delle regole aggiornate segue lo stesso flusso di lavoro di qualsiasi altra modifica alla configurazione dei tag.

Nel menu di navigazione a sinistra dell'interfaccia dei tag, selezionare Publishing Flow.
Seleziona Add Library.
Assegna un nome al commit del tag, ad esempio "Aggiorna a Web SDK".
Seleziona Add All Changed Resources (Aggiungi set di dati).
Seleziona Save (Salva).
Il flusso di lavoro di pubblicazione visualizza un punto arancione, che indica che è in corso la creazione. Quando il punto diventa verde, le modifiche sono disponibili nell’ambiente di sviluppo.
Verifica le modifiche nell’ambiente di sviluppo per assicurarti che tutte le regole vengano attivate correttamente e che l’oggetto dati venga popolato con i valori previsti.
Quando è pronta, invia la libreria per l’approvazione, la build alla staging, quindi alla fine approva e pubblica in produzione.

Flusso di pubblicazione

6. Disabilita estensione Analytics

Una volta che l’implementazione dei tag è completamente sul Web SDK, puoi disabilitare l’estensione Adobe Analytics.

Nel menu di navigazione a sinistra dell'interfaccia dei tag, selezionare Extensions.
Individuare e selezionare l'estensione Adobe Analytics. A destra, selezionare Disable.
Seguire lo stesso flusso di lavoro di pubblicazione riportato sopra per pubblicare la rimozione dell'estensione Adobe Analytics.
Una volta che l’estensione è disabilitata in produzione, puoi disinstallarla completamente. Seleziona l'estensione, fai clic sul menu a tre punti a destra, quindi seleziona Uninstall.
Segui lo stesso flusso di lavoro di pubblicazione indicato sopra per pubblicare tali modifiche in produzione.

A questo punto, l’implementazione di Analytics si basa interamente sull’SDK per web ed è adeguatamente preparata per passare al Customer Journey Analytics in futuro.

recommendation-more-help