Integración del SDK web de Platform para procesar los datos de consentimiento del cliente mediante el estándar Adobe 2.0

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 lista para usar. Depende de usted determinar cómo integrar el SDK en su sitio web, detectar cambios de consentimiento en el CMP y llamar al comando correspondiente. Este documento proporciona instrucciones generales sobre cómo integrar su CMP con el SDK web de Platform.

Requisitos previos

Este tutorial supone que ya ha determinado cómo generar datos de consentimiento dentro de su CMP y ha creado un conjunto de datos que contiene campos de consentimiento que se han habilitado para Perfil del cliente en tiempo real. Para obtener más información sobre estos pasos, consulte la información general sobre el procesamiento del consentimiento en Experience Platform antes de volver a esta guía.

Además, esta guía requiere una comprensión práctica de las extensiones de Adobe Experience Platform Launch y de cómo se instalan en aplicaciones web. Consulte la siguiente documentación para obtener más información:

Configuración de Edge

Para que el SDK envíe datos a Experience Platform, debe tener una configuración edge existente para Platform configurada en Adobe Experience Platform Launch. Además, el Profile Dataset que seleccione para la configuración debe contener campos de consentimiento estandarizados.

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

Campo de configuración de Edge Valor
Sandbox El nombre de la plataforma sandbox que contiene la conexión de flujo continuo necesaria y los conjuntos de datos para configurar la configuración perimetral.
Streaming Inlet Conexión de flujo continuo válida para el Experience Platform. Consulte el tutorial sobre la creación de una conexión de flujo continuo si no tiene una entrada de flujo continuo existente.
Event Dataset Conjunto de datos XDM ExperienceEvent que planea usar para enviar datos de evento a mediante el SDK. Aunque es necesario que proporcione un conjunto de datos de evento para crear una configuración perimetral de Platform, tenga en cuenta que actualmente no se admite el envío de datos de consentimiento directamente a través de eventos.
Profile Dataset El conjunto de datos habilitado para Profile con campos de consentimiento del cliente que creó anteriormente.

Cuando termine, seleccione Save en la parte inferior de la pantalla y continúe siguiendo las indicaciones adicionales para completar la configuración.

Instalación y configuración de la extensión web SDK de Platform

Una vez que haya creado una configuración perimetral como se describe en la sección anterior, debe configurar la extensión del SDK web de plataforma que implementará en su sitio. Si no tiene la extensión SDK instalada en la propiedad Platform launch, seleccione Extensions en la navegación izquierda, seguida de la pestaña Catalog. A continuación, seleccione Install en la extensión del SDK de plataforma dentro de la lista de extensiones disponibles.

Al configurar el SDK, en Edge Configurations, seleccione la configuración que creó en el paso anterior.

Seleccione Save para instalar la extensión.

Crear un elemento de datos para establecer el consentimiento predeterminado

Con la extensión de 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 sus usuarios. Esto puede resultar útil si desea tener diferentes valores predeterminados en función del usuario, como pending para usuarios de la Unión Europea y in para usuarios de América del Norte.

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 la etiqueta de script de Platform launch (código incrustado) en la página web, represente una etiqueta de script independiente que establezca una variable adobeDefaultConsent en función de la región del usuario.
  3. Configure un elemento de datos que utilice la variable JavaScript adobeDefaultConsent 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 realizar los siguientes pasos:

  1. Gestione el evento "CMP loaded" en la página.
  2. En el controlador de eventos, establezca una variable adobeDefaultConsent basada en la región del usuario y, a continuación, cargue el script de la biblioteca de Platform launch mediante JavaScript.
  3. Configure un elemento de datos que utilice la variable JavaScript adobeDefaultConsent 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 de Platform launch, seleccione Data Elements en el panel de navegación izquierdo y, a continuación, seleccione Add Data Element para ir al cuadro de diálogo de creación de elementos de datos.

A partir de aquí, debe crear un elemento de datos JavaScript Variable basado en adobeDefaultConsent. Seleccione Save 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 la sección Privacy , seleccione Provided by data element y utilice el cuadro de diálogo proporcionado para seleccionar el elemento de datos de consentimiento predeterminado que creó anteriormente.

Implementar la extensión en el sitio web

Una vez que haya terminado de configurar la extensión, esta se puede integrar en el sitio web. Consulte la guía de publicación en la documentación de Platform launch para obtener información detallada sobre cómo implementar la compilación de biblioteca actualizada.

Creación de comandos de cambio de consentimiento

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

Hay dos escenarios en los que se debe llamar a setConsent 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 enlace CMP o un detector de eventos que detecta cambios en la configuración del consentimiento
NOTA

Para obtener una introducción a la sintaxis común de los comandos del SDK de Platform, consulte el documento sobre ejecución de comandos.

El comando setConsent espera dos argumentos:

  1. Una cadena que indica el tipo de comando (en este caso, "setConsent")
  2. Objeto de carga útil que contiene una única propiedad de tipo matriz: consent. La matriz consent debe contener al menos un objeto que proporcione los campos de consentimiento necesarios para el estándar de Adobe.

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

alloy("setConsent", {
  consent: [{
    standard: "Adobe",
    version: "2.0",
    value: {
      collect: {
        val: "y"
      },
      share: {
        val: "y"
      },
      personalize: {
        content: {
          val: "y"
        }
      },
      metadata: {
        time: "2020-10-12T15:52:25+00:00"
      }
    }
  }]
});
Propiedad Payload Descripción
standard El estándar de consentimiento que se está utilizando. Para el estándar de Adobe, este valor debe establecerse en Adobe.
version Número de versión del estándar de consentimiento indicado en standard. Este valor debe establecerse en 2.0 para el procesamiento de consentimiento estándar de 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 con perfil habilitado.
NOTA

Si está utilizando otros estándares de consentimiento junto con Adobe (como IAB TCF), puede agregar objetos adicionales a la matriz consent para cada estándar. Cada objeto debe contener valores adecuados para standard, version y value para el estándar de consentimiento que representan.

El siguiente JavaScript proporciona un ejemplo de una función que gestiona los cambios de preferencias de consentimiento en un sitio web, que puede utilizarse como una rellamada 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

Todos los comandos Platform SDK devuelven promesas que indican si la llamada se ha realizado correctamente o no. A continuación, puede utilizar estas respuestas para lógica adicional, como mostrar mensajes de confirmación al cliente. Consulte la sección sobre gestión correcta o falla en la guía sobre la ejecución de comandos del SDK para ver ejemplos específicos.

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. Ahora puede volver a la descripción general del procesamiento del consentimiento para ver los pasos sobre cómo probar la implementación.

En esta página