Integración del SDK web de Platform para procesar los datos de consentimiento del cliente

El SDK web de Adobe Experience Platform le permite recuperar las señales de consentimiento del cliente generadas por las plataformas de administración de consentimiento (CMP) y enviarlas a Adobe Experience Platform siempre que se produzca un evento de cambio de consentimiento.

El SDK no interactúa con ninguna CMP predeterminada. Depende de usted determinar cómo integrar el SDK en su sitio web, escuchar los cambios de consentimiento en la CMP y llamar al comando correspondiente. Este documento proporciona instrucciones generales sobre cómo integrar CMP con el SDK web de Platform.

Requisitos previos prerequisites

Este tutorial supone que ya ha determinado cómo generar datos de consentimiento dentro de su CMP y que ha creado un conjunto de datos que contiene campos de consentimiento que se ajustan al estándar de Adobe o al estándar de transparencia y consentimiento (TCF) 2.0 de IAB. Si aún no ha creado este conjunto de datos, consulte los siguientes tutoriales antes de volver a esta guía:

Esta guía sigue el flujo de trabajo para configurar el SDK mediante la extensión de etiqueta en la interfaz de usuario de. Si no desea utilizar la extensión de y prefiere incrustar directamente la versión independiente del SDK en su sitio, consulte los siguientes documentos en lugar de esta guía:

Los pasos de instalación de esta guía requieren una comprensión práctica de las extensiones de etiquetas y de cómo se instalan en las aplicaciones web. Consulte la siguiente documentación para obtener más información:

Configurar una secuencia de datos

Para que el SDK envíe datos a Experience Platform, primero debe configurar una secuencia de datos. En la IU de recopilación de datos o la IU del Experience Platform, seleccione Datastreams en el panel de navegación izquierdo.

Después de crear una nueva secuencia de datos o seleccionar una existente para editarla, seleccione el botón de alternancia situado junto a Adobe Experience Platform. A continuación, utilice los valores enumerados a continuación para completar el formulario.

Campo de secuencia de datos
Valor
Zona protegida
El nombre de la plataforma espacio aislado que contiene la conexión de flujo continuo y los conjuntos de datos necesarios para configurar el conjunto de datos.
Conjunto de datos del evento
Un XDM ExperienceEvent conjunto de datos que planea enviar datos de evento a mediante el SDK. Aunque se le requiere que proporcione un conjunto de datos de evento para crear un flujo de datos de Platform, tenga en cuenta que los datos de consentimiento enviados a través de eventos no se respetan en los flujos de trabajo de aplicación descendentes.
Conjunto de datos del perfil
El ProfileConjunto de datos habilitado para con campos de consentimiento del cliente que ha creado anterior.

Cuando termine, seleccione Guardar en la parte inferior de la pantalla y siga las indicaciones adicionales para completar la configuración.

Instalación y configuración del SDK web de Platform

Una vez que haya creado un conjunto de datos como se describe en la sección anterior, debe configurar la extensión del SDK web de Platform que implementará finalmente en el sitio. Si no tiene la extensión del SDK instalada en la propiedad de etiquetas, seleccione Extensiones en el panel de navegación izquierdo, seguido de Catálogo pestaña. A continuación, seleccione Instalar en la extensión del SDK de la plataforma, dentro de la lista de extensiones disponibles.

Al configurar el SDK, en Configuraciones de Edge, seleccione la secuencia de datos que creó en el paso anterior.

Seleccionar Guardar para instalar la extensión de.

Creación de un elemento de datos para establecer el consentimiento predeterminado

Con la extensión del SDK instalada, tiene la opción de crear un elemento de datos para representar el valor de consentimiento de recopilación de datos predeterminado (collect.val) para los usuarios. Esto puede resultar útil si desea tener diferentes valores predeterminados según el usuario, como pending para usuarios de la Unión Europea y in para usuarios de Norteamérica.

En este caso de uso, puede implementar lo siguiente para establecer el consentimiento predeterminado en función de la región del usuario:

  1. Determine la región del usuario en el servidor web.
  2. Antes de script (código incrustado) en la página web, procese una etiqueta independiente script que establece un adobeDefaultConsent en función de la región del usuario.
  3. Configure un elemento de datos que utilice la variable adobeDefaultConsent Variable JavaScript y utilice este elemento de datos como valor de consentimiento predeterminado para el usuario.

Si la región del usuario está determinada por una CMP, puede seguir estos pasos:

  1. Controle el evento "CMP loaded" en la página.
  2. En el controlador de eventos, establezca un adobeDefaultConsent basada en la región del usuario y, a continuación, cargue el script de la biblioteca de etiquetas mediante JavaScript.
  3. Configure un elemento de datos que utilice la variable adobeDefaultConsent Variable JavaScript y utilice este elemento de datos como valor de consentimiento predeterminado para el usuario.

Para crear un elemento de datos en la interfaz de usuario, seleccione Elementos de datos en el panel de navegación izquierdo, seleccione Añadir elemento de datos para ir al cuadro de diálogo de creación de elementos de datos.

A partir de aquí, debe crear una Variable JavaScript elemento de datos basado en adobeDefaultConsent. Seleccione Guardar cuando haya terminado.

