Soporte hash SHA 256 para setCustomerIDs hashing-support

El servicio de ID de visitante (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 CX Enterprise. 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 ECID, puede asociar ID de cliente adicionales, estado de autenticación y tipo de hash (SHA-256) con 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 del cliente en CX Enterprise 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

El uso del método setCustomerIDs resulta en una llamada al servicio de ID de visitante, a 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 ID de visitante. 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 las etiquetas add-action-launch

Las etiquetas en la recopilación de datos de Adobe Experience Platform son la función de administración de etiquetas de próxima generación de Adobe. Obtenga más información en la documentación de etiquetas.

Para agregar una acción en las etiquetas, lea la documentación de reglas y vea la siguiente captura de pantalla:

Después de confirmar la configuración, las etiquetas envuelven 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 da como resultado una llamada al servicio de ID de visitante, con la adición del parámetro de consulta d_cid_ic.

recommendation-more-help
id-service-help