Show Menu
TOPICS×

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%01
    0
  • Autenticado: ...d_cid=123%01456%01
    1
  • Logout: ...d_cid=123%01456%01
    2

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 produto Launch.
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.