Utilizzo di identityMap nella raccolta dati

L'oggetto payload identityMap è il modo in cui si comunica all'Edge Network chi è un visitatore oltre il livello di dispositivo ECID. Quando un visitatore effettua l’accesso, completa un acquisto o viene altrimenti reso noto, puoi inviare identificatori a livello di persona (ID del sistema di gestione delle relazioni con i clienti, e-mail con hash, ID fedeltà, ecc.) insieme all’ECID. Questi identificatori a livello di persona forniscono informazioni preziose ai servizi a valle in modo che possano:

In questa pagina viene descritto come creare payload identityMap, scegliere le impostazioni corrette per ogni identità e gestire scenari di implementazione comuni.

Struttura del payload structure

identityMap è un oggetto JSON in cui ogni chiave di primo livello è uno spazio dei nomi e il valore è un array di descrittori di identità. È possibile includere uno o più spazi dei nomi in un singolo payload e ogni descrittore contiene tre campi: id, authenticatedState e primary.

{
  "identityMap": {
    "CRMID": [
      {
        "id": "abc-123-xyz",
        "authenticatedState": "authenticated",
        "primary": true
      }
    ]
  }
}

Le sezioni seguenti descrivono in dettaglio ciascuna parte del payload.

Chiavi dello spazio dei nomi namespace-keys

Ogni chiave di primo livello in identityMap è uno spazio dei nomi identity, ovvero una stringa che classifica il tipo di identificatore, ad esempio CRMID, Email, Phone o LoyaltyId. Gli spazi dei nomi devono esistere in Identity Service prima di poter essere inseriti in un payload. È possibile includere più chiavi dello spazio dei nomi nello stesso evento quando si dispone di più identificatori per il visitatore.

Non è necessario includere l’ECID come chiave dello spazio dei nomi. Edge Network aggiunge automaticamente l’ECID al payload di identità. Se includi esplicitamente l'ECID, non contrassegnarlo come primary quando è presente anche un'identità a livello di persona.

id id

Il campo id è la stringa dell'identificatore stesso, ovvero il valore che indica ad Experience Platform quale persona o dispositivo specifico rappresenta questa identità. Ogni spazio dei nomi identità prevede un formato di valore specifico e l'invio di un valore nel formato errato crea un'identità distinta che non può essere unita alla versione formattata correttamente, con conseguente frammentazione dei profili.

Prima di includere un valore in identityMap, preparalo in base al formato previsto dallo spazio dei nomi di destinazione:

Per l'elenco completo degli spazi dei nomi standard e delle relative definizioni, vedere Panoramica dello spazio dei nomi delle identità.

Raccolta di id in fase di runtime collect-id

L’identificatore necessario è raramente disponibile direttamente sulla pagina. Le strategie comuni di raccolta includono:

authenticatedState authenticated-state

Il campo authenticatedState indica ai servizi a valle il livello di attendibilità da inserire in una determinata identità. I seguenti valori sono validi per questo campo:

primary primary-identity

Ogni payload identityMap deve avere esattamente un'identità contrassegnata come primary: true. L’identità primaria determina quale identità viene utilizzata come ancoraggio per l’evento in Experience Platform.

Segui queste linee guida quando imposti l’identità primaria:

{
  "identityMap": {
    "CRMID": [
      {
        "id": "abc-123-xyz",
        "authenticatedState": "authenticated",
        "primary": true
      }
    ],
    "Email": [
      {
        "id": "user@example.com",
        "authenticatedState": "authenticated",
        "primary": false
      }
    ]
  }
}

Invio di identityMap nell’implementazione send-identity

alloy("sendEvent", {
  xdm: {
    identityMap: {
      CRMID: [
        {
          id: "abc-123-xyz",
          authenticatedState: "authenticated",
          primary: true
        }
      ]
    },
    eventType: "web.webpagedetails.pageViews"
  }
});

Scenari comuni common-scenarios

{
  "identityMap": {
    "CRMID": [
      {
        "id": "abc-123-xyz",
        "authenticatedState": "authenticated",
        "primary": true
      }
    ]
  }
}

{
  "identityMap": {
    "CRMID": [
      {
        "id": "abc-123-xyz",
        "authenticatedState": "loggedOut",
        "primary": false
      }
    ]
  }
}

{
  "identityMap": {
    "CRMID": [
      {
        "id": "abc-123-xyz",
        "authenticatedState": "authenticated",
        "primary": true
      }
    ],
    "Email_LC_SHA256": [
      {
        "id": "a1b2c3d4e5f6...",
        "authenticatedState": "authenticated",
        "primary": false
      }
    ],
    "LoyaltyId": [
      {
        "id": "LOY-98765",
        "authenticatedState": "authenticated",
        "primary": false
      }
    ]
  }
}

Effetti di identityMap sul grafo delle identità identity-graph

Ogni payload identityMap che raggiunge Experience Platform viene elaborato da Identity Service, che collega le identità inviate a un grafo di identità. Gli spazi dei nomi inclusi, la modalità di impostazione di authenticatedState e l'identità contrassegnata come primary determinano direttamente il modo in cui Identity Service crea e unisce tali grafici.

Comportamenti chiave da considerare:

Se l'implementazione utilizza regole di collegamento del grafo delle identità (ad esempio, la priorità dello spazio dei nomi o l'algoritmo di ottimizzazione delle identità), consultare la guida all'implementazione per capire come queste regole interagiscono con le identità inviate tramite identityMap.