Guida all'implementazione per Identity Graph Linking Rules

IMPORTANT
In questo documento si presuppone che stai avviando l’implementazione in una nuova sandbox senza alcun dato.

Leggi questo documento per una guida dettagliata che puoi seguire durante l’implementazione dei dati con il servizio Adobe Experience Platform Identity.

Descrizione dettagliata:

Prerequisiti per l’implementazione prerequisites-for-implementation

In questa sezione vengono descritti i passaggi preliminari che è necessario completare prima di implementare Identity Graph Linking Rules nei dati.

Spazio dei nomi univoco

Requisito dello spazio dei nomi per singola persona single-person-namespace-requirement

Assicurati che lo spazio dei nomi univoco con la priorità più elevata sia sempre presente in ogni profilo noto. In questo modo il servizio Identity è in grado di rilevare l’identificatore di persona appropriato in un dato grafico.

Seleziona questa opzione per visualizzare un esempio di grafico senza uno spazio dei nomi con un singolo identificatore di persona

Se non disponi di uno spazio dei nomi univoco per rappresentare gli identificatori delle persone, potresti ottenere un grafico che collega più identificatori delle persone allo stesso ECID. In questo esempio, sia B2BCRM che B2CCRM sono collegati allo stesso ECID allo stesso tempo. Questo grafico suggerisce che Tom, usando il suo account di accesso B2C, ha condiviso un dispositivo con Summer, usando il suo account di accesso B2B. Tuttavia, il sistema riconoscerà che si tratta di un profilo (compressione del grafico).

Uno scenario grafico in cui due identificatori di persona sono collegati allo stesso ECID. {modal="regular"}

Seleziona per visualizzare un esempio di grafico con uno spazio dei nomi con identificatore di persona singolo

Dato uno spazio dei nomi univoco, (in questo caso un CRMID invece di due spazi dei nomi diversi), Identity Service è in grado di distinguere l’identificatore della persona più recente associato all’ECID. In questo esempio, poiché esiste un CRMID univoco, Identity Service è in grado di riconoscere uno scenario di "dispositivo condiviso", in cui due entità condividono lo stesso dispositivo.

Uno scenario di grafico dei dispositivi condiviso, in cui due identificatori di persona sono collegati allo stesso ECID, ma il collegamento precedente viene rimosso. {modal="regular"}

Configurazione della priorità dello spazio dei nomi

Se utilizzi il connettore di origine Adobe Analytics per acquisire i dati, devi assegnare agli ECID una priorità maggiore rispetto ad Adobe Analytics ID (AAID) perché Identity Service blocca AAID. Dando priorità a ECID, puoi dare istruzioni a Real-Time Customer Profile di memorizzare gli eventi non autenticati in ECID invece che in AAID.

Eventi esperienza XDM xdm-experience-events

Durante il processo di pre-implementazione, devi assicurarti che gli eventi autenticati che il tuo sistema invierà ad Experience Platform contengano sempre un unico identificatore di persona, ad esempio un CRMID.

  • (Consigliato) Eventi autenticati con un identificatore persona univoco.
  • (Non consigliato) Eventi autenticati con due identificatori di persona univoci. Se disponi di più di un identificatore persona univoco, potresti riscontrare una compressione indesiderata del grafico.
  • (Sconsigliato) Eventi autenticati senza identificatori di persona univoci. Se non disponi di identificatori di persona univoci, verranno memorizzati sia gli eventi non autenticati che quelli autenticati in base all’ECID.
Eventi autenticati con un identificatore persona
code language-json
{
  "_id": "test_id",
  "identityMap": {
      "ECID": [
          {
              "id": "62486695051193343923965772747993477018",
              "primary": false
          }
      ],
      "CRMID": [
          {
              "id": "John",
              "primary": true
          }
      ]
  },
  "timestamp": "2024-09-24T15:02:32+00:00",
  "web": {
      "webPageDetails": {
          "URL": "https://business.adobe.com/",
          "name": "Adobe Business"
      }
  }
}
Eventi autenticati con due identificatori di persona

Se il sistema invia due identificatori di persona, l’implementazione potrebbe non soddisfare il requisito relativo allo spazio dei nomi per singola persona. Ad esempio, se identityMap nell’implementazione di webSDK contiene un CRMID, un customerID e uno spazio dei nomi ECID, non c’è garanzia che ogni singolo evento contenga sia CRMID che customerID.

non deve inviare un payload come segue:

code language-json
{
  "_id": "test_id",
  "identityMap": {
      "ECID": [
          {
              "id": "62486695051193343923965772747993477018",
              "primary": false
          }
      ],
      "CRMID": [
          {
              "id": "John",
              "primary": true
          }
      ],
      "customerID": [
          {
            "id": "Jane",
            "primary": false
          }
      ],
  },
  "timestamp": "2024-09-24T15:02:32+00:00",
  "web": {
      "webPageDetails": {
          "URL": "https://business.adobe.com/",
          "name": "Adobe Business"
      }
  }
}

