Aggiorna la libreria di raccolta dati, ad Audience Manager dalla libreria JavaScript di AppMeasurement alla libreria JavaScript dell’SDK per web
Pubblico previsto intended-audience
Questa pagina è destinata ai clienti Adobe Analytics, ad Audience Manager, che utilizzano la libreria JavaScript AppMeasurement per inviare dati Web ad Audience Manager.
Fai riferimento alla tabella seguente per istruzioni sui passaggi di migrazione a Web SDK, a seconda del metodo di raccolta dati corrente.
Panoramica sulla migrazione overview
La migrazione da AppMeasurement a Web SDK è principalmente una migrazione Adobe Analytics. Ad Audience Manager, i clienti di questa migrazione includono anche Audience Manager. È necessario migrare entrambi insieme. Se lavori principalmente con Audience Manager, assicurati di coinvolgere il team 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 dell'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 dell’SDK per web data-flows
Comprendere le differenze di flusso dei dati tra Analytics e Audience Manager durante il passaggio a Web SDK (e l’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 dell’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 Adobe Server.
Con Web SDK, l’Edge Network invia i dati ad Analytics e l’Audience Manager in azioni separate. L’SDK per web è una singola libreria che invia dati a tutte le soluzioni e l’Edge Network trasforma i punti dati indipendenti dalle soluzioni in formati specifici della soluzione.
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. Ad Audience Manager, l'abilitazione del servizio Audience Manager nel flusso di dati trasforma i dati XDM e Analytics in segnali accettati da Audience Manager. L'Edge Network restituisce anche la risposta dell'Audience Manager alla pagina, in cui 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 a Web SDK sono gli stessi. Poiché la migrazione di Audience Manager dipende dalla migrazione di Analytics, i passaggi per migrare da AppMeasurement a Web SDK sono 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 in compartimenti all’interno della 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 all’Edge Network in una struttura XDM predeterminata. L’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 nello stream 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.
La stringa Analytics s.products, ad esempio, 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, ad Experience Platform casi d’uso.
Poiché la maggior parte delle implementazioni di Audience Manager si basa sui dati di Analytics inoltrati ad Audience Manager, molte delle espressioni di caratteristiche di Audience Manager sono probabilmente basate sulle variabili di Analytics (c_evar#, c_prop# e c_events). Per evitare di ricostruire le espressioni di caratteristiche utilizzando i formati XDM durante la migrazione, per impostazione predefinita l’Edge Network è configurato per trasformare in segnali di Audience Manager tutte le variabili Analytics trovate nel nodo data.__adobe.analytics. Questo processo è simile al flusso di lavoro di inoltro lato server.
L’Edge Network può eseguire questa trasformazione perché una singola chiamata di raccolta dati dalla pagina viene inviata a un singolo flusso 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.
L’Edge Network trasforma i dati del dispositivo e del browser dalle intestazioni del payload e dei pacchetti XDM in segnali di Audience Manager. Ciò ti consente di continuare a utilizzare le chiavi della piattaforma h_ e d_ nelle espressioni con caratteristiche Audienci Manager.
Nodo data.__adobe.audiencemanager data-note
Il nodo data.__adobe.audiencemanager viene utilizzato per implementazioni di Audience Manager che non si basano su Analytics. Memorizza coppie chiave/valore di 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 in Analytics, puoi utilizzare il nodo data.__adobe.audiencemanager. Tutti i set di dati in questo nodo verranno aggiunti ai dati di Analytics trasformati dall’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 all'SDK Web, non è necessario uno schema XDM. È invece possibile popolare l'oggetto
data, che invia i dati direttamente ad Audience Manager. 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 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.
L’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 Audience Manager 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 eseguire un'implementazione pulita di Web SDK, consulta la documentazione di Web SDK per ulteriori dettagli.
Passaggi necessari per migrare a Web SDK
Segui i passaggi seguenti per migrare l’integrazione della raccolta dati a Web SDK.
Aggiungi il servizio Audience Manager allo stream di dati creato durante il 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 dell’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 l’Edge Network trasformasse automaticamente i dati di Analytics in segnali di Audience Manager.
note note NOTE La migrazione a 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 i dati ad Audience Manager. Prendi nota dell’ID dello stream di dati, in quanto questo ID è richiesto durante la configurazione dell’SDK web 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 all’Edge Network di restituire le sincronizzazioni ID partner, ad Audience Manager i partner dati di 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 all’SDK per web.
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 all’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 all'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 le identità da trasmettere, in particolare 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.
Configurare Server-Side Forwarding e l’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 di Analytics ad Audience Manager due volte?".
La risposta è no, non disabilitare questa impostazione. Ecco il motivo:
Quando questa impostazione è abilitata e il modulo AudienceManagement viene aggiunto alla libreria AppMeasurement della pagina, anche tutti i dati inviati a tale suite di rapporti verranno trasmessi a Audience Manager.
Per rispettare le normative sulla privacy del RGPD, esistono scenari in cui i dati possono essere raccolti in Analytics ma non in Audience Manager. Inoltre, in alcuni casi coinvolgono suite di rapporti globali e casi d’uso specifici per area geografica, alcune chiamate di raccolta dati non devono essere inviate ad Audience Manager. Per risolvere questo problema, Adobe ha introdotto un "pulsante off" per l’inoltro lato server.
Come spiegato nella pagina di conformità di Analytics e RGPD incentrata sull'inoltro lato server, l'aggiunta della variabile di contesto cm.ssf=1 a un server di raccolta dati di Analytics impedisce l'inoltro della chiamata di raccolta dati a Audience Manager.
Per due motivi è consigliabile non disattivare questa impostazione.
- Quando il servizio Audience Manager è abilitato in un flusso di dati, l'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 nello stream di dati. - Questa impostazione abilita anche il flusso di dati per l'integrazione Audience Analytics. Come descritto nell'panoramica dell'Audience Analytics, per questa integrazione è necessario l'inoltro lato server perché la risposta dell'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 dell’Edge Network. Quando l’inoltro lato server è abilitato, l’Edge Network aggiunge i segmenti necessari dalla risposta dell’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 dell’SDK web e che nessun dato venga conteggiato due volte in Audience Manager.