DocumentaçãoExperience PlatformColeção de dados

getIdentity

Last update: Tue Dec 02 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Criado para:

  • Desenvolvedor

Quando você executa o comando sendEvent, o Web SDK obtém automaticamente a identidade do visitante, se uma ainda não estiver presente. O comando getIdentity permite obter uma ID de visitante sem enviar dados do evento. Se você precisar de chamadas separadas para gerar uma ID de visitante e enviar dados, poderá usar esse comando.

O comando getIdentity passa pelo seguinte fluxo para recuperar o ECID.

  1. Você usa o Web SDK para chamar getIdentity ou appendIdentityToUrl.
  2. O Web SDK aguarda que as informações de consentimento sejam fornecidas.
  3. O Web SDK verifica se o namespace ECID foi solicitado na chamada. Por padrão, o namespace ECID é sempre incluído.
  4. O Web SDK lê o cookie kndctr e retorna seu valor como ECID, se ele existir. Retorna apenas o valor ECID, mas não regionId.
  5. Se o cookie de identidade kndctr não estiver definido ou o namespace "CORE" tiver sido solicitado, o Web SDK fará uma solicitação para a Edge Network.
  6. O Edge Network retorna o ECID e o regionId (e o CORE ID, se solicitado).

Execute o comando getIdentity ao chamar a instância configurada do Web SDK. As seguintes opções estão disponíveis ao configurar este comando:

  • namespaces: Uma matriz de namespaces. O valor padrão é ["ECID"]. Outros valores compatíveis incluem:

    • ["CORE"]
    • ["ECID","CORE"]
    • null
    • undefined

    Você pode solicitar "ECID" e "CORE ID" ao mesmo tempo. Exemplo: "namespaces": ["ECID","CORE"].

  • edgeConfigOverrides: Um objeto de substituição de configuração de sequência de dados.

alloy("getIdentity",{
  // This command retrieves both ECID and CORE IDs
  "namespaces": ["ECID","CORE"]
});

Objeto de resposta

Se você decidir manipular respostas com este comando, as seguintes propriedades estarão disponíveis no objeto de resposta:

  • identity.ECID: uma string contendo a ECID do visitante.
  • identity.CORE: uma cadeia de caracteres contendo a ID PRINCIPAL do visitante.
  • edge.regionID: um número inteiro que representa a região do Edge Network que o navegador atinge ao adquirir uma identidade. É o mesmo que a dica de localização herdada do Audience Manager.
// Get the visitor's ECID
alloy('getIdentity').then(result => {
  console.log(result.identity.ECID);
});

Obter identidade usando a extensão de tag do Web SDK

A extensão de tag do Web SDK não oferece esse comando por meio da interface do usuário da extensão de tag. Use o editor de código personalizado usando a sintaxe da biblioteca do JavaScript.

recommendation-more-help
1ae86b30-e55e-49c1-ab11-9d0356a5f3e1