Tuttavia, è importante notare che, anche se è possibile inviare due identificatori di persona, non c’è alcuna garanzia che una compressione indesiderata del grafico sia impedita a causa di errori di implementazione o di dati. Considera lo scenario seguente:

  • timestamp1 = John effettua l'accesso -> il sistema acquisisce CRMID: John, ECID: 111. Tuttavia, customerID: John non è presente in questo payload dell'evento.
  • timestamp2 = accesso di Jane -> il sistema acquisisce customerID: Jane, ECID: 111. Tuttavia, CRMID: Jane non è presente in questo payload dell'evento.

Pertanto, è consigliabile inviare solo un identificatore di persona con i tuoi eventi autenticati.

Nella simulazione del grafico, questa acquisizione potrebbe avere un aspetto simile a:

L'interfaccia utente di simulazione del grafico con un grafico di esempio di cui è stato eseguito il rendering. {modal="regular"}

Eventi autenticati senza identificatori di persona

In questo esempio, puoi presumere che il seguente evento sia stato inviato ad Experience Platform mentre John (l’utente finale) stava navigando nel tuo sito web mentre era autenticato. Tuttavia, nonostante l’autenticazione, Experience Platform non è in grado di identificare John a causa della mancanza di identificatori di persona nell’evento. Pertanto, questo evento viene interpretato come un utente anonimo che naviga nel sito web Adobe Business, invece di riconoscerlo come un’attività online associata specificamente a John.

code language-json
{
    "_id": "test_id",
    "identityMap": {
        "ECID": [
            {
                "id": "62486695051193343923965772747993477018",
                "primary": false
            }
        ]
    },
    "timestamp": "2024-09-24T15:02:32+00:00",
    "web": {
        "webPageDetails": {
            "URL": "https://business.adobe.com/",
            "name": "Adobe Business"
        }
    }
}

Impostare le autorizzazioni set-permissions

Il primo passaggio nel processo di implementazione del servizio Identity consiste nell’assicurarsi che l’account Experience Platform venga aggiunto a un ruolo provvisto delle autorizzazioni necessarie. L’amministratore può configurare le autorizzazioni per il tuo account passando all’interfaccia utente Autorizzazioni in Adobe Experience Cloud. A questo punto, è necessario aggiungere il tuo account a un ruolo con le seguenti autorizzazioni:

  • Visualizza impostazioni identità: applica questa autorizzazione per poter visualizzare spazi dei nomi e priorità dello spazio dei nomi univoci nella pagina di esplorazione dello spazio dei nomi delle identità.
  • Modifica impostazioni identità: applica questa autorizzazione per poter modificare e salvare le impostazioni di identità.

Per ulteriori informazioni sulle autorizzazioni, leggere la guida alle autorizzazioni.

Creare gli spazi dei nomi delle identità namespace

Se i dati lo richiedono, devi innanzitutto creare gli spazi dei nomi appropriati per la tua organizzazione. Per i passaggi su come creare uno spazio dei nomi personalizzato, leggere la guida in creazione di uno spazio dei nomi personalizzato nell'interfaccia utente.

Usa strumento di simulazione grafico graph-simulation

Quindi, passa allo strumento di simulazione del grafico 🔗 nell'area di lavoro dell'interfaccia utente di Identity Service. Puoi utilizzare lo strumento di simulazione del grafico per simulare grafici di identità, creati con diverse configurazioni di spazio dei nomi e priorità dello spazio dei nomi univoche.

Creando diverse configurazioni, puoi utilizzare lo strumento di simulazione del grafico per scoprire e comprendere meglio in che modo l’algoritmo di ottimizzazione delle identità e alcune configurazioni possono influenzare il comportamento del grafico.

Configurare le impostazioni di identità identity-settings

Per avere un'idea migliore del comportamento del grafico, passa alla interfaccia utente delle impostazioni delle identità nell'area di lavoro dell'interfaccia utente di Identity Service. Per accedere all'interfaccia utente delle impostazioni delle identità, seleziona Identità nell'area di navigazione a sinistra, quindi seleziona Impostazioni.

La pagina di esplorazione delle identità con il pulsante Impostazioni evidenziato. {modal="regular"}

Utilizza l’interfaccia utente delle impostazioni di identità per designare gli spazi dei nomi univoci e configurare gli spazi dei nomi in ordine di priorità.

IMPORTANT
Una volta completata l’applicazione delle impostazioni, attendi almeno 24 ore prima di poter procedere all’acquisizione dei dati, poiché sono necessarie almeno 24 ore affinché le nuove impostazioni vengano applicate al servizio Identity.

Per ulteriori informazioni, leggere la guida dell'interfaccia utente per le impostazioni delle identità.

Creare uno schema XDM schema

Una volta stabiliti gli spazi dei nomi univoci e le priorità dello spazio dei nomi, puoi procedere con la configurazione necessaria per acquisire i dati. Innanzitutto, devi creare uno schema XDM. A seconda dei dati, potrebbe essere necessario creare uno schema sia per XDM Individual Profile che per XDM ExperienceEvent.

