Aggiorna la libreria di raccolta dati, ad Audience Manager dall’estensione tag Audienci Manager all’estensione tag Web SDK
Pubblico previsto
Questa pagina è destinata agli Audienci Manager di clienti che utilizzano Estensione tag Audienci Manager per inserire i dati della raccolta web in Audienci Manager. Per i clienti che utilizzano la libreria JavaScript di AppMeasurement, consulta 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 sul sito: poiché nell’implementazione sono già installati i tag, è possibile eseguire tutti gli aggiornamenti della migrazione nell’interfaccia dei tag.
- Utilizza l’implementazione esistente: questo approccio non richiede una nuova implementazione netta. 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: in questa fase della migrazione all’SDK per web non è necessario uno schema XDM. È invece possibile compilare il
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.
- Obbligo tecnico di attuazione: poiché questo approccio utilizza una forma modificata dell’implementazione esistente, può essere più difficile tracciare la logica di implementazione ed eseguire modifiche quando necessario. Il debug del codice personalizzato può essere particolarmente difficile.
- Richiede la mappatura per inviare dati a Platform: quando la tua organizzazione è pronta per utilizzare Real-Time CDP, devi inviare dati a un set di dati in Adobe Experience Platform. Questa azione richiede che ogni campo nel
dataobject può essere 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 Audienci Manager. In futuro, lo stesso flusso di dati inoltra i dati a Real-Time CDP.
-
Accedi a experience.adobe.com e accedere utilizzando le credenziali.
-
Utilizza la home page o il selettore di prodotti in alto a destra per passare a Data Collection.
-
Nel menu di navigazione a sinistra, seleziona Datastreams.
-
Seleziona New Datastream.
-
Immetti il nome desiderato, quindi seleziona Save.
-
Una volta creato lo stream di dati, seleziona Add Service.
-
Nel menu a discesa del servizio, seleziona Adobe Audience Manager.
-
Assicurati che le Enable XDM Flattened Fields è deselezionata.
Il flusso di dati è ora pronto per ricevere e trasmettere i dati ad Audienci 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 la Adobe Experience Platform Web SDK , quindi seleziona Install sul lato destro.
-
Vengono visualizzate le impostazioni di configurazione dell’estensione. Individua il Datastreams e seleziona la sandbox in uso e lo stream di dati creato nel passaggio precedente.
-
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.
-
Nel menu di navigazione a sinistra dell’interfaccia dei tag, seleziona 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
-
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 Audienci Manager con l’estensione Web SDK.
-
Nel menu di navigazione a sinistra dell’interfaccia dei tag, seleziona Rules.
-
Seleziona una regola da modificare.
-
Seleziona 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.
-
Modificare il Action Configuration alle seguenti impostazioni:
- Extension: Adobe Experience Platform Web SDK
- Action type: Aggiorna variabile
-
Assicurati che l’oggetto dati creato al passaggio 3 sia selezionato nel menu a discesa a destra, nella sezione Data element campo.
-
Imposta le coppie chiave-valore di Audience Manager sugli stessi valori rispettivi configurati nell’estensione di Audience Manager.
-
Una volta replicata tutta la logica della regola utilizzando l’estensione Web SDK, seleziona Keep Changes.
-
Ripeti questi passaggi per ogni configurazione di azione che utilizza l’estensione tag Audienci 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.
-
Seleziona il tipo di azione Send Event.
-
Modificare il Action Configuration alle seguenti impostazioni:
- 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: seleziona l’oggetto dati creato al passaggio 3.
-
Seleziona Keep Changes.
-
Ripeti questi passaggi per ogni configurazione di azione che utilizza Audienci 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, seleziona Publishing Flow.
-
Seleziona Add Library.
-
Assegna un nome al commit del tag, ad esempio "Aggiorna a Web SDK".
-
Seleziona Add All Changed Resources.
-
Seleziona 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 Audienci Manager.
- Nel menu di navigazione a sinistra dell’interfaccia dei tag, seleziona Extensions.
- Individua e seleziona la Audience Manager estensione. A destra, seleziona Disable.
- Segui lo stesso flusso di lavoro di pubblicazione indicato sopra per pubblicare la rimozione del Audience Manager estensione.
- 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 Audienci Manager viene completamente migrata all’SDK per web ed è pronta per il passaggio a Real-Time CDP in futuro.