Mappare le identità

Ultimo aggiornamento: 5 maggio 2025
  • Argomenti:

Creato per:

  • Principiante
  • Intermedio
  • Sviluppatore

In questa lezione, creeremo spazi dei nomi di identità e aggiungeremo campi di identità ai nostri schemi. In seguito, saremo anche in grado di completare le relazioni tra schemi della lezione precedente.

Il servizio Adobe Experience Platform Identity consente di ottenere una visione migliore dei clienti e dei loro comportamenti collegando le identità tra dispositivi e sistemi, consentendo di offrire esperienze digitali personali e di impatto in tempo reale. I campi di identità e gli spazi dei nomi sono l’associazione che unisce diverse origini di dati per creare il profilo cliente in tempo reale a 360 gradi.

Gli architetti di dati dovranno mappare le identità all'esterno di questa esercitazione.

Prima di iniziare gli esercizi, guarda questo breve video per ulteriori informazioni sull’identità in Adobe Experience Platform:

NOTA
I campi di identità sono necessari solo se si creano profili cliente in tempo reale. Non sono necessarie se si acquisiscono solo dati nel data lake.

Autorizzazioni richieste

Nella lezione Configurare le autorizzazioni è possibile impostare tutti i controlli di accesso necessari per completare la lezione.

Crea spazio dei nomi identità

In questo esercizio creeremo spazi dei nomi di identità per i campi di identità personalizzati di Luma, loyaltyId, crmId e productSku. Gli spazi dei nomi delle identità svolgono un ruolo fondamentale nella creazione di profili cliente in tempo reale, in quanto due valori corrispondenti nello stesso spazio dei nomi consentono a due origini di dati di formare un grafo identità.

Creare spazi dei nomi nell’interfaccia utente

Iniziamo creando uno spazio dei nomi per lo schema Fedeltà Luma:

  1. Nell'interfaccia utente di Platform, vai a Identità nell'area di navigazione a sinistra

  2. Sono disponibili diversi spazi dei nomi di identità predefiniti. Seleziona il pulsante Crea spazio dei nomi identità

  3. Fornisci i dettagli come segue

    CampoValore
    Nome visualizzatoID fedeltà Luma
    Simbolo di identitàlumaLoyaltyId
    TipoCross-Device

  4. Seleziona Crea

    Creare spazi dei nomi

Ora imposta un altro spazio dei nomi per lo schema del catalogo prodotti Luma con i seguenti dettagli:

CampoValore
Nome visualizzatoSKU prodotto Luma
Simbolo di identitàlumaProductSKU
TipoIdentificatore non di persone

Creare lo spazio dei nomi dell’identità tramite API

Creeremo il nostro spazio dei nomi CRM tramite API.

NOTA
Se preferisci saltare gli esercizi API, puoi creare lo spazio dei nomi CRM tramite il metodo di interfaccia utente utilizzato con i seguenti dettagli:
  1. Come Nome visualizzato, utilizza Luma CRM Id
  2. Come simbolo di identità, utilizza lumaCrmId
  3. Come Tipo, utilizza Cross-Device

Creiamo lo spazio dei nomi dell'identità Luma CRM Id:

  1. Scarica Identity Service.postman_collection.json nella cartella Luma Tutorial Assets

  2. Importa la raccolta in Postman

  3. Se non disponi di un token di accesso, apri la richiesta OAuth: Request Access Token e seleziona Invia per richiedere un nuovo token di accesso.

  4. Seleziona la richiesta Identity Service > Identity Namespace > Crea un nuovo spazio dei nomi delle identità.

  5. Incolla quanto segue come Body della richiesta:

    {
    "name": "Luma CRM Id",
    "code": "lumaCrmId",
    "idType": "Cross_device"
}

  6. Premi il pulsante Invia e dovresti ricevere una risposta di 200 OK:

    Spazio dei nomi identità

Se torni all’interfaccia utente, ora dovresti visualizzare i tre nuovi spazi dei nomi personalizzati:
Spazio dei nomi identità

Etichettare i campi di identità negli schemi

Ora che disponiamo dei nostri namespace, il passaggio successivo è aggiornare gli schemi per etichettare i campi di identità.

