Suporte a hash SHA256 para setCustomerIDs
hashing-support
O serviço de Experience Cloud ID (ECID) é compatível com o algoritmo de hash SHA -256 que permite transmitir IDs do cliente ou endereços de email e enviar IDs com hash. Este é um método opcional Javascript para enviar identificadores com hash à Experience Cloud. Você pode continuar a usar seus próprios métodos de hash antes de enviar IDs do cliente.
Há duas maneiras de implementar o suporte de hash com setCustomerIDs, conforme descrito nas seções abaixo:
Usar o método setCustomerIDs
no ECID use-setcustomerids-method
O primeiro método aproveita o uso do método setCustomerIDs
(customerIDs<object>
, hashType<string>
).
Antes do hash, a biblioteca ECID realiza normalização de dados nas customerIDs. Esse processo elimina os espaços em branco das customerIDs e converte todos os caracteres em minúsculas. Por exemplo, no caso de endereços de email: "ecid@adobe.com" torna-se "ecid@adobe.com"
Consulte abaixo um exemplo de código de como você define uma única ID do cliente (o endereço de email mencionado acima) com hash SHA -256.
// Set single customerID with SHA-256 hashing
visitor.setCustomerIDs({email: {id: "ecid@adobe.com", authState: 1}}, "SHA-256");
Juntamente com a ID de visitante da Experience Cloud, é possível associar mais IDs do cliente, um status de autenticação e um tipo de hash (SHA-256) com cada visitante. Se não fornecer nenhum tipo de hash, será considerado como nenhum hash.
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 diferentes soluções.
As IDs do cliente, os estados autenticados e o tipo de hash não são armazenados em um cookie a ser usado posteriormente. Em vez disso, as IDs do cliente, os estados autenticados e o tipo de hash devem ser armazenados em uma variável de instância, a ser recuperada usando getCustomerIDs
, como mostrado abaixo:
> visitor.getCustomerIDs();
< {email: {…}}
email: {id: "a6ea4cde5da5ae7cc68baae894d1d6544fca26254433b0fff7c2cb4843b4a097", authState: 1, hashType: "SHA-256"}
__proto__: Object
O uso do método setCustomerIDs
resulta em uma chamada para o serviço da Experience Cloud ID, para dpm.demdex.net
, com a adição do parâmetro de consulta d_cid_ic
, que contém a ID do cliente com hash. Uma chamada de amostra pode ter a aparência abaixo. Quebras de linha foram adicionadas para maior clareza.
http://dpm.demdex.net/id?d_visid_ver=4.4.0&d_fieldgroup=AAM&d_rtbd=json&d_ver=2&
d_orgid=12A3F3F459CE0AD80A495CBE%40AdobeOrg&d_nsid=0&d_mid=12349850857640731290890207735189050123&
d_blob=6G1ynYcLPuiQxYZrsz_pkqfLG9yMXBpb2zX5dvJdYQJzPXImdj0y&
d_cid_ic=email%a6ea4cde5da5ae7cc68baae894d1d6544fca26254433b0fff7c2cb4843b4a097%011&
ts=1563299964843
Consulte a tabela abaixo para obter uma descrição do parâmetro d_cid_ic
e do estado de autenticação.
d_cid_ic
Transmite o Código de integração, o identificador de usuário único (DPUUID) e uma ID de estado autenticada para o serviço de ID. Separe o Código de Integração e a DPUUID com o caractere de controle não imprimível, %01
:
Exemplo: d_cid_ic=Integration_code%01DPUUID%01Authentication_state
Estado de autenticação
Essa é uma ID opcional no parâmetro d_cid_ic. Expressa como um inteiro, identifica os usuários de acordo com o status de autenticação como mostrado abaixo:
- 0 (Desconhecido ou nunca autenticado)
- 1 (Atualmente autenticado para esta instância/página/contexto de aplicativo)
- 2 (Logout realizado)
Exemplos:
- Desconhecido: …d_cid=123%01456%01 0
- Autenticado: …d_cid=123%01456%01 1
- Logout: …d_cid=123%01456%01 2
Adicionar uma ação no Adobe Experience Platform Launch add-action-launch
O Experience Platform Launch reúne os recursos de gerenciamento de tags de última geração da Adobe. Leia mais sobre o Platform Launch na documentação do produto do Launch.
Para adicionar uma ação no Launch, leia a documentação de regras no Adobe Launch e veja a captura de tela abaixo:
Depois de confirmar sua configuração, o Launch vincula os dados em um objeto, como abaixo:
{
integration_code: {
id: "value",
authState: auth_state,
hashType: "hash_algorithm"
}
}
Aqui está uma amostra de código:
// Set single customer ID with hash type
setCustomerIDs(Ingeration code: {
id: "string_value",
authState: auth_state,
hashType: "hash_algorithm"
});
De modo semelhante ao método setCustomerIDs
descrito na primeira seção, isso resulta em uma chamada com o serviço da Experience Cloud ID, além do parâmetro d_cid_ic
de consulta.