Soporte hash SHA 256 para setCustomerIDs hashing-support

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 use-setcustomerids-method

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 en 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 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 único de usuario (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 add-action-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 Platform Launch en la documentación del producto de Launch.

Para añadir una acción en Launch, lea la documentación de reglas en Adobe Launch y vea la captura de pantalla a continuación:

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.

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