Documentazione Experience Platform Tutorial su Web SDK

Configurare l’inoltro degli eventi con i dati di Platform Web SDK

Last update: Fri Apr 26 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Argomenti:
Web SDK,Tags,Event Forwarding

Creato per:

Beginner
Intermediate
Developer

Scopri come utilizzare l’inoltro degli eventi con i dati di Adobe Experience Platform Web SDK.

L’inoltro degli eventi è un nuovo tipo di proprietà disponibile in Raccolta dati. L’inoltro degli eventi consente di inviare dati a fornitori di terze parti non Adobi direttamente dall’Edge Network di Adobe Experience Platform anziché dal browser tradizionale lato client. Ulteriori informazioni sui vantaggi dell’inoltro degli eventi nel Panoramica sull’inoltro degli eventi.

Diagramma dell’SDK per web e dell’inoltro degli eventi

Per utilizzare l’inoltro degli eventi in Adobe Experience Platform, i dati devono essere inviati all’Edge Network di Adobe Experience Platform utilizzando una o più delle tre opzioni seguenti:

NOTE

Platform Web SDK e Platform Mobile SDK non richiedono la distribuzione tramite tag; tuttavia, si consiglia di utilizzare i tag per distribuire questi SDK.

Dopo aver completato le lezioni precedenti in questo tutorial, invia i dati all’Edge Network di Platform utilizzando Web SDK. Una volta che i dati sono nell’Edge Network di Platform, puoi abilitare l’inoltro degli eventi e utilizzare una proprietà di inoltro degli eventi per inviare dati a soluzioni non Adobi.

Obiettivi di apprendimento

Alla fine di questa lezione, sarai in grado di:

Creare una proprietà di inoltro degli eventi
Collegare una proprietà di inoltro eventi a un flusso di dati dell’SDK web di Platform
Comprendere le differenze tra elementi dati e regole della proprietà tag e elementi dati e regole della proprietà di inoltro eventi
Creare un elemento dati per l’inoltro degli eventi
Configurare una regola per l’inoltro degli eventi
Convalidare una proprietà di inoltro eventi sta inviando correttamente i dati

Prerequisiti

Licenza software che include l'inoltro di eventi. L’inoltro di eventi è una funzione a pagamento di Data Collection. Per ulteriori informazioni, contatta il team del tuo account di Adobe.
L’inoltro degli eventi è abilitato nell’organizzazione Experience Cloud.
Autorizzazione utente per l’inoltro di eventi. (in entrata Admin Console, nel prodotto Adobe Experience Platform Launch, elementi di autorizzazione perPiattaforme > Bordo e tutti Diritti di proprietà). Una volta concesso, dovresti vedere Inoltro eventi nel menu di navigazione a sinistra dell’interfaccia di Data Collection:
Adobe Experience Platform Web SDK o Mobile SDK è configurato per inviare dati ad Edge Network. Devi aver completato le seguenti lezioni di questa esercitazione:
- Configurazione iniziale
- Configurazione tag

Creare una proprietà di inoltro degli eventi

Per prima cosa, crea una proprietà di inoltro degli eventi:

Apri Interfaccia di Data Collection
Seleziona Inoltro eventi dal menu di navigazione a sinistra
Seleziona Nuova proprietà.
Denomina la proprietà. In questo caso, Server-Side - Web SDK Course
Seleziona Salva.

Configurare lo stream di dati

Affinché l’inoltro degli eventi possa utilizzare i dati inviati all’Edge Network di Platform, è necessario collegare la nuova proprietà di inoltro degli eventi creata allo stesso flusso di dati utilizzato per inviare dati alle soluzioni di Adobe.

Per configurare Target nello stream di dati:

Vai a Raccolta dati Interfaccia
Nel menu di navigazione a sinistra, seleziona Flussi di dati
Seleziona il creato in precedenza Luma Web SDK: Development Environment flusso di dati
Seleziona Aggiungi servizio
Seleziona Inoltro eventi come Servizio
Sotto ID proprietà , in questo caso seleziona il nome assegnato alla proprietà di inoltro degli eventi Server-Side - Web SDK Course

Sotto ID ambiente a discesa, seleziona l’ambiente di tag a cui stai collegando l’ambiente di inoltro degli eventi, in questo caso Development

note tip
TIP
Per inviare i dati a un ambiente di inoltro degli eventi che si trova all’esterno dell’organizzazione Adobe, seleziona Immetti manualmente gli ID e incolla un ID. L’ID viene fornito quando crei una proprietà di inoltro degli eventi.

Seleziona Salva.

Ripeti questi passaggi per gli stream di dati di staging e produzione quando sei pronto per promuovere le modifiche tramite il flusso di pubblicazione.

