Suporte a hash SHA 256 para setCustomerIDs

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

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 soluções diferentes.

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.

Parâmetro Descrição
d_cid_ic Transmite o Código de integração, a ID de usuário exclusiva (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%010
  • Autenticado: …d_cid=123%01456%011
  • Logout: …d_cid=123%01456%012

Adicionar uma ação na Adobe Experience Platform Launch

A Experience Platform Launch reúne os recursos de gerenciamento de tags de última geração da Adobe. Leia mais sobre o Launch na documentação do produtoLaunch.

Para adicionar uma ação no Launch, leia a documentação das 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.

Nesta página