DocumentazioneExperience PlatformTutorial su Web SDK

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

Last update: Thu Jul 31 2025 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 Adobe direttamente dall’Edge Network di Adobe Experience Platform invece del browser tradizionale lato client. Ulteriori informazioni sui vantaggi dell'inoltro degli eventi nella Panoramica sull'inoltro degli eventi.

Diagramma Web SDK e inoltro eventi

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

  • Adobe Experience Platform Web SDK
  • Adobe Experience Platform Mobile SDK
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 questa esercitazione, dovresti inviare dati a Platform Edge Network utilizzando il Web SDK. Una volta che i dati sono in Platform Edge Network, puoi abilitare l’inoltro degli eventi e utilizzare una proprietà di inoltro degli eventi per inviare dati a soluzioni non Adobe.

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 uno stream di dati di Platform Web SDK
  • 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:
    Proprietà inoltro eventi

  • Adobe Experience Platform Web o Mobile SDK è configurato per inviare dati ad Edge Network. Devi aver completato le seguenti lezioni di questa esercitazione:

    • Configurazione iniziale

      • Configurare uno schema XDM
      • Configurare uno spazio dei nomi delle identità
      • Configurare uno stream di dati

    • Configurazione tag

      • Installare l’estensione Web SDK
      • Creare elementi dati
      • Creare identità
      • Creare regole di tag
      • Convalida con Adobe Experience Platform Debugger

Creare una proprietà di inoltro degli eventi

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

  1. Apri l'interfaccia di Data Collection

  2. Seleziona Inoltro eventi dal menu di navigazione a sinistra

  3. Seleziona Nuova proprietà.
    Proprietà inoltro eventi

  4. Denomina la proprietà. In questo caso, Server-Side - Web SDK Course

  5. Seleziona Salva.
    salvataggio proprietà di inoltro eventi

Configurare lo stream di dati

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

Per configurare Target nello stream di dati:

  1. Vai all'interfaccia Raccolta dati

  2. Nel menu di navigazione a sinistra, seleziona Flussi di dati

  3. Seleziona lo stream di dati Luma Web SDK: Development Environment creato in precedenza

    Seleziona lo stream di dati di SDK Web Luma

  4. Seleziona Aggiungi servizio
    Aggiungi un servizio allo stream di dati

  5. Seleziona Inoltro eventi come Servizio

  6. Nel menu a discesa ID proprietà, seleziona il nome assegnato alla proprietà di inoltro degli eventi, in questo caso Server-Side - Web SDK Course

  7. 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

    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.

  8. Seleziona Salva.

    Abilitazione Datastream Inoltro Eventi

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 da Platform Edge Network a una soluzione non 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 a Platform Edge Network 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’Experience Cloud ID 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:
​> Percorso XDM per inoltro eventi

  1. Vai alla proprietà Inoltro eventi creata di recente

  2. Nel menu di navigazione a sinistra, seleziona Elementi dati

  3. Seleziona per creare un nuovo elemento dati

    Inoltro eventi nuovo elemento dati

  4. Denomina l'elemento dati environment.browserDetails.viewportHeight

  5. In Estensione, lascia CORE

  6. In Tipo elemento dati, selezionare Path

  7. Digitare il percorso dell'oggetto XDM che contiene l'altezza del riquadro di visualizzazione del browser arc.event.xdm.environment.browserDetails.viewportHeight

  8. Seleziona Salva

    Percorso ECID di inoltro eventi

  9. Creare un altro elemento dati

  10. Nome ecid

  11. In Estensione, lascia CORE

  12. In Tipo elemento dati, selezionare Path

  13. Digitare il percorso dell'oggetto XDM che contiene l'ID Experience Cloud arc.event.xdm.identityMap.ECID.0.id

  14. Seleziona Salva

    Percorso ECID di inoltro eventi

    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.
    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:
    Percorso XDM per inoltro eventi

Installare l’estensione Adobe Cloud Connector

Per inviare dati a percorsi di terze parti, installi prima l'estensione Adobe Cloud Connector.

  1. Seleziona Estensioni nel menu di navigazione a sinistra

  2. Seleziona la scheda Catalogo

  3. Cerca il connettore Adobe Cloud, seleziona Installa

    Percorso ECID di inoltro eventi

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

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 a Platform Edge Network 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:

  1. Vai a Webhook.site

  2. Trova l'URL univoco, utilizzalo come richiesta URL nella regola di inoltro degli eventi

  3. Seleziona Copia negli Appunti

  4. Lascia aperta questa finestra perché potrai convalidare i dati di inoltro degli eventi in tempo reale acquisiti da Webhook

    Copia URL webhook

  5. Torna indietro Raccolta dati > Inoltro eventi > Regole dalla navigazione a sinistra

  6. Seleziona Crea nuova regola

    Inoltro eventi: nuova regola

  7. Denomina all events - ad cloud connector - webhook

  8. Aggiungi un'azione

  9. In Estensione, seleziona Connettore cloud Adobe

  10. In Tipo azione, seleziona Esegui chiamata di recupero

  11. Incolla l'URL del webhook nel campo URL

    Copia URL webhook

  12. In [Parametri query] verranno aggiunti entrambi gli elementi dati creati in precedenza.

  13. 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

  14. Seleziona + Aggiungi altro per aggiungere un altro parametro di query

  15. Nella Chiave tipo di colonna in ecid. Nella colonna Valore immettere l'elemento dati {{ecid}}

  16. Seleziona Mantieni modifiche

    Aggiungi parametro query

  17. La regola dovrebbe essere simile a quella riportata di seguito

  18. Seleziona Salva

    Salva regola di inoltro eventi

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:

  1. Segui i passaggi per cambiare la libreria di tag sul sito dimostrativo Luma nella proprietà tag di Web SDK a cui hai mappato la proprietà di inoltro degli eventi nello stream di dati.

  2. Prima di ricaricare la pagina, nel debugger di Experience Platform apri Registri dal menu di navigazione a sinistra

  3. Seleziona la scheda Edge, quindi seleziona Connetti per visualizzare le richieste di Platform Edge Network

    Sessione rete Edge di inoltro eventi

  4. Ricarica la pagina

  5. Vedrai ulteriori richieste che ti danno visibilità sulle richieste lato server inviate da Platform Edge Network a WebHook

  6. La richiesta su cui concentrarsi sulla convalida è quella che mostra l’URL completamente costruito inviato dalla rete Edge

    Debugger inoltro eventi

  7. Osserva i parametri viewPortHeight e della stringa di query ecid

    Linoltro degli eventi convalida le stringhe di query

  8. Corrispondono ai dati visualizzati nell’oggetto XDM

    Dati corrispondenti allinoltro eventi

  9. Infine, convalida le corrispondenze dei dati in Webhook.site visualizzando la finestra del webhook aperta

    Dati del sito Web del webhook di inoltro eventi

Congratulazioni! Hai configurato l’inoltro degli eventi.

NOTE
Grazie per aver dedicato tempo all'apprendimento di Adobe Experience Platform Web SDK. Se hai domande, vuoi condividere commenti generali o suggerimenti su contenuti futuri, condividili in questo post di discussione della community Experience League
recommendation-more-help
8cbc0fd8-ca1d-433b-9c3d-bc3f113347d4