Aggiornare la libreria di raccolta dati per Audience Manager da AppMeasurement a Web SDK
Pubblico previsto intended-audience
Questa pagina è destinata ai clienti Audience Manager e Adobe Analytics che utilizzano la libreria JavaScript AppMeasurement per inviare dati Web ad Audience Manager.
Per istruzioni sui passaggi di migrazione a Web SDK, a seconda del metodo di raccolta dati corrente, consulta la tabella seguente.
Panoramica sulla migrazione overview
La migrazione da AppMeasurement a Web SDK è principalmente una migrazione Adobe Analytics. Per i clienti Audience Manager, questa migrazione include anche Audience Manager. È necessario migrare entrambi insieme. Se lavori principalmente con Audience Manager, assicurati di coinvolgere il team di Analytics in questa migrazione.
Se utilizzi AppMeasurement per la raccolta dati di Audience Manager, stai utilizzando l'approccio Server-side Forwarding (SSF) per inviare dati di Analytics ad Audience Manager. In questa configurazione, la richiesta di raccolta dati di Analytics viene inoltrata ad Audience Manager, che gestisce anche la risposta di Audience Manager alla pagina.
Questo è stato l’approccio standard per molti anni ed è probabile che la tua configurazione corrente. Se la libreria AppMeasurement contiene il modulo AudienceManagement e le chiamate di raccolta dati includono il percorso /10/ nella richiesta (/b/ss/examplereportsuite/10/), questa guida fa per te.
Inoltro lato server (SSF) e flussi di dati Web SDK data-flows
Comprendere le differenze di flusso dei dati tra Analytics e Audience Manager durante il passaggio a Web SDK (e Edge Network) è fondamentale per le istruzioni di seguito.
Con l’inoltro lato server, il nodo di raccolta dati regionale di Analytics raccoglie i dati, li trasforma in un segnale accettato da Audience Manager, li invia ad Audience Manager e restituisce la risposta di Audience Manager alla pagina. Il modulo AudienceManagement nella libreria AppMeasurement gestisce quindi la risposta (ad esempio, l'eliminazione di cookie e l'invio di destinazioni URL). Questo processo è denominato inoltro lato server perché Analytics inoltra i dati ad Audience Manager utilizzando i server Adobe.
Con Web SDK, Edge Network invia i dati ad Analytics e Audience Manager in azioni separate. Il Web SDK è un’unica libreria che invia dati a tutte le soluzioni e Edge Network trasforma i punti dati indipendenti dalle soluzioni in formati specifici.
In questo nuovo flusso di dati, tutti i dati vengono inviati a un flusso di dati di Edge Network, che puoi configurare per inviare i dati alle soluzioni Adobe in base alle esigenze. Per Audience Manager, l'abilitazione del servizio Audience Manager nel flusso di dati trasforma XDM e i dati di Analytics in segnali accettati da Audience Manager. Edge Network restituisce anche la risposta di Audience Manager alla pagina, in cui il Web SDK gestisce la risposta, in modo simile a come hanno fatto AppMeasurement e il modulo AudienceManagement.
Migrazione tag e non tag tags-vs-non-tags
Che si utilizzino i tag con l'estensione AppMeasurement, la libreria AppMeasurement in un altro sistema di gestione dei tag o si inserisca AppMeasurement direttamente nella pagina, i passaggi per la migrazione di Audience Manager al Web SDK sono gli stessi. Poiché la migrazione di Audience Manager dipende dalla migrazione di Analytics, i passaggi per la migrazione da AppMeasurement a Web SDK vengono determinati durante la migrazione di Analytics.
Queste informazioni sono trattate nella documentazione di Analytics per le implementazioni basate su Tag o JavaScript.
XDM e i nodi data.__adobe. xdm-data-nodes
Una delle funzioni principali di Web SDK consiste nell'inviare dati a Real-Time Customer Data Platform (RTCDP). Per ottenere questo e raccogliere comunque i dati per altre soluzioni Experience Cloud senza una reimplementazione completa, i dati specifici della soluzione vengono suddivisi nella chiamata al server di raccolta dati. Questa chiamata utilizza uno schema JSON standardizzato denominato Experience Data Model (XDM)
Gli elementi indipendenti dalla soluzione, come le informazioni sul browser e sul dispositivo, vengono inviati ad Edge Network in una struttura XDM predeterminata. Edge Network trasforma questi dati in formati specifici della soluzione. Tuttavia, i dati specifici di Target, Analytics e Audience Manager vengono memorizzati in un nodo data.__adobe dedicato all’interno del payload XDM.
Ad esempio:
- La variabile di Analytics
s.eVar1è rappresentata nel payload XDM comedata.__adobe.analytics.evar1. - Un parametro di Target relativo allo stato di fedeltà del cliente è memorizzato come
data.__adobe.target.loyaltyStatus.
I dati nel nodo __adobe vengono inviati alle rispettive soluzioni (come Analytics e Audience Manager) senza essere inviati ad Experience Platform, anche se il servizio Experience Platform è abilitato nel flusso di dati. Ciò significa che puoi mantenere le configurazioni correnti per Analytics e Audience Manager, avendo al tempo stesso la flessibilità di mappare eventuali elementi di dati necessari agli elementi dello schema XDM per casi d'uso in tempo reale in Experience Platform utilizzando Preparazione dati per raccolta dati.
Ad esempio, la stringa Analytics s.products, utilizzata per segnalare il contenuto del carrello durante l'estrazione, può ancora essere inviata ad Analytics e Audience Manager nel suo formato originale. Allo stesso tempo, puoi utilizzare gli elementi di questa stringa per creare schemi di carrello XDM più intuitivi per i casi di utilizzo di Experience Platform.
Poiché la maggior parte delle implementazioni di Audience Manager si basa sui dati di Analytics inoltrati ad Audience Manager, molte delle espressioni delle caratteristiche di Audience Manager sono probabilmente basate sulle variabili di Analytics (c_evar#, c_prop# e c_events). Per evitare di ricostruire le espressioni delle caratteristiche utilizzando i formati XDM durante la migrazione, per impostazione predefinita Edge Network è configurato per trasformare in segnali Audience Manager tutte le variabili Analytics presenti nel nodo data.__adobe.analytics. Un processo di trasformazione simile si verifica nel flusso di lavoro di inoltro lato server.
Edge Network può eseguire questa trasformazione perché una singola chiamata di raccolta dati dalla pagina viene inviata a un singolo stream di dati che alimenta più soluzioni Adobe. Pertanto, la maggior parte delle migrazioni da AppMeasurement a Web SDK per Analytics e Audience Manager utilizzerà principalmente il nodo data.__adobe.analytics.
Edge Network trasforma i dati del dispositivo e del browser dalle intestazioni del payload XDM e dei pacchetti in segnali Audience Manager. Ciò ti consente di continuare a utilizzare le chiavi della piattaforma h_ e d_ nelle espressioni delle caratteristiche di Audience Manager.
Nodo data.__adobe.audiencemanager data-note
Il nodo data.__adobe.audiencemanager viene utilizzato per le implementazioni di Audience Manager che non si basano su Analytics. Memorizza coppie chiave/valore Audience Manager personalizzate che sono state precedentemente inviate tramite la libreria DIL, come descritto nella guida alla migrazione dell'estensione tag.
Anche se il nodo data.__adobe.audiencemanager non è necessario per la migrazione descritta in questa guida, il nuovo flusso di dati qui spiegato consente di inviare dati ad Audience Manager senza registrarli in Analytics.
Se devi inviare una coppia chiave/valore personalizzata ad Audience Manager senza includerla, puoi utilizzare il nodo data.__adobe.audiencemanager. Tutti i set di dati in questo nodo verranno aggiunti ai dati di Analytics trasformati da Audience Manager nella chiamata al server di raccolta dati.
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.
- Utilizza l'implementazione esistente: anche se questo approccio richiede alcune modifiche di implementazione, non richiede un'implementazione completamente nuova da zero. Puoi utilizzare il livello dati e il codice esistenti con modifiche minime alla logica di implementazione.
- Non richiede uno schema: per questa fase della migrazione al Web SDK non è necessario uno schema XDM. È invece possibile popolare l'oggetto
data, che invia i dati direttamente ad Audience Manager. Una volta completata la migrazione al Web SDK, 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 Audience Manager. 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 in futuro quando necessario.
- È necessaria la mappatura per inviare dati a Platform: quando l'organizzazione è pronta per utilizzare Real-Time CDP, è necessario inviare dati a un set di dati in Adobe Experience Platform. Questa azione richiede che ogni campo nell'oggetto
datasia una voce nello strumento di mappatura dello stream di dati che lo assegna a un campo dello schema XDM. La mappatura deve essere eseguita una sola volta per questo flusso di lavoro e non richiede l’apporto di modifiche all’implementazione. Si tratta tuttavia di un passaggio aggiuntivo non richiesto per l’invio di dati in un oggetto XDM.
Adobe consiglia di seguire questo percorso di implementazione nei seguenti scenari:
- È disponibile un’implementazione esistente utilizzando la libreria JavaScript di Adobe Analytics AppMeasurement. Se disponi di un'implementazione che utilizza l'estensione tag Audience Manager, segui Esegui migrazione dall'estensione tag Audience Manager all'estensione tag Web SDK.
- Intendi utilizzare Real-Time CDP in futuro, ma non desideri sostituire l’implementazione di Audience Manager con un’implementazione di Web SDK da zero. L’alternativa di sostituire l’implementazione da zero con il Web SDK richiede il massimo sforzo, in quanto è necessario ricreare tutte le caratteristiche Audience Manager per cercare dati in formato XDM. Tuttavia, è anche l’architettura di implementazione a lungo termine più redditizia. Se la tua organizzazione è disposta a eseguire un'implementazione pulita di Web SDK, consulta la documentazione di Web SDK invece di utilizzare questa guida, per ulteriori dettagli.
Passaggi necessari per la migrazione al Web SDK
Segui i passaggi seguenti per migrare l’integrazione della raccolta dati a Web SDK.
Aggiungi il servizio Audience Manager al flusso di dati in uso nella migrazione di Analytics indicata al passaggio 1.
-
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 lo stream di dati creato durante la migrazione di Analytics al passaggio 1.
-
Selezionare Add Service.
-
Nel menu a discesa del servizio, selezionare Audience Manager.
-
Controllare le opzioni Cookie Destinations Enabled e URL Destinations Enabled. Queste opzioni consentono all’Edge Network di restituire alla pagina i tipi di destinazione Audience Manager.
-
Assicurarsi che Enable XDM Flattened Fields sia disabilitato. Questa opzione disattiva la trasformazione automatica delle variabili di Analytics in segnali di Audience Manager. Questa opzione è progettata per mantenere la compatibilità con le versioni precedenti per gli utenti che hanno eseguito la migrazione a Web SDK prima che Edge Network trasformasse automaticamente i dati di Analytics in segnali Audience Manager.
note note NOTE La migrazione al Web SDK con l'opzione Enabled XDM Flattened Fields abilitata richiede che tutti i dati necessari in Audience Manager formattati come XDM e tutte le caratteristiche Audience Manager che utilizzano prop, eVar o eventi vengano aggiornati per cercare dati in formato XDM. Adobe consiglia di lasciare questa opzione disattivata. 
-
Selezionare Save per salvare la configurazione dello stream di dati.
Il flusso di dati è ora pronto per ricevere e trasmettere dati ad Audience Manager. Prendi nota dell’ID dello stream di dati, in quanto questo ID è richiesto durante la configurazione del Web SDK nel codice.
-
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 lo stream di dati creato durante la migrazione di Analytics al passaggio 1.
-
Seleziona Edit nell'angolo superiore destro della pagina di configurazione dello stream di dati.
-
Espandere il menu a discesa Advanced Options e abilitare la funzionalità Third Party ID Sync se non è già abilitata. Questa opzione comunica ad Edge Network di restituire le sincronizzazioni ID partner per i partner dati di Audience Manager e Experience Platform.
-
Nella maggior parte dei casi è possibile lasciare vuoto il campo Third Party ID Sync Container ID. Il valore predefinito sarà
0. Tuttavia, se preferisci assicurarsi di utilizzare l’ID contenitore corretto, segui i passaggi successivi:- Apri una finestra del browser in modalità incognito o privata e passa a una pagina che fa parte della migrazione.
- Utilizzare gli strumenti per gli sviluppatori del browser per filtrare la chiamata di rete a
dpm.demdex.net/id. Questa chiamata verrà attivata solo sulla prima pagina di una prima visita, motivo per cui è necessario un browser in incognito o privato. - Visualizza il payload della richiesta. Se il parametro
d_nsidè diverso da zero, copiarlo nel campo Third Party ID Sync Container ID.
-
Selezionare Save.
Il flusso di dati è ora pronto sia per inviare dati ad Audience Manager che per trasmettere le risposte di Audience Manager al Web SDK.
La maggior parte delle implementazioni di Audience Manager utilizza regole di unione profili in scenari di personalizzazione tra dispositivi e per controllare quali segmenti i visitatori possono qualificarsi a seconda del loro stato di autenticazione (connesso o disconnesso). Le regole di unione profili richiedono l’invio ad Audience Manager di un identificatore di proprietà del cliente (ID del sistema di gestione delle relazioni con i clienti, numero account, ecc.) per ogni chiamata di raccolta dati dopo l’autenticazione. In precedenza, la funzione setCustomerIDs del servizio ID visitatore (visitor.js) veniva utilizzata per aggiungere gli ID cliente a ogni chiamata di raccolta dati di Analytics, che veniva quindi inoltrata ad Audience Manager.
Con il Web SDK, queste identità ora devono essere inviate ad Edge Network utilizzando un costrutto XDM speciale denominato IdentityMap.
Per passare correttamente le identità in una mappa di identità è necessario comprendere gli spazi dei nomi di identità e considerare attentamente quali identità trasmettere, soprattutto quando si inviano dati a una sandbox di Experience Platform. Questo articolo illustra queste considerazioni e istruzioni.
Dopo aver determinato le identità da trasmettere e quando, seguire le guide per l'utilizzo dell'Identity map Identity map elemento dati all'interno di Tags o impostarlo manualmente come descritto nella panoramica dei dati delle identità per allinearlo alla strategia di distribuzione di Web SDK.
aam_uuid di prime partiUna pratica standard per molti anni consisteva nell'inserire l'UUID di Audience Manager (il valore nel cookie demdex di terze parti) in un cookie di prima parte solitamente denominato aam_uuid.
Per impostare il cookie, è necessario immettere un nome di cookie nel campo Name della sezione Unique User ID Cookie dell'estensione tag Analytics o nel campo uuidCookie durante la configurazione di audienceManagementModule. Anche se è comunemente configurato nel codice, il cookie è stato utilizzato raramente perché il valore UUID di Audience Manager è un identificatore specifico per il dispositivo e tra domini diversi utilizzato dalle piattaforme pubblicitarie e fornisce poco valore come identificatore di prima parte.
Se l'implementazione richiede che il cookie aam_uuid continui a essere impostato dopo la migrazione al Web SDK, puoi recuperare l'UUID di Audience Manager in due modi.
-
Ogni risposta dall'endpoint di interazione Edge Network contiene un payload con
idnodi. Il nodoiddel payload dello spazio dei nomiCOREcontiene l'UUID di Audience Manager. -
Utilizzare il comando getIdentity del Web SDK per recuperarlo. Utilizza lo spazio dei nomi
COREcome descritto nella documentazione e recupera il valore dal campoidentity.COREnella risposta.
Indipendentemente dal metodo utilizzato per recuperare l’UUID di Audience Manager, spetta al team di sviluppo analizzare la risposta, recuperare l’UUID e impostare il cookie. Non esiste un modo automatico per impostare questo cookie tramite Web SDK.
Configurare Server-Side Forwarding e Audience Analytics nell’interfaccia utente di Analytics Report Suite Manager configure-ssf-analytics
Se hai familiarità con la funzione di inoltro lato server di Analytics, potresti chiederti: "Disabilitare l'impostazione di inoltro lato server nell'interfaccia utente di Analytics Report Suite Manager per impedire l'invio di dati Analytics ad Audience Manager due volte?".
La risposta è no, non disabilitare questa impostazione per i motivi seguenti:
-
Quando il servizio Audience Manager è abilitato in un flusso di dati, Edge Network aggiunge la variabile
cm.ssfa tutte le richieste di raccolta dati inviate ad Analytics. Questo impedisce l’invio dei dati di Analytics anche ad Audience Manager. Tutti i registri di Assurance utilizzati per convalidare la migrazione di Analytics mostreranno la variabilecm.ssf=1quando il servizio Audience Manager è abilitato nel flusso di dati. Per ulteriori dettagli, consulta la pagina dedicata alla conformità di Analytics e RGPD sull'inoltro lato server. -
Questa impostazione abilita anche il flusso di dati per l'integrazione Audience Analytics. Come descritto nella panoramica di Audience Analytics, per questa integrazione è necessario l'inoltro lato server perché la risposta di Audience Manager al server di raccolta dati di Analytics viene aggiunta all'hit di Analytics prima dell'elaborazione. Un processo simile si verifica all’interno di Edge Network. Quando l’inoltro lato server è abilitato, Edge Network aggiunge i segmenti necessari dalla risposta di Audience Manager ai dati inviati ad Analytics.
In sintesi, è importante che questa impostazione rimanga abilitata in modo che Audience Analytics continui a funzionare con un’implementazione di Web SDK e che nessun dato venga conteggiato due volte in Audience Manager.
Convalidare la migrazione validation
Con tutte le soluzioni Adobe ora servite da una singola chiamata Web SDK, i passaggi per la convalida possono cambiare a seconda delle soluzioni servite da Web SDK.
Se Adobe Target o Adobe Journey Optimizer (incluso Decisioning) fanno parte dello stack di soluzioni gestito dall'implementazione, nella pagina saranno presenti più chiamate di rete all'Edge Network. Alcuni sono destinati al recupero di personalizzazioni e offerte, altri alla raccolta dati e al reporting.
Indipendentemente dall’implementazione, i principi generali riportati di seguito si applicano alla verifica del corretto flusso dei dati da e verso Audience Manager tramite Web SDK.
-
La prima chiamata di rete per un primo visitatore di prima pagina verrà effettuata al dominio
adobedc.demdex.nete all'endpoint/interact. Per visualizzare le chiamate di rete effettuate da Web SDK, aprire la scheda per sviluppatori nel browser Web, fare clic sulla scheda Rete e quindi filtrare/interact.
Esistono altri tipi di chiamate SDK Web, ma solointeractchiamate inviano dati a e ottengono un payload di risposta da Edge Network.
-
La risposta alla prima chiamata di rete ha più payload. Uno di questi nodi del payload include diversi sottonodi di tipo
url. Questi nodiurlsono le sincronizzazioni ID di terze parti storicamente attivate dal servizio Visitor ID. Deve essere presente un nodourlper ogni sincronizzazione ID di terze parti configurata nel contenitore (vedi il passaggio 3 sopra).
Inoltre, è possibile filtrare per
demdexe rilevare che ciascuno degli URL a cui si fa riferimento nel payload ha generato una propria richiesta di rete per la sincronizzazione ID, proprio come ha fatto il servizio Visitor ID. Queste sincronizzazioni ID devono essere attivate solo sulla prima pagina di un nuovo visitatore e solo una volta ogni 14 giorni successivi. -
Eventuali richieste
/interactsuccessive utilizzate per la raccolta dati di Analytics e Audience Manager devono contenere i nodidata.__adobe.analyticsnel payload.
Le caratteristiche di Audience Manager che si basano su queste variabili di Analytics, nonché le caratteristiche che utilizzano le chiavi della piattaforma
h_od_, devono continuare a essere compilate.note tip TIP È possibile creare una caratteristica di test con un'espressione di regola che può essere espressa solo se i dati del Web SDK vengono raccolti. Poiché non esiste un ambiente Audience Manager di sviluppo e più siti potrebbero inviare dati alla stessa istanza di Audience Manager, solo l’analisi dei conteggi di popolazione complessivi potrebbe non fornire la convalida necessaria. -
Nella stessa chiamata
/interactin cui vengono passate le variabili Analytics, è possibile trovare qualsiasi cookie o destinazione URL nei nodi di payload della risposta. Le destinazioni URL si troveranno in payload di tipourl(come nelle sincronizzazioni ID di terze parti) e le destinazioni cookie si troveranno in payload di tipocookie.
Inoltre, accertati che i cookie siano stati inseriti nell’archivio dei cookie del browser.
note tip TIP Come nel passaggio di convalida precedente, l’idoneità di un segmento che deve restituire una destinazione cookie è un modo sicuro per garantire il flusso di dati da e verso Audience Manager. -
Se devi passare ID cliente aggiuntivi tramite Identity Map, effettua l’autenticazione nel sito e assicurati che le identità e i relativi parametri associati vengano passati nel nodo Identity Map del payload della richiesta.
note tip TIP Se Adobe Target è una delle soluzioni di ricezione e alcune attività di Target si basano su segmenti di Audience Manager che richiedono il passaggio dell'identità corretta, assicurati che Identity Map sia passato nelle chiamate /interactutilizzate per recuperare personalizzazioni e non solo nelle chiamate di raccolta dati. Adobe Target utilizzerà tali identità nella chiamata lato server ad Audience Manager durante il recupero delle informazioni sui segmenti.