DocumentaçãoExperience PlatformGuia do SDK da Web

getIdentity

Last update: Tue Mar 11 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Tópicos:

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).

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.

Obter identidade usando a biblioteca JavaScript do Web SDK

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",{
  "namespaces": ["ECID","CORE"] //this command retrieves both ECID and CORE IDs.
});

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.
recommendation-more-help
ad108910-6329-42f1-aa1d-5920a2b13636