Per acquisire dati in Real-Time Customer Profile, devi assicurarti che lo schema contenga almeno un campo designato come identità primaria. Impostando un’identità primaria, puoi abilitare uno schema specifico per l’acquisizione del profilo.

Per istruzioni su come creare uno schema, consulta la guida su creazione di uno schema XDM nell'interfaccia utente.

Creare un set di dati dataset

Quindi, crea un set di dati per fornire una struttura per i dati che intendi acquisire. Un set di dati è un costrutto di archiviazione e gestione per una raccolta di dati, in genere una tabella, che contiene uno schema (colonne) e dei campi (righe). I set di dati funzionano in parallelo con gli schemi e per acquisire i dati in Real-Time Customer Profile, il set di dati deve essere abilitato per l’acquisizione del profilo. Affinché il set di dati possa essere abilitato per il profilo, deve fare riferimento a uno schema abilitato per l’acquisizione del profilo.

Per istruzioni su come creare un set di dati, leggere la guida dell'interfaccia utente del set di dati.

Inserire i dati ingest

A questo punto, dovresti disporre dei seguenti elementi:

  • Le autorizzazioni necessarie per accedere alle funzioni di Identity Service.
  • Namespace per i dati.
  • Namespace univoci designati e priorità configurate per i namespace.
  • Almeno uno schema XDM. (A seconda dei dati e del caso d’uso specifico, potrebbe essere necessario creare schemi sia di profilo che di evento esperienza.)
  • Un set di dati basato sullo schema.

Una volta che hai tutti gli elementi elencati sopra, puoi iniziare ad acquisire i dati in Experience Platform. Puoi eseguire l’acquisizione dei dati in diversi modi. Per trasferire i dati ad Experience Platform puoi utilizzare i seguenti servizi:

TIP
Una volta acquisiti i dati, il payload dei dati non elaborati XDM non cambia. Puoi comunque visualizzare le configurazioni dell’identità primaria nell’interfaccia utente. Tuttavia, queste configurazioni verranno sostituite dalle impostazioni di identità.

Per qualsiasi feedback, utilizza l'opzione Feedback su Beta nell'area di lavoro dell'interfaccia utente di Identity Service.

Convalidare i grafici validate

Utilizza il dashboard delle identità per ottenere informazioni sullo stato dei tuoi grafici delle identità, ad esempio il conteggio delle identità complessivo e le tendenze del conteggio dei grafici, il conteggio delle identità per spazio dei nomi e il conteggio dei grafici per dimensione. Puoi anche utilizzare il dashboard delle identità per visualizzare le tendenze su grafici con due o più identità, organizzati per spazio dei nomi.

Selezionare i puntini di sospensione (...), quindi selezionare Visualizza altri per ulteriori informazioni e per verificare che non siano presenti grafici compressi.

Dashboard delle identità nell'area di lavoro dell'interfaccia utente di Identity Service. {modal="regular"}

Utilizzare la finestra visualizzata per visualizzare informazioni sui grafici compressi. In questo esempio, sia e-mail che telefono sono contrassegnati come spazio dei nomi univoco, pertanto, non vi sono grafici compressi nella sandbox.

Finestra popup per grafici con più identità. {modal="regular"}

Appendice appendix

Leggi questa sezione per ulteriori informazioni a cui puoi fare riferimento durante l’implementazione delle impostazioni di identità e degli spazi dei nomi univoci.

Scenario loginID con interferenza dangling-loginid-scenario

Il grafico seguente simula uno scenario di loginID "penzolante". In questo esempio, due diversi loginID sono associati allo stesso ECID. Tuttavia, {loginID: ID_C} non è collegato al CRMID. Pertanto, il servizio Identity non è in grado di rilevare che questi due ID di accesso rappresentano due entità diverse.

ID accesso ambiguo

In questo esempio, {loginID: ID_C} viene lasciato scollegato da un CRMID. Pertanto, l’entità persona a cui deve essere associato questo loginID rimane ambigua.

Esempio di un grafico con uno scenario di loginID "pendente". {modal="regular"}

loginID collegato a un CRMID

In questo esempio, {loginID: ID_C} è collegato a {CRMID: Tom}. Pertanto, il sistema è in grado di rilevare che questo loginID è associato a Tom.

LoginID è collegato a un CRMID. {modal="regular"}

loginID è collegato a un altro CRMID

In questo esempio, {loginID: ID_C} è collegato a {CRMID: Summer}. Pertanto, il sistema è in grado di rilevare che questo loginID è associato a un’altra entità persona, in questo caso Summer.

In questo esempio viene inoltre mostrato che Tom e Summer devono separare le entità persona che condividono un dispositivo, rappresentato da {ECID: 111}.

LoginID è collegato a un altro CRMID. {modal="regular"}

Passaggi successivi

Per ulteriori informazioni su Identity Graph Linking Rules, leggere la seguente documentazione:

recommendation-more-help
64963e2a-9d60-4eec-9930-af5aa025f5ea