Show Menu
TÓPICOS×

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 de 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. Consulte alguns exemplos na tabela abaixo:
Status de autenticação Caso de uso
Visitor.AuthState.UNKNOWN
Esse estado pode ser usado para cenários como:
  • Ler um email (essa ação provavelmente significa que o leitor é o recipient pretendido, mas o email também pode ter sido encaminhado).
  • Ao clicar de um email para uma landing page.
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.
  • As IDs do cliente e os estados de autenticação não são armazenados 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 do 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. Este 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
As IDs do cliente retornadas e os dados de estado de autenticação devem ser semelhantes aos 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ódigo:

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 .