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

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.

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

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

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

1. Fai clic sull'icona dell'hamburger in alto a sinistra nell'interfaccia di Adobe Experience Platform, quindi seleziona Tags.

2. Seleziona la proprietà tag desiderata.

3. Nel menu di navigazione a sinistra della proprietà tag, seleziona Extensions.

4. Seleziona Catalog nella parte superiore per visualizzare un elenco di tutte le estensioni disponibili.

5. Cerca e seleziona l'estensione Adobe Experience Platform Web SDK, quindi fai clic su Install a destra.

   

6. Vengono visualizzate le impostazioni di configurazione dell’estensione. Individuate la sezione Flussi di dati e selezionate lo stream di dati creato nel passaggio precedente.

   

7. Seleziona Save.

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

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.

1. Nel menu di navigazione a sinistra dell'interfaccia dei tag, selezionare Data Elements.

2. Seleziona Add Data Element

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

4. A destra, seleziona le impostazioni seguenti:

   • Pulsante di scelta Proprietà: Data
   • Soluzione: Adobe Analytics

5. Seleziona Save.

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

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.

1. Nel menu di navigazione a sinistra dell'interfaccia dei tag, selezionare Rules.

2. Seleziona una regola da modificare.

3. Selezionare l'azione Adobe Analytics - Set Variables

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

5. Cambia Action Configuration con le impostazioni seguenti:

   • Extension: Adobe Experience Platform Web SDK
   • Action type: Aggiorna variabile

6. Assicurati che l’oggetto dati sia selezionato nel menu a discesa a destra.

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

8. Dopo aver replicato tutta la logica della regola utilizzando l'estensione Web SDK, selezionare Keep Changes.

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

1. Seleziona una regola che invia un beacon.

2. Selezionare l'azione Adobe Analytics - Send Beacon.

3. Si noti il valore corrente del pulsante di scelta Tracking a destra (s.t() o s.tl()).

4. Cambia Action Configuration con le impostazioni seguenti:

   • Extension: Adobe Experience Platform Web SDK
   • Action type: Send event

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

     • Nome collegamento
     • Tipo di collegamento
     • URL collegamento

6. Seleziona Keep Changes.

7. Ripeti questi passaggi per ogni configurazione di azione che utilizza Adobe Analytics per inviare un beacon.

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

1. Nel menu di navigazione a sinistra dell'interfaccia dei tag, selezionare Publishing Flow.
2. Seleziona Add Library.
3. Assegna un nome al commit del tag, ad esempio "Aggiorna a Web SDK".
4. Seleziona Add All Changed Resources (Aggiungi set di dati).
5. Seleziona Save (Salva).
6. 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.
7. 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.
8. Quando è pronta, invia la libreria per l’approvazione, la build alla staging, quindi alla fine approva e pubblica in produzione.

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

1. Nel menu di navigazione a sinistra dell'interfaccia dei tag, selezionare Extensions.
2. Individuare e selezionare l'estensione Adobe Analytics. A destra, selezionare Disable.
3. Seguire lo stesso flusso di lavoro di pubblicazione riportato sopra per pubblicare la rimozione dell'estensione Adobe Analytics.
4. 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.
5. Segui lo stesso flusso di lavoro di pubblicazione indicato sopra per pubblicare tali modifiche in produzione.