Show Menu
TOPICS×

Soporte hash SHA 256 para
setCustomerIDs

El servicio de Experience Cloud ID (ECID) es compatible con el algoritmo de hash SHA-256 que le permite pasar los ID de clientes o direcciones de correo electrónico, así como los ID de hash. Es un método opcional Javascript para enviar identificadores hash a Experience Cloud. Puede seguir utilizando sus propios métodos de hash antes de enviar ID de clientes. Existen dos maneras de implementar la compatibilidad hash con setCustomerIDs, tal como se describe en las secciones siguientes:

Uso del método
setCustomerIDs
en ECID

El primer método aprovecha el uso del método
setCustomerIDs
(
customerIDs<object>
,
hashType<string>
).
Antes del hashing, la biblioteca ECID realiza la normalización de datos en customerIDs. Este proceso recorta los espacios en blanco de los customerIDs en ambos extremos y convierte todos los caracteres en minúsculas. Por ejemplo, en las direcciones de correo electrónico: " ecid@adobe.com "se convierte en" ecid@adobe.com "
Consulte a continuación un ejemplo de cómo configurar un único ID de cliente (la dirección de correo electrónico mencionada anteriormente) con hashing SHA -256.
// Set single customerID with SHA-256 hashing visitor.setCustomerIDs({email: {id: "ecid@adobe.com", authState: 1}}, "SHA-256");
 
Junto con el ID de visitante de Experience Cloud, se pueden asociar ID de cliente adicionales y un estado de autenticación a cada visitante. Si no proporciona ningún tipo de hash, se considerará como sin hash.
El
setCustomerIDs
método acepta múltiples ID de cliente para el mismo visitante. Ayuda a identificar o dirigirse a un usuario individual entre distintos dispositivos. Por ejemplo, puede cargar estos ID como atributos de cliente a Experience Cloud y acceder a estos datos en las distintas soluciones.
Los ID de cliente, los estados autenticados y el tipo de hash
no se
almacenan en una cookie que se utilizará después. En su lugar, los ID de cliente, los estados autenticados y el tipo de hash deben almacenarse en una variable de instancia para recuperarse usando
getCustomerIDs
como se muestra a continuación:
> visitor.getCustomerIDs(); < {email: {…}} email: {id: "a6ea4cde5da5ae7cc68baae894d1d6544fca26254433b0fff7c2cb4843b4a097", authState: 1, hashType: "SHA-256"} __proto__: Object
 
Los resultados del método
setCustomerIDs
dan como resultado una llamada al servicio Experience Cloud ID, un
dpm.demdex.net
, con la adición del parámetro de consulta
d_cid_ic
, que contiene el ID de cliente con hash. Una llamada de ejemplo podría parecerse a la de abajo. Se agregaron los saltos de línea para una mayor claridad.
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 la tabla siguiente para ver una descripción del parámetro
d_cid_ic
y del estado de autenticación.
Parámetro
Descripción
d_cid_ic
Pasa el código de integración, el ID de usuario único (DPUUID) y un ID de estado autenticado al servicio de identidad. Separe el código de integración y el DPUUID con el carácter de control sin impresión,
%01:
Ejemplo:
d_cid_ic = Integration_ code% 01DPUUID%01Authentication_state
Estado de autenticación
Se trata de un ID opcional en el parámetro d_cid_ic. Se expresa como un entero e identifica a los usuarios en función de su estado de autenticación, como se muestra a continuación:
  • 0 (Desconocido o nunca autenticado)
  • 1 (Actualmente autenticado para esta instancia/página/contexto de aplicación)
  • 2 (Desconectado)
Ejemplos:
  • Desconocido: ...d_cid=123%01456%01
    0
  • Autenticado: ...d_cid=123%01456%01
    1
  • Desconectado: ...d_cid=123%01456%01
    2

Añadir una acción en Adobe Experience Platform Launch

Experience Platform Launch es la función de administración de etiquetas de próxima generación de Adobe. Obtenga más información sobre Launch en la documentación del producto Launch.
Para agregar una acción en Launch, lea la documentación de reglas de Adobe Launch y consulte la captura de pantalla siguiente:
 
Tras confirmar la configuración, Launch ajusta los datos en un objeto, como se muestra a continuación:
{ integration_code: { id: "value", authState: auth_state, hashType: "hash_algorithm" } }
Este es un ejemplo de código:
// Set single customer ID with hash type setCustomerIDs(Ingeration code: { id: "string_value", authState: auth_state, hashType: "hash_algorithm" });
De manera similar al método
setCustomerIDs
descrito en la primera sección, esto resulta en una llamada al servicio Experience Cloud ID, con la adición del parámetro de consulta
d_cid_ic
.