Configurare un evento unitario

Ultimo aggiornamento: 2023-12-29
  • Argomenti:
  • Journeys
    Visualizza ulteriori informazioni su questo argomento
  • Events
    Visualizza ulteriori informazioni su questo argomento
  • Creato per:
  • Intermediate
    Experienced
    Developer
    Admin

Gli eventi unitari sono collegati a un profilo specifico. Possono essere basate su regole o generate dal sistema. Ulteriori informazioni sull’evento unitario questa sezione.

Di seguito sono riportati i primi passaggi per configurare un nuovo evento:

  1. Nella sezione del menu ADMINISTRATION, selezionare Configurazioni. In Eventi , fare clic su Gestisci. Viene visualizzato l’elenco degli eventi.

  2. Clic Crea evento per creare un nuovo evento. Il riquadro di configurazione dell’evento si apre sul lato destro dello schermo.

  3. Inserisci il nome dell’evento. Puoi anche aggiungere una descrizione.

    NOTA

    Non utilizzare spazi o caratteri speciali. Non usare più di 30 caratteri.

  4. In Tipo campo, scegli Unitario.

  5. In Tipo ID evento , seleziona il tipo di ID evento che desideri utilizzare: Basato su regole o Generato dal sistema. Ulteriori informazioni sui tipi di ID evento in questa sezione.

  6. Il numero di percorsi che utilizzano questo evento viene visualizzato nel Utilizzato in campo. Puoi fare clic su Visualizza percorsi per visualizzare l’elenco dei percorsi che utilizzano questo evento.

  7. Definisci i campi dello schema e del payload: in questo punto è possibile selezionare le informazioni sull’evento, solitamente denominato payload, che i percorsi prevedono di ricevere. Potrai quindi utilizzare queste informazioni nel tuo percorso. Consulta questa sezione.

    NOTA

    Quando selezioni il Generato dal sistema tipo, sono disponibili solo gli schemi che hanno il campo tipo eventID. Quando selezioni il Basato su regole Tipo, sono disponibili tutti gli schemi Experience Event.

  8. Per gli eventi basati su regole, fai clic su all’interno del Condizione ID evento campo. Utilizzando l’editor di espressioni semplici, definisci la condizione che verrà utilizzata dal sistema per identificare gli eventi che attiveranno il percorso.

    Nel nostro esempio, abbiamo scritto una condizione basata sulla città del profilo. Ciò significa che ogni volta che il sistema riceve un evento che corrisponde a questa condizione (Città campo e Parigi ), la trasmetterà ai percorsi.

    NOTA

    L’editor di espressioni avanzate non è disponibile quando si definisce Condizione ID evento. Nell’editor delle espressioni semplici non tutti gli operatori sono disponibili, ma dipendono dal tipo di dati. Ad esempio, per un tipo di stringa di campo, puoi utilizzare "contains" o "equal to".

    Se modifichi lo schema con nuovi valori di enumerazione dopo aver creato l’evento, segui questi passaggi per applicare le modifiche all’evento esistente: deseleziona il campo di enumerazione dai campi dell’evento, conferma la selezione, quindi seleziona nuovamente il campo di enumerazione. Viene ora visualizzato il nuovo valore di enumerazione.

  9. Aggiungi uno spazio dei nomi. Questo passaggio è facoltativo ma consigliato, poiché l’aggiunta di uno spazio dei nomi consente di sfruttare le informazioni memorizzate nel servizio Profilo cliente in tempo reale, definendo il tipo di chiave di cui dispone l’evento. Consulta questa sezione.

  10. Definire l’identificatore del profilo: scegli un campo dai campi del payload o definisci una formula per identificare la persona associata all’evento. Se selezioni uno spazio dei nomi, questa chiave viene impostata automaticamente, ma può essere comunque modificata. In effetti, i percorsi selezionano la chiave che deve corrispondere allo spazio dei nomi, ad esempio, se scegli uno spazio dei nomi e-mail, verrà selezionata la chiave e-mail. Consulta questa sezione.

  11. Fai clic su Salva.

    L’evento è ora configurato e pronto per essere rilasciato in un percorso. Per poter ricevere gli eventi sono necessari ulteriori passaggi di configurazione. Consulta questa pagina.

Definire i campi payload

La definizione del payload consente di scegliere le informazioni che il sistema si aspetta di ricevere dall’evento nel percorso e la chiave per identificare quale persona è associata all’evento. Il payload si basa sulla definizione del campo XDM di Experience Cloud. Per ulteriori informazioni su XDM, consulta Documentazione di Adobe Experience Platform.

  1. Seleziona uno schema XDM dall’elenco e fai clic sul pulsante Campi campo o sul Modifica icona.

    Vengono visualizzati tutti i campi definiti nello schema. L’elenco dei campi varia da uno schema all’altro. Puoi cercare un campo specifico o utilizzare i filtri per visualizzare tutti i nodi e i campi o solo i campi selezionati. In base alla definizione dello schema, alcuni campi possono essere obbligatori e preselezionati. Non è possibile deselezionarli. Per impostazione predefinita, vengono selezionati tutti i campi obbligatori per consentire la corretta ricezione dell’evento da parte dei percorsi.

    NOTA

    Per gli eventi generati dal sistema, accertati di aver aggiunto il gruppo di campi "orchestrazione" allo schema XDM. In questo modo lo schema conterrà tutte le informazioni necessarie per lavorare con Journey Optimizer.

  2. Seleziona i campi che prevedi di ricevere dall’evento. Questi sono i campi che l’utente aziendale sfrutterà nel percorso. Devono inoltre includere la chiave che verrà utilizzata per identificare la persona associata all’evento (vedi questa sezione).

    NOTA

    Per gli eventi generati dal sistema, eventID viene aggiunto automaticamente nell’elenco dei campi selezionati in modo che Journey Optimizer può identificare l’evento. Il sistema che trasmette l’evento non deve generare un ID, deve utilizzare quello disponibile nell’anteprima del payload. Consulta questa sezione.

  3. Dopo aver selezionato i campi necessari, fai clic su Ok o premere Invio.

    Il numero di campi selezionati viene visualizzato nel Campi campo.

