Definire una relazione tra due schemi utilizzando Schema Editor

NOTA

Se utilizzi Real-time Customer Data Platform B2B Edition, consulta la guida sulla creazione di relazioni B2B .

La capacità di comprendere le relazioni tra i clienti e le loro interazioni con il tuo marchio attraverso vari canali è una parte importante di Adobe Experience Platform. La definizione di queste relazioni all’interno della struttura degli schemi Experience Data Model (XDM) consente di ottenere informazioni complesse sui dati dei clienti.

Mentre le relazioni dello schema possono essere dedotte mediante l'uso dello schema di unione e di Real-time Customer Profile, questo vale solo per gli schemi che condividono la stessa classe. Per stabilire una relazione tra due schemi appartenenti a classi diverse, è necessario aggiungere un campo di relazione dedicato a uno schema di origine che fa riferimento all'identità di uno schema di destinazione.

Questo documento fornisce un'esercitazione per definire una relazione tra due schemi che utilizzano l'Editor di schema nell'interfaccia utente Experience Platform. Per i passaggi sulla definizione delle relazioni tra schemi utilizzando l'API, consulta l'esercitazione su definizione di una relazione utilizzando l'API del Registro di sistema dello schema.

Introduzione

Questa esercitazione richiede una buona comprensione di XDM System e dell’Editor di schema nell’ interfaccia utente di Experience Platform . Prima di iniziare questa esercitazione, consulta la seguente documentazione:

Definire uno schema di origine e di destinazione

È previsto che siano già stati creati i due schemi che verranno definiti nella relazione. A scopo dimostrativo, questo tutorial crea una relazione tra i membri del programma fedeltà di un'organizzazione (definito in uno schema "Loyalty Members") e il loro hotel preferito (definito in uno schema "Hotels").

IMPORTANTE

Per stabilire una relazione, entrambi gli schemi devono avere identità principali definite ed essere abilitati per Real-time Customer Profile. Per informazioni su come configurare di conseguenza gli schemi, consulta la sezione relativa all’ abilitazione di uno schema da utilizzare in Profile nell’esercitazione sulla creazione dello schema.

Le relazioni dello schema sono rappresentate da un campo dedicato all'interno di uno schema di origine che fa riferimento a un altro campo all'interno di uno schema di destinazione. Nei passaggi seguenti, "Loyalty Members" sarà lo schema di origine, mentre "Hotels" fungerà da schema di destinazione.

A scopo di riferimento, le sezioni seguenti descrivono la struttura di ogni schema utilizzato in questa esercitazione prima che sia stata definita una relazione.

Loyalty Members schema

Lo schema di origine "Loyalty Members" è basato sulla classe XDM Individual Profile ed è lo schema creato nell'esercitazione per la creazione di uno schema nell'interfaccia utente. Include un oggetto loyalty nello spazio dei nomi _tenantId, che include diversi campi specifici per la fidelizzazione. Uno di questi campi, loyaltyId, funge da identità principale per lo schema nello spazio dei nomi Email . Come mostrato in Proprietà schema, questo schema è stato abilitato per l'utilizzo in Real-time Customer Profile.

Hotels schema

Lo schema di destinazione "Hotels" è basato su una classe "Hotels" personalizzata e contiene campi che descrivono un hotel.

Per poter partecipare a una relazione, lo schema di destinazione deve avere un'identità primaria. In questo esempio, il campo hotelId viene utilizzato come identità principale, utilizzando uno spazio dei nomi di identità "ID hotel" personalizzato.

Identità principale dell'hotel

NOTA

Per informazioni su come creare spazi dei nomi di identità personalizzati, consulta la documentazione del servizio Identity.

Una volta impostata l'identità principale, lo schema di destinazione deve essere abilitato per Real-time Customer Profile.

Abilita per profilo

Creare un gruppo di campi schema di relazione

NOTA

Questo passaggio è necessario solo se lo schema di origine non dispone di un campo di tipo stringa dedicato da utilizzare come riferimento allo schema di destinazione. Se questo campo è già definito nello schema di origine, passa al passaggio successivo di definizione di un campo di relazione.

Per definire una relazione tra due schemi, lo schema di origine deve disporre di un campo dedicato da utilizzare come riferimento allo schema di destinazione. È possibile aggiungere questo campo allo schema di origine creando un nuovo gruppo di campi dello schema.

Inizia selezionando Aggiungi nella sezione Gruppi di campi .

Viene visualizzata la finestra di dialogo Aggiungi gruppo di campi . Da qui, seleziona Crea nuovo gruppo di campi. Nei campi di testo visualizzati, immettere un nome visualizzato e una descrizione per il nuovo gruppo di campi. Al termine, seleziona Aggiungi gruppi di campi.

L'area di lavoro viene visualizzata nuovamente con "Favorite Hotel" nella sezione Gruppi di campi. Seleziona il nome del gruppo di campi, quindi seleziona Aggiungi campo accanto al campo a livello principale Loyalty Members.

Un nuovo campo viene visualizzato nell’area di lavoro sotto lo spazio dei nomi _tenantId . In Proprietà campo, fornisci un nome di campo e un nome visualizzato per il campo e imposta il relativo tipo su "String".

Al termine, selezionare Applica.

Il campo aggiornato favoriteHotel viene visualizzato nell’area di lavoro. Seleziona Salva per finalizzare le modifiche allo schema.

Definire un campo di relazione per lo schema di origine

Una volta definito il campo di riferimento dedicato dello schema di origine, è possibile assegnarlo come campo di relazione.

Seleziona il campo favoriteHotel nell'area di lavoro, quindi scorri verso il basso sotto Proprietà campo finché non viene visualizzata la casella di controllo Relazione . Selezionare la casella di controllo per visualizzare i parametri richiesti per la configurazione di un campo di relazione.

Seleziona il menu a discesa per Schema di riferimento e seleziona lo schema di destinazione per la relazione ("Hotels" in questo esempio). Se lo schema di destinazione è abilitato per Profile, il campo Riferimento identity namespace viene impostato automaticamente sullo spazio dei nomi dell'identità primaria dello schema di destinazione. Se nello schema non è definita un'identità primaria, è necessario selezionare manualmente lo spazio dei nomi che si intende utilizzare dal menu a discesa. Selezionare Applica al termine.

Il campo favoriteHotel viene ora evidenziato come una relazione nell’area di lavoro, mostrando il nome e lo spazio dei nomi dell’identità di riferimento dello schema di destinazione. Seleziona Salva per salvare le modifiche e completare il flusso di lavoro.

Passaggi successivi

Seguendo questa esercitazione, hai creato correttamente una relazione uno-a-uno tra due schemi utilizzando il tag Schema Editor. Per i passaggi su come definire le relazioni utilizzando l’API, consulta l’esercitazione su definizione di una relazione utilizzando l’API del Registro di sistema dello schema.

In questa pagina