Etichettare i campi XDM per l’identità primaria

Ogni schema utilizzato con Real-Time Customer Profile deve disporre di un’identità primaria specificata. E ogni record acquisito deve avere un valore per quel campo.

Aggiungiamo un'identità primaria a Luma Loyalty Schema:

  1. Apri Luma Loyalty Schema

  2. Seleziona Luma Identity profile field group

  3. Seleziona il campo loyaltyId

  4. Seleziona la casella Identità

  5. Seleziona anche la casella Identità primaria

  6. Seleziona lo spazio dei nomi Luma Loyalty Id dal menu a discesa Spazi dei nomi identità

  7. Seleziona Applica

  8. Seleziona Salva

    Identità primaria

Ripeti il processo per alcuni degli altri schemi:

  1. In Luma CRM Schema, etichettare il campo crmId come identità primaria utilizzando lo spazio dei nomi Luma CRM Id
  2. In Luma Offline Purchase Events Schema, etichettare il campo loyaltyId come identità primaria utilizzando lo spazio dei nomi Luma Loyalty Id
  3. In Luma Product Catalog Schema, etichettare il campo productSku come identità primaria utilizzando lo spazio dei nomi Luma Product SKU
NOTA
I dati raccolti con il Web SDK sono un’eccezione alla pratica tipica di etichettare i campi di identità nello schema. Web SDK utilizza Identity Map per etichettare le identità sul lato dell'implementazione. Pertanto, determineremo le identità per Luma Web Events Schema quando implementeremo Web SDK sul sito Web Luma. In questa lezione successiva, raccoglieremo l’ID visitatore di Experience Cloud (ECID) come ID primario e il crmId come ID secondario.

Con la selezione delle identità primarie da parte nostra, è chiaro come Luma Loyalty Schema può connettersi a Luma Offline Purchase Events Schema poiché entrambi utilizzano loyaltyId come identificatore. Ma come può il CRM connettersi agli eventi di acquisto offline? Come possiamo collegare i nostri acquisti offline al comportamento online? E come possiamo classificare i prodotti acquistati con il nostro catalogo di prodotti? Utilizzeremo campi di identità e relazioni di schema aggiuntivi.

Etichettare i campi XDM per l’identità secondaria

È possibile aggiungere più campi di identità a uno schema. Le identità non primarie sono spesso indicate come identità secondarie. Per collegare gli acquisti offline al comportamento online, aggiungeremo il crmId come identificatore secondario a Luma Loyalty Schema e successivamente nei dati degli eventi Web. Aggiorniamo Luma Loyalty Schema:

  1. Apri Luma Loyalty Schema

  2. Seleziona Luma Identity Profile Field group

  3. Seleziona campo crmId

  4. Seleziona la casella Identità

  5. Seleziona lo spazio dei nomi Luma CRM Id dal menu a discesa Spazi dei nomi identità

  6. Seleziona Applica, quindi seleziona il pulsante Salva per salvare le modifiche

    Identità secondaria

Completa le relazioni tra schemi

Ora che abbiamo i campi di identità etichettati, possiamo completare la configurazione delle relazioni di schema tra il catalogo dei prodotti Luma e gli schemi dell’evento:

  1. Apri Luma Offline Purchase Events Schema

  2. Seleziona gruppo di campi Dettagli Commerce

  3. Seleziona il campo productListItems > SKU

  4. Seleziona la casella Relazione

  5. Seleziona Luma Product Catalog Schema come Schema di riferimento

  6. Luma Product SKU deve essere compilato automaticamente come Spazio dei nomi identità di riferimento

  7. Seleziona Applica

  8. Seleziona Salva

    Campo di riferimento

Ripetere questo processo per creare una relazione tra Luma Web Events Schema e Luma Product Catalog Schema.

Dopo aver definito la relazione, questa viene indicata sia nella sezione Composizione che nella sezione Struttura dell'editor schema.

Visualizzazione relazioni nelleditor schema

Risorse aggiuntive

Ora che le nostre identità sono attive, possiamo creare i nostri set di dati.

Pagina precedente4. Dati modello negli schemi
Pagina successiva6. Creare i set di dati

Experience Platform