Inoltrare dati dall’Edge Network di Platform a una soluzione non di Adobe

In questo esercizio imparerai a impostare un elemento dati per l’inoltro degli eventi, configurare una regola per l’inoltro degli eventi e convalidare utilizzando uno strumento di terze parti denominato Webhook.site.

NOTE

Un webhook è un modo per integrare diversi sistemi in tempo semi-reale. Webhook.site è uno strumento di terze parti che consente di verificare, testare e automatizzare facilmente (con il generatore di azioni personalizzate visive o WebhookScript) eventuali richieste HTTP o e-mail in arrivo.

IMPORTANT

Per procedere ulteriormente, devi aver già creato e mappato elementi dati su un oggetto XDM, nonché configurato regole di tag e creato tali modifiche all’interno di una libreria in un ambiente di tag. In caso contrario, fare riferimento al Configurazione tag passaggi in prerequisiti sezione. Questi passaggi assicurano che i dati vengano inviati alla rete Edge di Platform e da lì puoi configurare una proprietà di inoltro degli eventi per inoltrare i dati a una soluzione non Adobe.

Creare un elemento dati per l’inoltro degli eventi

L’oggetto XDM configurato in precedenza utilizzando l’estensione tag Platform Web SDK diventa l’origine dati per gli elementi dati in una proprietà di inoltro degli eventi. Come origine dati per l’inoltro degli eventi puoi utilizzare gli stessi dati già configurati nella proprietà tag.

IMPORTANT

Esiste una differenza di sintassi chiave quando si fa riferimento a campi XDM nell’inoltro degli eventi rispetto ad altri contesti. Per fare riferimento ai dati in una proprietà di inoltro degli eventi, il percorso dell'elemento dati deve includere arc.event prefisso:

arc sta per Adobe Response Context (Contesto di risposta Adobe).
Ad esempio: arc.event.xdm.web.webPageDetails.URL

Se il percorso specificato non è corretto, i dati non vengono raccolti.

In questo esercizio, inoltrerai l’altezza del riquadro di visualizzazione del browser e l’ID Experience Cloud dall’oggetto XDM a un webhook. Il percorso del campo XDM è determinato dallo schema XDM creato durante il Configurare uno schema XDM lezione.

TIP

Puoi anche trovare il percorso dell’oggetto XDM utilizzando gli strumenti di rete del browser web, filtrando per /ee richieste, apertura del beacon Payload ed eseguire il drilling verso il basso fino alla variabile desiderata. Quindi fare clic con il pulsante destro del mouse e selezionare "Copia percorso proprietà". Di seguito è riportato un esempio per l’altezza del riquadro di visualizzazione del browser:

Vai a Inoltro eventi proprietà creata di recente
Nel menu di navigazione a sinistra, seleziona Elementi dati
Seleziona per Creare un nuovo elemento dati
Nome l’elemento dati environment.browserDetails.viewportHeight
Sotto Estensione, congedo CORE
Sotto Tipo di elemento dati, seleziona Path
Digitare il percorso dell'oggetto XDM contenente l'altezza del riquadro di visualizzazione del browser arc.event.xdm.environment.browserDetails.viewportHeight
Seleziona Salva
Creare un altro elemento dati
Nome it ecid
Sotto Estensione, congedo CORE
Sotto Tipo di elemento dati, seleziona Path
Digitare il percorso dell'oggetto XDM che contiene l'ID Experience Cloud arc.event.xdm.identityMap.ECID.0.id

Seleziona Salva

Percorso ECID di inoltro eventi

note caution
CAUTION
Assicurati di includere `arc.event.` nel percorso. Inoltre, accertati di seguire la stessa maiuscola del nome del campo Oggetto XDM: lo spazio dei nomi ECID deve essere in maiuscolo.

note tip

TIP

Quando lavori con il tuo sito web, puoi trovare il percorso dell’oggetto XDM con gli strumenti di rete del browser web, filtrando per /ee richieste, apertura del beacon Payload ed eseguire il drilling verso il basso fino alla variabile desiderata. Quindi fare clic con il pulsante destro del mouse e selezionare "Copia percorso proprietà". Di seguito è riportato un esempio per l’altezza del riquadro di visualizzazione del browser:

Installare l’estensione Adobe Cloud Connector

Per inviare dati a percorsi di terze parti, installi prima il Connettore cloud Adobe estensione.

Seleziona Estensioni nel menu di navigazione a sinistra
Seleziona la Catalogo scheda
Cerca Connettore cloud Adobe, seleziona Installa

Non è necessaria alcuna configurazione di estensione. Con questa estensione, ora puoi inoltrare i dati a una soluzione non basata su Adobi.

Creare una regola per l’inoltro degli eventi

