Estados de autenticação e IDs do cliente customer-ids-and-authentication-states

É 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 section-68ad4065dfaa437d9070832d6e2bf85c

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.

IMPORTANT
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 section-fe9560cc490943b29dac2c4fb6efd72c

É 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 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 section-ec4b367d16ad4ac1a1baca9b01f4ee98

As IDs do cliente podem incluir combinações de IDs e estados de autenticação, conforme mostrado nos exemplos a seguir.

IMPORTANT
  • 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 section-71a610546188478fa9a3185a01d6e83b

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 section-861c6b3b1ba645dda133dccb22ec7bb0

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 section-3a8e9d51e71c4c6e865184b81ed9d99b

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.

recommendation-more-help
9c9e8ca9-9f7e-42c9-a5d5-a0d82776362a