Aggiorna la libreria di raccolta dati, ad Audience Manager dall’estensione tag Audience Manager all’estensione tag Web SDK
Pubblico previsto
Questa pagina è destinata ai clienti Audienci Manager che utilizzano l'estensione tag Audience Manager per inserire i dati della raccolta Web in Audience Manager. Per i clienti che utilizzano la libreria JavaScript di AppMeasurement, leggere la guida su come aggiornare la libreria di raccolta dati, ad Audience Manager dalla libreria JavaScript di AppMeasurement alla libreria JavaScript dell'SDK Web.
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.
- 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 a Adobe 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 Adobe 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 quando necessario. Il debug del codice personalizzato può essere particolarmente difficile.
- È 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 quando disponi di un’implementazione esistente utilizzando l’estensione tag Adobe Audience Manager.
Passaggi necessari per migrare a Web SDK
Le seguenti fasi contengono obiettivi concreti da perseguire. Seleziona ogni passaggio per istruzioni dettagliate su come eseguirlo.
Segui le istruzioni riportate di seguito per creare un flusso di dati in Raccolta dati di Adobe Experience Platform. Quando invii dati a questo stream di dati, questi vengono inoltrati ad Audience Manager. In futuro, lo stesso flusso di dati inoltra i dati a Real-Time CDP.
-
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.
-
Selezionare 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 Audience Manager.
-
Verificare che l'opzione Enable XDM Flattened Fields sia deselezionata.
Il flusso di dati è ora pronto per ricevere e trasmettere i dati ad Audience Manager.
Questa sezione prepara il tag per la maggior parte dell’impegno di migrazione che verrà eseguito nel passaggio successivo.
-
Seleziona l'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 seleziona Install a destra.
-
Vengono visualizzate le impostazioni di configurazione dell’estensione. Individua la sezione Datastreams e seleziona la sandbox in uso e lo stream di dati creato nel passaggio precedente.
-
Selezionare 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.
-
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.
-
Sul lato destro, selezionare le impostazioni seguenti:
- Pulsante di scelta Proprietà: Data
- Solution: Adobe Audience Manager
-
Selezionare 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 Audience Manager 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 Audience Manager - Set Variables
-
Nota tutte le variabili di Audience Manager 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
-
Verificare che l'oggetto dati creato al passaggio 3 sia selezionato nel menu a discesa a destra, nel campo Data element.
-
Imposta le coppie chiave-valore di Audience Manager sugli stessi valori rispettivi configurati nell’estensione di Audience Manager.
-
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 tag Audience Manager per impostare i valori.
I passaggi precedenti si applicano solo alle regole che impostano valori. I passaggi seguenti sostituiscono tutte le azioni che utilizzano Action Configuration Send Event.
-
Seleziona una regola che invia un evento Web SDK.
-
Selezionare il tipo di azione Send Event.
-
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: Utilizzare Web Webpagedetails Page Views.
- Data: selezionare l'oggetto dati creato al passaggio 3.
-
Selezionare Keep Changes.
-
Ripeti questi passaggi per ogni configurazione di azione che utilizza Audience Manager per inviare un evento.
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.
-
Selezionare Add Library.
-
Assegna un nome al commit del tag, ad esempio "Aggiorna a Web SDK".
-
Selezionare Add All Changed Resources.
-
Selezionare Save.
-
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.
Una volta completata la migrazione dell’implementazione tag all’SDK per web, puoi disabilitare l’estensione Audience Manager.
- Nel menu di navigazione a sinistra dell'interfaccia dei tag, selezionare Extensions.
- Individuare e selezionare l'estensione Audience Manager. A destra, selezionare Disable.
- Seguire lo stesso flusso di lavoro di pubblicazione riportato sopra per pubblicare la rimozione dell'estensione Audience Manager.
- 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 Audience Manager viene completamente migrata all’SDK per web ed è pronta per il passaggio a Real-Time CDP in futuro.