Definire una relazione uno-a-uno tra due schemi utilizzando l’Schema Editor relationship-ui

La capacità di comprendere le relazioni tra i clienti e le loro interazioni con il brand attraverso vari canali è una parte importante di Adobe Experience Platform. Definizione di queste relazioni all'interno della struttura Experience Data Model Gli schemi (XDM) consentono di ottenere informazioni complesse sui dati dei clienti.

Anche se le relazioni tra schemi possono essere dedotte tramite l’utilizzo dello schema di unione e Real-Time Customer Profile, applicabile solo agli schemi che condividono la stessa classe. Per stabilire una relazione tra due schemi appartenenti a classi diverse, è necessario aggiungere a uno schema di origine un campo relazione dedicato che faccia riferimento all’identità dell’altro schema correlato.

NOTE
Se gli schemi di origine e di destinazione appartengono entrambi alla stessa classe, un campo relazione dedicato deve non essere utilizzati. In questo caso, utilizza l’interfaccia utente dello schema di unione per visualizzare la relazione. Le istruzioni per eseguire questa operazione sono reperibili nella sezione visualizza relazioni sezione della guida dell’interfaccia utente dello schema di unione.

Questo documento fornisce un tutorial per definire una relazione tra due schemi utilizzando l’Editor di schema nel Experience Platform dell'utente. Per informazioni sulla definizione delle relazioni tra schemi tramite l’API, consulta l’esercitazione su definizione di una relazione tramite l’API Schema Registry.

NOTE
Per i passaggi su come creare una relazione molti-a-uno in Adobe Real-time Customer Data Platform B2B Edition, consulta la guida su creazione di relazioni B2B.

Introduzione

Questo tutorial richiede una buona conoscenza di XDM System e l’Editor di schema nel Experience Platform UI. Prima di iniziare questo tutorial, consulta la seguente documentazione:

Definire uno schema di origine e di riferimento

È previsto che tu abbia già creato i due schemi che verranno definiti nella relazione. A scopo dimostrativo, questa esercitazione crea una relazione tra i membri del programma fedeltà di un’organizzazione (definito in un’ "Loyalty Members") e il loro hotel preferito (definito in una "Hotels").

IMPORTANT
Per stabilire una relazione, entrambi gli schemi devono avere identità primarie definite ed essere abilitati per Real-Time Customer Profile. Consulta la sezione su abilitazione di uno schema da utilizzare nel profilo nell’esercitazione sulla creazione di schemi se hai bisogno di istruzioni su come configurare di conseguenza gli schemi.

Le relazioni tra schemi sono rappresentate da un campo dedicato all’interno di un schema di origine che punta a un altro campo all’interno di un schema di riferimento. Nei passaggi successivi, "Loyalty Members" sarà lo schema di origine, mentre "Hotels" fungerà da schema di riferimento.

Le sezioni seguenti descrivono la struttura di ogni schema utilizzato in questa esercitazione prima della definizione di una relazione.

Loyalty Members schema

Lo schema di origine "Loyalty Members" si basa sul XDM Individual Profile classe, contenente un campo che descrive i membri di un programma fedeltà. Uno di questi campi, personalEmail.addess, funge da identità primaria per lo schema nella sezione E-mail spazio dei nomi. Come mostrato nella Proprietà schema, questo schema è stato abilitato per l’utilizzo in Real-Time Customer Profile.

Hotels schema

Lo schema di riferimento "Hotels" si basa su un personalizzato "Hotels" e contiene campi che descrivono un hotel. Per poter partecipare a una relazione, lo schema di riferimento deve anche avere un’identità primaria definita ed essere abilitato per Profilo. In questo caso, _tenantId.hotelIdfunge da identità primaria per lo schema, utilizzando un tag personalizzato "Hotel ID" spazio dei nomi delle identità.

Abilita per profilo

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

Creare un gruppo di campi relazione

NOTE
Questo passaggio è necessario solo se lo schema di origine non dispone di un campo di tipo stringa dedicato da utilizzare come puntatore all’identità primaria dello schema di riferimento. Se questo campo è già definito nello schema di origine, passa al passaggio successivo di definizione di un campo relazione.

Per definire una relazione tra due schemi, lo schema di origine deve disporre di un campo dedicato che indicherà l’identità primaria dello schema di riferimento. È possibile aggiungere questo campo allo schema di origine creando un nuovo gruppo di campi schema o estendendone uno esistente.

Nel caso di Loyalty Members schema, un nuovo preferredHotel verrà aggiunto il campo per indicare l’hotel preferito dal membro fedeltà per le visite aziendali. Per iniziare, seleziona l’icona più (+) accanto al nome dello schema di origine.

Nell’area di lavoro viene visualizzato un nuovo segnaposto di campo. Sotto Proprietà campo, fornire un nome di campo e un nome visualizzato per il campo e impostarne il tipo su "Stringa". Sotto Assegna a, selezionare un gruppo di campi esistente da estendere o digitare un nome univoco per creare un nuovo gruppo di campi. In questo caso, un nuovo "Preferred Hotel"viene creato un gruppo di campi.

Al termine, seleziona Applica.

Il valore aggiornato preferredHotel viene visualizzato nell’area di lavoro, sotto a _tenantId poiché è un campo personalizzato. Seleziona Salva per finalizzare le modifiche apportate allo schema.

Definire un campo relazione per lo schema di origine relationship-field

Una volta definito un campo di riferimento dedicato per lo schema di origine, puoi designarlo come campo di relazione.

NOTE
I passaggi seguenti descrivono come definire un campo di relazione utilizzando i controlli nella barra a destra nell’area di lavoro. Se hai accesso a Real-Time CDP B2B Edition, puoi anche definire una relazione uno-a-uno utilizzando stessa finestra come quando si creano relazioni molti-a-uno.

Seleziona la preferredHotel nell’area di lavoro, quindi scorri verso il basso in Proprietà campo fino al Relazione viene visualizzata la casella di controllo. Selezionare la casella di controllo per visualizzare i parametri richiesti per la configurazione di un campo relazione.

Seleziona il menu a discesa per Schema di riferimento e seleziona lo schema di riferimento per la relazione ("Hotels" in questo esempio). Sotto Spazio dei nomi dell’identità di riferimento, seleziona lo spazio dei nomi del campo di identità dello schema di riferimento (in questo caso, "Hotel ID"). Seleziona Applica al termine.

Il preferredHotel viene ora evidenziato come relazione nell’area di lavoro, con il nome dello schema di riferimento. 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 Schema Editor. Per i passaggi su come definire le relazioni utilizzando l’API, consulta l’esercitazione su definizione di una relazione tramite l’API Schema Registry.

recommendation-more-help
62e9ffd9-1c74-4cef-8f47-0d00af32fc07