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.

Parâmetro
Descriçã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.

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