Configurare un evento unitario configure-an-event
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:
-
Nella sezione del menu AMMINISTRAZIONE, passa a Configurazioni e nella sezione Eventi fai clic su Gestisci. Viene visualizzato l’elenco degli eventi.
-
Fai clic su Crea evento per creare un nuovo evento. Il riquadro di configurazione dell’evento si apre sul lato destro dello schermo.
-
Inserisci il nome dell’evento. Puoi anche aggiungere una descrizione.
note note NOTE Sono consentiti solo caratteri alfanumerici e trattini bassi. La lunghezza massima è di 30 caratteri. -
Nel campo Tipo scegliere Unitario.
-
Nel campo Tipo ID evento, selezionare il tipo di ID evento che si desidera utilizzare: Basato su regole o Generato dal sistema. Ulteriori informazioni sui tipi di ID evento in questa sezione.
-
Il numero di percorsi che utilizzano questo evento viene visualizzato nel campo Usato in. È possibile fare clic sull'icona Visualizza percorsi per visualizzare l'elenco dei percorsi che utilizzano questo evento.
-
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.
note note NOTE Quando selezioni il tipo Generato dal sistema, sono disponibili solo gli schemi che hanno il campo del tipo eventID. Quando selezioni il tipo Basato su regole, sono disponibili tutti gli schemi Experience Event. -
Per gli eventi basati su regole, fai clic nel campo Event ID condition. Utilizzando l’editor di espressioni semplice o avanzato, 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 (campo Città e valore Parigi), lo trasmetterà ai percorsi.
note note NOTE 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. -
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.
-
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.
-
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 define-the-payload-fields
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 la documentazione di Adobe Experience Platform.
-
Seleziona uno schema XDM dall'elenco e fai clic sul campo Campi o sull'icona Modifica.
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.
note note NOTE 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 l'utilizzo di Journey Optimizer. 
-
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 (vedere questa sezione).
note note NOTE Per gli eventi generati dal sistema, il campo eventID viene aggiunto automaticamente nell'elenco dei campi selezionati in modo che Journey Optimizer possa 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. -
Dopo aver selezionato i campi necessari, fare clic su Ok o premere Invio.
Il numero di campi selezionati viene visualizzato nel campo Campi.
Selezionare lo spazio dei nomi select-the-namespace
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 dal 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. Consulta la documentazione di Adobe Experience Platform.
Se si seleziona uno schema con un'identità primaria, i campi Identificatore profiler e Spazio dei nomi sono precompilati. Se non è stata definita alcuna identità, verrà selezionata identityMap > id come chiave primaria. Quindi devi selezionare uno spazio dei nomi e la chiave verrà precompilata (sotto il campo Spazio dei nomi) 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.
Definire l’identificatore del profilo define-the-event-key
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 Adobe Real-time Customer Profile, la chiave evento deve essere costituita dalle informazioni definite come identità di un profilo nel Real-time Customer Profile Service.
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, i campi Identificatore profilo e Spazio dei nomi sono precompilati. Se non è stata definita alcuna identità, 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:
-
Fai clic nel campo Identificatore profilo o sull'icona della matita.
-
Seleziona il campo scelto come chiave nell’elenco dei campi del payload.
Quando l’evento viene ricevuto, il valore della chiave consente al sistema di identificare la persona associata all’evento. Associata a uno spazio dei nomi (vedi questa sezione), la chiave può essere utilizzata per eseguire query in Adobe Experience Platform. Vedi 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.
Editor di espressioni avanzate adv-exp-editor
Quando definisci la condizione ID evento o l’identificatore Profilo, puoi passare all’editor di espressioni avanzate per creare chiavi più complesse (ad esempio, una concatenazione di due campi degli eventi).
Puoi accedere alle funzioni di espressione avanzata dal pulsante 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 preview-the-payload
L’anteprima del payload consente di convalidare la definizione del payload.
-
Fai clic sull'icona Visualizza payload per visualizzare in anteprima il payload previsto dal sistema.
È possibile notare che vengono visualizzati i campi selezionati.
-
Controlla l’anteprima per convalidare la definizione del payload.
-
Quindi, puoi condividere l’anteprima del payload con alla persona responsabile dell’invio dell’evento. Questo payload può essere utile per progettare la configurazione di un evento che viene inviato a Journey Optimizer. Consulta questa pagina.