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.

IMPORTANTE

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

IMPORTANTE
  • 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.

Nesta página

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now