setConsent

El comando setConsent indica a Web SDK si debe enviar datos (adhesión), descartar datos (exclusión) o utilizar defaultConsent (consentimiento desconocido).

Web SDK admite los siguientes estándares:

Después de utilizar este comando, Web SDK escribe las preferencias del usuario en una cookie. La próxima vez que el usuario cargue el sitio web en el explorador, SDK recuperará estas preferencias persistentes para determinar si los eventos se pueden enviar a Adobe.

Adobe recomienda almacenar todas las preferencias del cuadro de diálogo de consentimiento por separado del consentimiento de Web SDK. Web SDK no ofrece una forma de obtener el consentimiento. Para asegurarse de que las preferencias del usuario permanecen sincronizadas con SDK, puede llamar al comando setConsent en cada carga de página. Web SDK solo realiza una llamada al servidor cuando cambia el consentimiento.

Consideraciones de sincronización de identidad identity-considerations

El comando setConsent solo usa ECID del mapa de identidad, ya que el comando funciona en el nivel de dispositivo. El comando setConsent no tiene en cuenta otras identidades del mapa de identidad.

Web SDK ofrece dos comandos de configuración de consentimiento complementarios:

  • defaultConsent: este comando está diseñado para capturar las preferencias de consentimiento de los clientes de Adobe que utilizan Web SDK.
  • setConsent: este comando está diseñado para capturar las preferencias de consentimiento de los visitantes del sitio.

Cuando se utilizan juntos, esta configuración puede llevar a diferentes resultados de recopilación de datos y configuración de cookies, según sus valores configurados.

Consulte la tabla siguiente para comprender cuándo se produce la recopilación de datos y cuándo se configuran las cookies, según la configuración de consentimiento.

defaultConsent
setConsent
Se produce la recopilación de datos
Web SDK establece cookies de explorador
in
in
in
out
No
in
Sin configurar
pending
in
pending
out
No
pending
Sin configurar
No
No
out
in
out
out
No
out
Sin configurar
No
No

Las siguientes cookies se establecen cuando la configuración de consentimiento lo permite:

Nombre
Edad máxima
Descripción
AMCV_###@AdobeOrg
34128000 (395 días)
Presente cuando idMigrationEnabled está habilitado. Ayuda al realizar la transición a Web SDK mientras algunas partes del sitio siguen utilizando visitor.js.
Demdex cookie
15552000 (180 días)
Presente si la sincronización de ID está habilitada. Audience Manager establece esta cookie para asignar un ID único a un visitante del sitio. La cookie demdex ayuda a Audience Manager a realizar diversas funciones básicas, como la identificación del visitante, la sincronización de ID, la segmentación, el modelado, la creación de informes, etc.
kndctr_orgid_cluster
1800 (30 minutos)
Almacena la región de Edge Network que sirve las solicitudes del usuario actual. La región se utiliza en la ruta URL para que Edge Network pueda enrutar la solicitud a la región correcta. Si un usuario se conecta con una dirección IP diferente o en una sesión diferente, la solicitud se vuelve a dirigir a la región más cercana.
kndct_orgid_identity
34128000 (395 días)
Almacena el ECID, así como otra información relacionada con el ECID.
kndctr_orgid_consent
15552000 (180 días)
Almacena la preferencia de consentimiento de los usuarios para el sitio web.
s_ecid
63115200 (2 años)
Contiene una copia del Experience Cloud ID (ECID) o MID. El MID se almacena en un par de clave-valor que sigue esta sintaxis, s_ecid=MCMID|<ECID>.

Ejecute el comando setConsent al llamar a la instancia configurada de Web SDK. Puede incluir los siguientes objetos en este comando:

  • consent[]: una matriz de consent objetos. El objeto de consentimiento tiene un formato diferente en función del estándar y la versión que elija. Consulte las pestañas siguientes para ver ejemplos de cada objeto de consentimiento, según el estándar de consentimiento.
  • identityMap: un objeto que controla cómo se genera un ECID y a qué ID está asociada la información de consentimiento. Adobe recomienda incluir este objeto cuando setConsent se ejecute antes que otros comandos, como sendEvent.
  • edgeConfigOverrides: un objeto que contiene anulaciones de configuración de secuencia de datos.
Adobe 2.0

Si envía datos a Adobe Experience Platform, querrá incluir un grupo de campos de esquema de privacidad en el esquema de perfil. Consulte Gobernanza, privacidad y seguridad en Adobe Experience Platform para obtener más información sobre el estándar Adobe 2.0. Puede agregar datos dentro del objeto de valor siguiente correspondiente al esquema del campo consents del grupo de campos de perfil Consents and Preferences.

  • standard: el estándar de consentimiento que elija. Establezca esta propiedad en "Adobe" para el estándar Adobe 2.0.

  • version: cadena que representa la versión del estándar de consentimiento. Establezca esta propiedad en "2.0" para el estándar Adobe 2.0.

  • value: un objeto que contiene valores de consentimiento.

    • value.collect.val: el valor de consentimiento. Establezca esto en "y" cuando los usuarios acepten la inclusión y en "n" cuando los usuarios acepten la exclusión.
    • value.metadata.time: marca de tiempo de la última vez que los usuarios actualizaron su configuración de consentimiento.
code language-js
// Set consent using the Adobe 2.0 standard
alloy("setConsent", {
  "consent": [{
    "standard": "Adobe",
    "version": "2.0",
    "value": {
      "collect": {
        "val": "y"
      },
      "metadata": {
        "time": "YYYY-03-17T15:48:42-07:00"
      }
    }
  }]
});
IAB TCF 2.0

Para registrar las preferencias de consentimiento del usuario proporcionadas mediante el estándar del marco de transparencia y consentimiento (TCF) de Advertising Bureau Europe (IAB) interactivo, establezca la cadena de consentimiento como se muestra a continuación.

