In questa pagina viene descritto il metodo getIdentity di Server SDK. Per il Web SDK, vedere getIdentity.
Il metodo getIdentity restituisce l’ECID del visitatore senza inviare i dati dell’evento. Quando chiami sendEvent, Edge Network stabilisce automaticamente l’identità del visitatore, quindi utilizza getIdentity solo quando il server ha bisogno dell’ECID stesso. Ad esempio, utilizzalo per memorizzare l’ECID con i tuoi record o per passarlo a un altro sistema.
Chiama getIdentity sull’handle forRequest del visitatore:
const visitor = alloy.forRequest({ request: req, cookie: visitorCookies });
const result = await visitor.getIdentity({
namespaces: ["ECID"]
});
console.log(result.identity.ECID);
Per restituire l’ECID, SDK utilizza il seguente flusso:
- SDK controlla se il consenso consente di procedere. Se il visitatore ha rinunciato,
getIdentitysi risolve con un oggetto vuoto. - Se il cookie di identità del visitatore è disponibile tramite il servizio cookie passato a
forRequest, SDK legge l’ECID senza contattare Adobe. - In caso contrario, SDK richiede l’identità del visitatore all’Edge Network, scrive il cookie di identità tramite il servizio cookie e restituisce l’ECID.
La richiesta ad Edge Network non è autenticata. Assicurati che lo stream di dati accetti le richieste non autenticate. Vedere Impostare il tipo di accesso allo stream di dati.
Se non si passa un servizio cookie a forRequest, SDK non è in grado di trovare un’identità esistente, pertanto ogni handle forRequest ottiene un nuovo ECID. Consulta Istanze e richieste.
Opzioni options
Il metodo getIdentity accetta un oggetto facoltativo con le seguenti proprietà:
namespaces: matrice degli spazi dei nomi di identità da restituire. I valori supportati sono"ECID"e"CORE". Il valore predefinito è["ECID"]. È possibile richiedere lo spazio dei nomi"CORE"solo quandothirdPartyCookiesEnabledètrue. In caso contrario,getIdentityrifiuta.edgeConfigOverrides: oggetto di override della configurazione dello stream di dati per questa richiesta.
Oggetto risultato result
Il metodo getIdentity restituisce una promessa. Quando viene risolto, l’oggetto risultante contiene le seguenti proprietà:
identity.ECID: stringa contenente l’identificatore ECID del visitatore.identity.CORE: stringa che contiene l’ID CORE del visitatore, se è stato richiesto lo spazio dei nomiCORE.edge.regionId: numero intero che identifica l’area Edge Network che ha gestito la richiesta. Questa proprietà è presente solo quando SDK ha contattato l’Edge Network per ottenere l’identità.
const { identity } = await visitor.getIdentity();
console.log(identity.ECID);