Show Menu
TOPICS×

Estados de autenticação e IDs do cliente

É possível associar outras IDs do cliente e um status de autenticação com cada visitante, juntamente com a ID de visitante da Experience Cloud.

Estados de autenticação

O
setCustomerIDs
método aceita várias IDs do cliente para o mesmo visitante. Isso ajuda a identificar ou direcionar um usuário individual em diferentes dispositivos. Por exemplo, você pode fazer o upload dessas IDs como atributos do cliente para a Experience Cloud e acessar esses dados em soluções diferentes.
setCustomerIDs
(sincronização de ID do cliente) é exigida pelos atributos do cliente e pela funcionalidade dos serviços principais. Sincronização das IDs do cliente em um método de identificação opcional do Analytics. O Target requer
Visitor.AuthState.AUTHENTICATED
para que os Atributos do cliente funcionem. Consulte Principais serviços - Ativação das soluções para ver exemplos.
A partir do serviço de identidade da Experience Cloud v1.5+,
setCustomerIDs
inclui o objeto opcional
AuthState
. O
AuthState
identifica versões de acordo com seu status de autenticação (por exemplo, logon, logout). Você define o estado da autenticação com um valor de status listado na tabela. O status de autenticação é retornado como um número inteiro.
Status de autenticação
Número inteiro do status
Status do usuário
Visitor.AuthState.UNKNOWN
0
Desconhecido ou nunca autenticado.
Desconhecido se aplica por padrão quando o
AuthState
não é usado com uma ID do visitante ou não é definido explicitamente em cada página de contexto do aplicativo.
Visitor.AuthState.AUTHENTICATED
1
Autenticado para uma instância, página ou aplicativo específico.
Atenção: para funcionar adequadamente, os Atributos do cliente do
Target
exigem esse status.
Visitor.AuthState.LOGGED_OUT
2
Logout realizado.

Casos de uso para esados de autenticação

É possível atribuir estados autenticação aos usuários, dependendo das ações que eles realizam nas suas propriedades da web e se estão autenticados ou não. Confira alguns exemplos na tabela abaixo:
Status de autenticação
Caso de uso
Visitor.AuthState.UNKNOWN
Esse estado não pode ser usada para cenários como:
  • Ler um email (essa ação geralmente significa que o leitor é o destinatário pretendido, mas o email também poderia ter sido encaminhado).
  • Clicar de um email para uma página de destino.
Visitor.AuthState.AUTHENTICATED
O usuário está autenticado no momento com uma sessão ativa no seu site ou aplicativo.
Visitor.AuthState.LOGGED_OUT
O usuário foi autenticado, mas fez logout ativamente. O usuário quis se desconectar do estado autenticado. O usuário não deseja mais ser tratado como autenticado.

Definição das IDs do cliente e dos estados de autenticação

As IDs do cliente podem incluir combinações de IDs e estados de autenticação, conforme mostrado nos exemplos a seguir.
  • As IDs fazem distinção entre maiúsculas e minúsculas.
  • Use apenas valores não codificados para seus IDs.
  • Os estados de autenticação e as IDs de cliente não são armazenadas no cookie da ID do visitante. Eles devem ser definidos para cada página ou contexto de aplicativo.
  • Não inclua informações pessoais identificáveis (PII) nas IDs de cliente. Se você estiver usando PII para identificar um visitante (como um endereço de email), é recomendado armazenar uma versão com hash ou criptografada das informações. A biblioteca ECID fornece suporte para hash de identificadores de usuários. Consulte Suporte a hash SHA 256 para setCustomerIDs .
// Single ID with a single authentication state visitor.setCustomerIDs({ "userid":{ "id":"67312378756723456", "authState":Visitor.AuthState.AUTHENTICATED } }); /* Multiple IDs with only the first ID explicitly assigned an authentication state. The second ID is not explicitly assigned an authentication state and is implicitly assigned Visitor.AuthState.Unknown by default. */ visitor.setCustomerIDs({ "userid":{ "id":"67312378756723456", "authState":Visitor.AuthState.AUTHENTICATED }, "dpuuid":"550e8400-e29b-41d4-a716-446655440000" }); // Multiple IDs with identical authentication states visitor.setCustomerIDs({ "userid":{ "id":"67312378756723456", "authState":Visitor.AuthState.AUTHENTICATED }, "dpuuid":{ "id":"550e8400-e29b-41d4-a716-446655440000", "authState":Visitor.AuthState.AUTHENTICATED } }); // Multiple IDs with different authentication states visitor.setCustomerIDs({ "userid":{ "id":"67312378756723456", "authState":Visitor.AuthState.AUTHENTICATED }, "dpuuid":{ "id":"550e8400-e29b-41d4-a716-446655440000", "authState":Visitor.AuthState.LOGGED_OUT } });

Retorno das IDs do cliente e dos estados de autenticação

Use
getCustomerIDs
para retornar as IDs do cliente e os estados autenticados relacionados. Esse método retorna um estado autenticado do visitante como um número inteiro.
Sintaxe
getCustomerIDs
retorna os dados com a seguinte sintaxe.
{ [customerIDType1]:{ "id":[customerID1], "authState":[authState1] }, [customerIDType2]:{ "id":[customerID2], "authState":[authState2] } ... }
Exemplos
Os dados de estados de autenticação e IDs do cliente retornados devem parecer com os exemplos a seguir.
Object customerIDs = visitor.getCustomerIDs(); // No setCustomerIDs call on this instance {} // setCustomerIDs call on this instance with {"userid":{"id":"67312378756723456"}} { "userid":{ "id":"67312378756723456", "authState":0 } } // setCustomerIDs call on this instance with {"userid":{"id":"67312378756723456","authState":Visitor.AuthState.AUTHENTICATED}} { "userid":{ "id":"67312378756723456", "authState":1 } } // setCustomerIDs call on this instance with {"userid":{"authState":Visitor.AuthState.LOGGED_OUT}} { "userid":{ "authState":2 } } // setCustomerIDs call on this instance with {"userid":{"authState":Visitor.AuthState.LOGGED_OUT},"dpuuid":{"id":"550e8400-e29b-41d4-a716-446655440000"}} { "userid":{ "authState":2 }, "dpuuid":{ "id":"550e8400-e29b-41d4-a716-446655440000", "authState":0 } }

Suporte do SDK

O serviço da Experience Cloud ID oferece suporte a diversas IDs e estados de autenticação do cliente em nosso código de SDK para Android e iOS. Consulte as seguintes bibliotecas de códigos:

Aviso aos clientes do Analytics e do Audience Manager

Caso esteja passando IDs declaradas para o Audience Manager, o objeto
userid
precisa corresponder ao código de integração associado à fonte de dados. Para obter mais informações, consulte a seção Serviço de ID do visitante na documentação Configuração do código de regras de fusão .