getIdentity
Creato per:
- Sviluppatore
Quando si esegue il comando sendEvent
, Web SDK ottiene automaticamente l'identità del visitatore, se non ne è già presente una.
Il comando getIdentity
ti consente di ottenere un ID visitatore senza inviare dati evento.
Se hai bisogno di chiamate separate per generare un ID visitatore e inviare dati, puoi utilizzare questo comando.
Il comando getIdentity
esegue il seguente flusso per recuperare ECID
.
- Il Web SDK viene utilizzato per chiamare
getIdentity
oappendIdentityToUrl
. - Web SDK attende di ricevere le informazioni sul consenso.
- Web SDK controlla se lo spazio dei nomi
ECID
è stato richiesto nella chiamata. Per impostazione predefinita, lo spazio dei nomiECID
è sempre incluso. - Web SDK legge il cookie
kndctr
e restituisce il relativo valore comeECID
, se esiste. Restituisce solo il valoreECID
, ma nonregionId
. - Se il cookie di identità
kndctr
non è impostato o è stato richiesto lo spazio dei nomi"CORE"
, Web SDK invia una richiesta all'Edge Network. - Edge Network restituisce sia
ECID
cheregionId
(eCORE ID
, se richiesto).
Ottenere l’identità tramite l’estensione tag Web SDK
L’estensione tag Web SDK non offre questo comando tramite l’interfaccia utente dell’estensione tag. Utilizza l’editor di codice personalizzato utilizzando la sintassi della libreria di JavaScript.
Ottenere l’identità tramite la libreria JavaScript di Web SDK
Eseguire il comando getIdentity
quando si chiama l'istanza configurata del Web SDK. Durante la configurazione di questo comando sono disponibili le seguenti opzioni:
-
namespaces
: matrice di spazi dei nomi. Il valore predefinito è["ECID"]
. Altri valori supportati includono:["CORE"]
["ECID","CORE"]
null
undefined
È possibile richiedere ECID e CORE ID contemporaneamente. Esempio:
"namespaces": ["ECID","CORE"]
. -
edgeConfigOverrides
: oggetto di override della configurazione dello stream di dati.
alloy("getIdentity",{
"namespaces": ["ECID","CORE"] //this command retrieves both ECID and CORE IDs.
});
Oggetto di risposta
Se decidi di gestire le risposte con questo comando, nell'oggetto di risposta sono disponibili le seguenti proprietà:
identity.ECID
: stringa contenente l'identificatore ECID del visitatore.identity.CORE
: stringa contenente l'ID CORE del visitatore.edge.regionID
: un numero intero che rappresenta l'area Edge Network che il browser ha raggiunto quando ha acquisito un'identità. È lo stesso dell’hint di posizione legacy di Audience Manager.