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

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

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

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 getCustomerIDscomo 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ámetrod_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%010
  • Autenticado: …d_cid=123%01456%011
  • Desconectado: …d_cid=123%01456%012

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 productoLaunch.

Para agregar una acción en Launch, lea la documentación de reglas en Inicio de Adobe y vea 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.

En esta página

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now