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

The first method leverages using the setCustomerIDs (customerIDs<object>, hashType<string>) method.

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. For example, you can upload these IDs as customer attributes to the Experience Cloud and access this data across the different solutions.

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