DocumentazioneExperience PlatformGuida di SDK Web

getIdentity

Ultimo aggiornamento: 11 marzo 2025
  • Argomenti:

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.

  1. Il Web SDK viene utilizzato per chiamare getIdentity o appendIdentityToUrl.
  2. Web SDK attende di ricevere le informazioni sul consenso.
  3. Web SDK controlla se lo spazio dei nomi ECID è stato richiesto nella chiamata. Per impostazione predefinita, lo spazio dei nomi ECID è sempre incluso.
  4. Web SDK legge il cookie kndctr e restituisce il relativo valore come ECID, se esiste. Restituisce solo il valore ECID, ma non regionId.
  5. Se il cookie di identità kndctr non è impostato o è stato richiesto lo spazio dei nomi "CORE", Web SDK invia una richiesta all'Edge Network.
  6. Edge Network restituisce sia ECID che regionId (e CORE 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.
recommendation-more-help
ad108910-6329-42f1-aa1d-5920a2b13636