Una vez creado el elemento de datos, vuelva a la página de configuración de la extensión del SDK web. En el Privacidad , seleccione Proporcionado por el elemento de datos y utilice el cuadro de diálogo proporcionado para seleccionar el elemento de datos de consentimiento predeterminado que creó anteriormente.

Implemente la extensión en el sitio web

Una vez que haya terminado de configurar la extensión, puede integrarla en su sitio web. Consulte la guía de publicación en la documentación de etiquetas para obtener información detallada sobre cómo implementar la compilación de biblioteca actualizada.

Realizar comandos de cambio de consentimiento commands

Una vez que haya integrado la extensión del SDK en el sitio web, puede empezar a utilizar el SDK web de Platform setConsent para enviar datos de consentimiento a Platform.

El setConsent realiza dos acciones:

  1. Actualiza los atributos de perfil del usuario directamente en el almacén de perfiles. Esto no envía ningún dato al lago de datos.
  2. Crea un Evento de experiencia que registra una cuenta con marca de tiempo del evento de cambio de consentimiento. Estos datos se envían directamente al lago de datos y se pueden utilizar para realizar un seguimiento de los cambios de preferencia de consentimiento a lo largo del tiempo.

Cuándo llamar a setConsent

Hay dos escenarios en los que setConsent Se debe llamar a en el sitio:

  1. Cuando se carga el consentimiento en la página (es decir, en cada carga de página)
  2. Como parte de un vínculo o detector de eventos CMP que detecta los cambios en la configuración de consentimiento

setConsent sintaxis

El setConsent El comando espera un objeto de carga útil que contenga una sola propiedad de tipo matriz: consent. El consent La matriz debe contener al menos un objeto que proporcione los campos de consentimiento requeridos para el estándar de Adobe.

Los campos de consentimiento requeridos para el estándar de Adobe se muestran en el siguiente ejemplo setConsent llamada:

alloy("setConsent", {
  consent: [{
    standard: "Adobe",
    version: "2.0",
    value: {
      collect: {
        val: "y"
      },
      share: {
        val: "y"
      },
      personalize: {
        content: {
          val: "y"
        }
      },
      metadata: {
        time: "YYYY-10-12T15:52:25+00:00"
      }
    }
  }]
});
Propiedad de carga útil
Descripción
standard
El estándar de consentimiento que se está utilizando. Para el estándar de Adobe, este valor debe configurarse como Adobe.
version
El número de versión del estándar de consentimiento indicado en standard. Este valor debe establecerse en 2.0 para el procesamiento de consentimientos estándar del Adobe.
value
La información de consentimiento actualizada del cliente, proporcionada como un objeto XDM que se ajusta a la estructura de los campos de consentimiento del conjunto de datos habilitado para el perfil.
NOTE
Si utiliza otros estándares de consentimiento junto con Adobe (como IAB TCF), se pueden añadir objetos adicionales al consent matriz para cada estándar. Cada objeto debe contener los valores adecuados para standard, version, y value para el estándar de consentimiento que representan.

El siguiente código JavaScript proporciona un ejemplo de una función que administra los cambios de preferencias de consentimiento en un sitio web, que se puede utilizar como llamada de retorno en un detector de eventos o un vínculo CMP:

var setConsent = function () {

  // Retrieve the current consent data.
  var categories = getConsentData();

  // If the script is running on a consent change, generate a new timestamp.
  // If the script is running on page load, set the timestamp to when the consent values last changed.
  var now = new Date();
  var collectedAt = consentChanged ? now.toISOString() : categories.collectedAt;

  //  Map the consent values and timestamp to XDM
  var consentXDM = {
    collect: {
      val: categories.collect !== -1 ? "y" : "n"
    },
    personalize: {
      content: {
        val: categories.personalizeContent !== -1 ? "y" : "n"
      }
    },
    share: {
      val: categories.share !== -1 ? "y" : "n"
    },
    metadata: {
      time: collectedAt
    }
  };

  // Pass the XDM object to the Platform Web SDK
  alloy("setConsent", {
    consent: [{
      standard: "Adobe",
      version: "2.0",
      value: consentXDM
    }]
  });
});

Gestión de respuestas del SDK

Todo Platform SDK los comandos devuelven promesas que indican si la llamada se realizó correctamente o no. A continuación, puede utilizar estas respuestas para lógicas adicionales, como mostrar mensajes de confirmación al cliente. Consulte Respuestas de comando para obtener más información.

Una vez que haya realizado correctamente setConsent Llamadas de con el SDK, puede utilizar el visor de perfiles de la interfaz de usuario de Platform para comprobar si los datos llegan al almacén de perfiles de. Consulte la sección sobre exploración de perfiles por identidad para obtener más información.

Pasos siguientes

Al seguir esta guía, ha configurado la extensión del SDK web de Platform para enviar datos de consentimiento al Experience Platform. Para obtener instrucciones sobre cómo probar la implementación, consulte la documentación del estándar de consentimiento que está implementando:

recommendation-more-help
5741548a-2e07-44b3-9157-9c181502d0c5