Cuando el consentimiento se establece de esta manera, el Perfil del cliente en tiempo real se actualiza con la información de consentimiento. Para que esto funcione, el esquema XDM de perfil debe contener el grupo de campos del esquema de privacidad del perfil. Al enviar eventos, la información de consentimiento de IAB debe añadirse manualmente al objeto XDM de evento. Web SDK no incluye automáticamente la información de consentimiento en los eventos.

Para enviar la información de consentimiento en eventos, debe agregar el grupo de campos Privacidad de Experience Event al esquema Profile habilitado para XDM ExperienceEvent. Consulte la sección sobre actualización del esquema de ExperienceEvent en la guía de preparación de conjuntos de datos para ver los pasos sobre cómo configurarlo.

  • standard: el estándar de consentimiento que elija. Establezca esta propiedad en "IAB TCF" para el estándar IAB TCF 2.0.
  • version: cadena que representa la versión del estándar de consentimiento. Establezca esta propiedad en "2.0" para el estándar IAB TCF 2.0.
  • value: cadena que contiene el valor de consentimiento.
  • gdprApplies: Un booleano que determina si el RGPD se aplica a este valor de consentimiento. Su valor predeterminado es true.
  • gdprContainsPersonalData: un booleano que determina si los datos de evento asociados con este usuario contienen datos personales. Su valor predeterminado es false.
code language-js
// Set consent using the IAB TCF 2.0 standard
alloy("setConsent", {
  consent: [{
    "standard": "IAB TCF",
    "version": "2.0",
    "value": "CO052l-O052l-DGAMBFRACBgAIBAAAAABIYgEawAQEagAAAA",
    "gdprApplies": true,
    "gdprContainsPersonalData": true
  }]
});

La API IAB TCF 2.0 proporciona un evento para el momento en que el cliente actualiza el consentimiento. Esto ocurre cuando el cliente establece inicialmente sus preferencias y cuando el cliente actualiza sus preferencias. Puede agregar un detector de eventos para ejecutar el comando setConsent:

code language-js
const identityMap = { ... };
window.__tcfapi('addEventListener', 2, function (tcData, success) {
  if (success && tcData.eventStatus === 'useractioncomplete') {
    window.alloy("setConsent", {
      identityMap,
      consent: [
        {
          standard: "IAB TCF",
          version: "2.0",
          value: tcData.tcString,
          gdprApplies: tcData.gdprApplies
        }
      ]
    });
  }
});

El bloque de código anterior escucha el evento useractioncomplete y, a continuación, establece el consentimiento, pasando la cadena de consentimiento y la marca gdprApplies. Si tiene identidades personalizadas para sus clientes, asegúrese de rellenar la variable identityMap.

Adobe 1.0
  • standard: el estándar de consentimiento que elija. Establezca esta propiedad en "Adobe" para el estándar Adobe 1.0.
  • version: cadena que representa la versión del estándar de consentimiento. Establezca esta propiedad en "1.0" para el estándar Adobe 1.0.
  • value.general: el valor de consentimiento. Establezca esto en "in" cuando los usuarios acepten la inclusión y en "out" cuando los usuarios acepten la exclusión.
code language-js
// Set consent using the Adobe 1.0 standard
alloy("setConsent", {
  "consent": [{
    "standard": "Adobe",
    "version": "1.0",
    "value": {
      "general": "in"
    }
  }]
});

Envío de varios estándares en una solicitud multiple-standards

Web SDK también admite el envío de más de un objeto de consentimiento en una solicitud, como se muestra en el ejemplo siguiente.

alloy("setConsent", {
    consent: [{
        standard: "Adobe",
        version: "2.0",
        value: {
            collect: {
                val: "y"
            },
            metadata: {
                time: "YYYY-03-17T15:48:42-07:00"
            }
        }
    }, {
        standard: "IAB TCF",
        version: "2.0",
        value: "CO1Z4yuO1Z4yuAcABBENArCsAP_AAH_AACiQGCNX_T5eb2vj-3Zdt_tkaYwf55y3o-wzhhaIse8NwIeH7BoGP2MwvBX4JiQCGBAkkiKBAQdtHGhcCQABgIhRiTKMYk2MjzNKJLJAilsbe0NYCD9mnsHT3ZCY70--u__7P3fAwQgkwVLwCRIWwgJJs0ohTABCOICpBwCUEIQEClhoACAnYFAR6gAAAIDAACAAAAEEEBAIABAAAkIgAAAEBAKACIBAACAEaAhAARIEAsAJEgCAAVA0JACKIIQBCDgwCjlACAoAAAAA.YAAAAAAAAAAA",
        gdprApplies: true
    }]
});

Persistencia de las preferencias de consentimiento persistence

Una vez que haya comunicado las preferencias de usuario a Web SDK mediante el comando setConsent, SDK conserva las preferencias de usuario respecto a una cookie. La próxima vez que el usuario cargue el sitio web en el explorador, Web SDK recuperará y utilizará estas preferencias persistentes para determinar si se pueden enviar o no eventos a Adobe.

Almacena las preferencias del usuario de forma independiente para que pueda mostrar el cuadro de diálogo de consentimiento con las preferencias actuales. No hay forma de recuperar las preferencias de usuario de Web SDK. Para asegurarse de que las preferencias del usuario permanecen sincronizadas con SDK, puede llamar al comando setConsent en cada carga de página. Web SDK solo realiza una llamada al servidor si cambian las preferencias.

Definición del consentimiento mediante la extensión de etiqueta Web SDK

La extensión de etiquetas Web SDK equivalente a este comando es la acción Set consent.

recommendation-more-help
1ae86b30-e55e-49c1-ab11-9d0356a5f3e1