Esistono alcune differenze principali tra la configurazione delle regole in una proprietà tag e una regola in una proprietà di inoltro eventi:

Eventi E Condizioni:
- Tag: tutte le regole vengono attivate da un evento che deve essere specificato nella regola, ad esempio, Library Loaded - Page Top. Le condizioni sono facoltative.
- Inoltro eventi: si presume che ogni evento inviato all’Edge Network di Platform sia un trigger per l’inoltro di dati. Pertanto, non vi sono Eventi che deve essere selezionato nelle regole di inoltro degli eventi. Per gestire gli eventi che attivano una regola di inoltro degli eventi, è necessario configurare le condizioni.
Tokenizzazione degli elementi dati:
- Tag: i nomi degli elementi dati sono tokenizzati con un simbolo % all'inizio e alla fine del nome dell'elemento dati quando viene utilizzato in una regola. Ad esempio, %viewportHeight%.
- Inoltro eventi: i nomi degli elementi dati sono tokenizzati con {{ all'inizio e }} alla fine del nome dell’elemento dati quando viene utilizzato in una regola. Ad esempio, {{viewportHeight}}.
Sequenza di azioni della regola:
- La sezione Azioni di una regola di inoltro degli eventi viene sempre eseguita in sequenza. Quando salvi una regola, assicurati che l’ordine delle azioni sia corretto. Questa sequenza di esecuzione non può essere eseguita in modo asincrono come con i tag.

Per configurare una regola per l’inoltro di dati al webhook, devi prima ottenere il webhook personale:

Vai a Webhook.site
Trova L’URL univoco, utilizzalo come richiesta URL nella regola di inoltro degli eventi
Seleziona Copia negli Appunti
Lascia aperta questa finestra perché potrai convalidare i dati di inoltro degli eventi in tempo reale acquisiti da Webhook
Torna indietro Raccolta dati > Inoltro eventi > Regole dal menu di navigazione a sinistra
Seleziona Crea nuova regola
Assegna un nome all events - ad cloud connector - webhook
Aggiungi un'azione
Sotto Estensione, seleziona Connettore cloud Adobe
Sotto Tipo di azione, seleziona Effettua chiamata di recupero
Incolla l’URL del webhook in URL campo
Sotto [Parametri query], verranno aggiunti entrambi gli elementi dati creati in precedenza.
Il giorno Chiave tipo di colonna in viewPortHeight. Il giorno Valore , immetti il {{environment.browserDetails.viewportHeight}} elemento dati digitandolo o selezionandolo dall'icona del selettore dell'elemento dati
Seleziona + Aggiungi altro per aggiungere un altro parametro di query
Il giorno Chiave tipo di colonna in ecid. Nella colonna Valore immettere il valore {{ecid}} elemento dati
Seleziona Mantieni modifiche
La regola dovrebbe essere simile a quella riportata di seguito
Seleziona Salva

Creare e generare la libreria

Crea una libreria e crea tutte le modifiche nell’ambiente di sviluppo per l’inoltro degli eventi come si farebbe normalmente in una proprietà tag.

NOTE

Se non hai collegato le proprietà di inoltro degli eventi di staging e produzione allo stream di dati, vedrai l’ambiente di sviluppo come unica opzione per generare una libreria in.

Salva regola di inoltro degli eventi

Convalida regola di inoltro eventi

Ora puoi convalidare la proprietà di inoltro degli eventi utilizzando Platform Debugger e Webhook.site:

Segui i passaggi per cambiare la libreria di tag il Sito dimostrativo Luma alla proprietà tag dell’SDK web a cui è stata mappata la proprietà di inoltro degli eventi nello stream di dati.
Prima di ricaricare la pagina, apri Experienci Platform Debugger Registri dal menu di navigazione a sinistra
Seleziona la Bordo , quindi seleziona Connetti per visualizzare le richieste di Edge Network di Platform
Ricarica la pagina
Vedrai ulteriori richieste che ti danno visibilità sulle richieste lato server inviate dall’Edge Network di Platform al WebHook
La richiesta su cui concentrarsi sulla convalida è quella che mostra l’URL completamente costruito inviato dalla rete Edge
Osserva i parametri viewPortHeight e della stringa di query ecid
Corrispondono ai dati visualizzati nell’oggetto XDM
Infine, convalida le corrispondenze dei dati in Webhook.site nonché visualizzando la finestra del webhook aperta

Congratulazioni! Hai configurato l’inoltro degli eventi.

NOTE

Grazie per aver dedicato il tuo tempo all’apprendimento di Adobe Experience Platform Web SDK. Se hai domande, vuoi condividere commenti generali o suggerimenti su contenuti futuri, condividili su questo Experience League post di discussione community

recommendation-more-help

8cbc0fd8-ca1d-433b-9c3d-bc3f113347d4