Documentazione Experience Platform Tutorial su Web SDK

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

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Argomenti:

Creato per:

Principiante
Intermedio
Sviluppatore

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 nella Panoramica sull'inoltro degli eventi.

Diagramma di Web SDK e inoltro 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 Admin Console, nel prodotto Adobe Experience Platform Launch, elementi di autorizzazione per Piattaforme > Edge e tutti Diritti proprietà). Una volta concesso, dovresti visualizzare Inoltro eventi nell'area 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 l'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 all'interfaccia Raccolta dati
Nel menu di navigazione a sinistra, seleziona Flussi di dati
Seleziona lo stream di dati Luma Web SDK: Development Environment creato in precedenza
Seleziona Aggiungi servizio
Seleziona Inoltro eventi come Servizio
Nel menu a discesa ID proprietà, seleziona il nome assegnato alla proprietà di inoltro degli eventi, in questo caso Server-Side - Web SDK Course

Nel menu a discesa ID ambiente, 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, selezionare Immetti manualmente gli ID e incollali in 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 messaggi di posta elettronica 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, consulta i passaggi Configurazione tag nella sezione prerequisiti. Questi passaggi assicurano che i dati vengano inviati all’Edge Network 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 il prefisso arc.event:

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 la lezione Configurare uno schema XDM.

TIP

Puoi anche trovare il percorso dell'oggetto XDM utilizzando gli strumenti di rete del browser Web, filtrando per /ee richieste, aprendo il beacon Payload ed eseguendo il drilling verso il basso alla variabile cercata. 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 alla proprietà Inoltro eventi creata di recente
Nel menu di navigazione a sinistra, seleziona Elementi dati
Seleziona per creare un nuovo elemento dati
Denomina l'elemento dati environment.browserDetails.viewportHeight
In Estensione, lascia CORE
In Tipo elemento dati, selezionare Path
Digitare il percorso dell'oggetto XDM che contiene l'altezza del riquadro di visualizzazione del browser arc.event.xdm.environment.browserDetails.viewportHeight
Seleziona Salva
Creare un altro elemento dati
Nome ecid
In Estensione, lascia CORE
In Tipo elemento dati, selezionare 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
Assicurarsi di includere il prefisso `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, filtrare /ee richieste, aprire il beacon Payload ed espandere la variabile che stai cercando. 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 l'estensione Adobe Cloud Connector.

Seleziona Estensioni nel menu di navigazione a sinistra
Seleziona la scheda Catalogo
Cerca il 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. Non ci sono quindi Eventi da selezionare nelle regole di inoltro degli eventi. Per gestire gli eventi che attivano una regola di inoltro degli eventi, è necessario configurare le condizioni.
Tokenizzazione elemento dati:
- Tag: i nomi degli elementi dati sono tokenizzati con un simbolo % all'inizio e alla fine del nome quando vengono utilizzati in una regola. Ad esempio, %viewportHeight%.
- Inoltro eventi: i nomi degli elementi dati sono tokenizzati con {{ all'inizio e }} alla fine del nome quando vengono utilizzati 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 dalla navigazione a sinistra
Seleziona Crea nuova regola
Denomina all events - ad cloud connector - webhook
Aggiungi un'azione
In Estensione, seleziona Connettore cloud Adobe
In Tipo azione, seleziona Esegui chiamata di recupero
Incolla l'URL del webhook nel campo URL
In [Parametri query] verranno aggiunti entrambi gli elementi dati creati in precedenza.
Nella Chiave tipo di colonna in viewPortHeight. Nella colonna Valore immettere l'elemento dati {{environment.browserDetails.viewportHeight}} digitandolo o selezionandolo dall'icona del selettore dell'elemento dati
Seleziona + Aggiungi altro per aggiungere un altro parametro di query
Nella Chiave tipo di colonna in ecid. Nella colonna Valore immettere l'elemento dati {{ecid}}
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 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 sul sito dimostrativo Luma nella proprietà tag dell'SDK Web a cui hai mappato la proprietà di inoltro eventi nello stream di dati.
Prima di ricaricare la pagina, nel Debugger di Experience Platform apri Registri dalla navigazione a sinistra
Seleziona la scheda Edge, quindi seleziona Connetti per visualizzare le richieste di Edge Network della piattaforma
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 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 in questo Experience League post di discussione della community

recommendation-more-help

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