Esta página descreve o método getIdentity do SDK do Servidor. Para o Web SDK, consulte getIdentity.
O método getIdentity retorna a Experience Cloud ID (ECID) do visitante sem enviar dados do evento. Quando você chama sendEvent, a Edge Network estabelece a identidade do visitante automaticamente. Portanto, use getIdentity somente quando o servidor precisar da ECID. Por exemplo, use-o para armazenar a ECID com seus próprios registros ou para passá-la para outro sistema.
Chame getIdentity no identificador forRequest do visitante:
const visitor = alloy.forRequest({ request: req, cookie: visitorCookies });
const result = await visitor.getIdentity({
namespaces: ["ECID"]
});
console.log(result.identity.ECID);
O SDK usa o seguinte fluxo para retornar a ECID:
- O SDK verifica se o consentimento permite continuar. Se o visitante optou por não participar,
getIdentityserá resolvido com um objeto vazio. - Se o cookie de identidade do visitante estiver disponível por meio do serviço de cookie passado para
forRequest, o SDK lerá a ECID sem entrar em contato com a Adobe. - Caso contrário, o SDK solicitará a identidade do visitante da Edge Network, gravará o cookie de identidade por meio do serviço de cookies e retornará a ECID.
A solicitação para o Edge Network não está autenticada. Certifique-se de que sua sequência de dados aceite solicitações não autenticadas. Consulte Definir o tipo de acesso da sequência de dados.
Se você não passar um serviço de cookie para forRequest, a SDK não poderá encontrar uma identidade existente, então cada identificador forRequest receberá uma nova ECID. Consulte Instâncias e solicitações.
Opções options
O método getIdentity aceita um objeto opcional com as seguintes propriedades:
namespaces: Uma matriz dos namespaces de identidade a serem retornados. Os valores com suporte são"ECID"e"CORE". O valor padrão é["ECID"]. Você pode solicitar o namespace"CORE"somente quandothirdPartyCookiesEnabledfortrue. Caso contrário,getIdentityserá rejeitado.edgeConfigOverrides: um objeto de substituição da configuração de sequência de dados para esta solicitação.
Objeto de resultado result
O método getIdentity retorna uma promessa. Quando ele é resolvido, o objeto de resultado contém as seguintes propriedades:
identity.ECID: uma string que contém a ECID do visitante.identity.CORE: uma cadeia de caracteres que contém a ID PRINCIPAL do visitante, se você solicitou o namespaceCORE.edge.regionId: um número inteiro que identifica a região do Edge Network que manipulou a solicitação. Essa propriedade está presente somente quando a SDK entrou em contato com a Edge Network para obter a identidade.
const { identity } = await visitor.getIdentity();
console.log(identity.ECID);