Selezionare lo spazio dei nomi

Lo spazio dei nomi consente di definire il tipo di chiave utilizzato per identificare la persona associata all’evento. La sua configurazione è facoltativa. È necessario se desideri recuperare nei tuoi percorsi informazioni aggiuntive provenienti da Profilo cliente in tempo reale. La definizione dello spazio dei nomi non è necessaria se utilizzi solo dati provenienti da un sistema di terze parti tramite un’origine dati personalizzata.

Puoi utilizzare uno dei predefiniti o crearne uno nuovo utilizzando il servizio Identity Namespace. Fai riferimento a Documentazione di Adobe Experience Platform.

Se selezioni uno schema con un’identità primaria, il Identificatore profiler e Namespace i campi sono precompilati. Se non è stata definita alcuna identità, selezioniamo identityMap > id come chiave primaria. Quindi devi selezionare uno spazio dei nomi e la chiave verrà precompilata (sotto il Namespace field) utilizzando identityMap > id.

Quando selezioni i campi, vengono taggati i campi di identità primari.

Seleziona uno spazio dei nomi dall’elenco a discesa.

È consentito un solo spazio dei nomi per percorso. Se utilizzi più eventi nello stesso percorso, è necessario che utilizzino lo stesso namespace. Consulta questa pagina.

NOTA

È possibile selezionare solo uno spazio dei nomi delle identità basato su persone. Se hai definito uno spazio dei nomi per una tabella di ricerca (ad esempio: Spazio dei nomi ProductID per una ricerca di prodotto), questo non sarà disponibile nella Namespace elenco a discesa.

Definire l’identificatore del profilo

La chiave è il campo, o la combinazione di campi, che fa parte dei dati di payload dell’evento e che consente al sistema di identificare la persona associata all’evento. La chiave può essere, ad esempio, l’ID Experience Cloud, un ID del sistema di gestione delle relazioni con i clienti o un indirizzo e-mail.

Per utilizzare i dati memorizzati nel database Real-time Customer Profile di Adobe, la chiave dell’evento deve essere costituita dalle informazioni definite come identità di un profilo nel Servizio Profilo cliente in tempo reale.

L’identificatore di profilo consente al sistema di eseguire la riconciliazione tra l’evento e il profilo dell’individuo. Se selezioni uno schema con un’identità primaria, il Identificatore profilo e Namespace i campi sono precompilati. Se non è stata definita alcuna identità, il identityMap > id è la chiave primaria. Quindi devi selezionare uno spazio dei nomi e la chiave viene automaticamente precompilata utilizzando identityMap > id.

Quando selezioni i campi, vengono taggati i campi di identità primari.

Se devi utilizzare una chiave diversa, ad esempio un ID CRM o un indirizzo e-mail, devi aggiungerla manualmente, come spiegato di seguito:

  1. Fai clic all’interno del Identificatore profilo o sull'icona della matita.

  2. Seleziona il campo scelto come chiave nell’elenco dei campi del payload. Puoi anche passare all’editor di espressioni avanzate per creare chiavi più complesse (ad esempio, una concatenazione di due campi degli eventi).

Quando l’evento viene ricevuto, il valore della chiave consente al sistema di identificare la persona associata all’evento. Associato a uno spazio dei nomi (vedere questa sezione), la chiave può essere utilizzata per eseguire query su Adobe Experience Platform. Consulta questa pagina.
La chiave viene utilizzata anche per verificare che una persona appartenga a un percorso. Infatti, una persona non può trovarsi in due luoghi diversi nello stesso percorso. Di conseguenza, il sistema non consente che la stessa chiave, ad esempio la chiave CRMID=3224, si trovi in luoghi diversi nello stesso percorso.

È inoltre possibile accedere alle funzioni di espressione avanzate (Modalità avanzata) se desideri eseguire ulteriori manipolazioni. Queste funzioni ti consentono di manipolare i valori utilizzati per eseguire query specifiche, ad esempio per modificare i formati e eseguire concatenazioni di campi, tenendo conto solo di una parte di un campo (ad esempio i primi 10 caratteri). Consulta questa pagina.

Anteprima del payload

L’anteprima del payload consente di convalidare la definizione del payload.

NOTA

Per gli eventi generati dal sistema, quando crei un evento, prima di visualizzare l’anteprima del payload, salva l’evento e riaprilo. Questo passaggio è necessario per generare un ID evento nel payload.

  1. Fai clic su Visualizza payload per visualizzare in anteprima il payload previsto dal sistema.

    È possibile notare che vengono visualizzati i campi selezionati.

  2. Controlla l’anteprima per convalidare la definizione del payload.

  3. Quindi, puoi condividere l’anteprima del payload con alla persona responsabile dell’invio dell’evento. Questo payload può aiutarli a progettare la configurazione di un evento che invia a Journey Optimizer. Consulta questa pagina.

In questa pagina