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

Adobe Experience Platform Web SDK 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.

SDK no interactúa con ninguna CMP predeterminada. Depende de usted determinar cómo integrar SDK en su sitio web, detectar cambios de consentimiento en la CMP y llamar al comando correspondiente. En este documento se proporciona una guía general sobre cómo integrar CMP con Experience Platform Web SDK.

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 SDK con 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 de SDK en el 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:

Configuración de una secuencia de datos

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

Después de crear una nueva secuencia de datos o seleccionar una existente para editarla, selecciona 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.

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 de Experience Platform Web SDK

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

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

Seleccione Guardar para instalar la extensión.

Creación de 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 predeterminado del consentimiento de recopilación de datos (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 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:

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

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

Desde aquí, debe crear un elemento de datos de JavaScript Variable 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 de Web SDK. En la sección 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 de SDK en su sitio web, puede empezar a utilizar el comando Experience Platform Web SDK setConsent para enviar datos de consentimiento a Experience Platform.

El comando setConsent realiza dos acciones:

Cuándo llamar a setConsent

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

setConsent sintaxis

El comando setConsent espera un objeto de carga útil que contenga una sola propiedad de tipo matriz: consent. La matriz consent 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 de llamada a setConsent:

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"
      }
    }
  }]
});

El siguiente 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 Experience Platform Web SDK
  alloy("setConsent", {
    consent: [{
      standard: "Adobe",
      version: "2.0",
      value: consentXDM
    }]
  });
});

Gestión de respuestas de SDK

Todos los comandos Experience Platform SDK 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 comandos para obtener más información.

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

Pasos siguientes

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