setConsent

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

El SDK web admite los siguientes estándares:

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

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

Usando defaultConsent junto con setConsent using-consent

El SDK web ofrece dos comandos de configuración de consentimiento complementarios:

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.

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

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

La configuración del consentimiento se realiza como una acción dentro de una regla de la interfaz de etiquetas de recopilación de datos de Adobe Experience Platform.

Puede incluir varios objetos de consentimiento dentro de esta acción.

Definir el consentimiento mediante la biblioteca JavaScript del SDK web

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

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

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

// 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

El SDK web 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: "2021-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 al SDK web mediante el comando setConsent, el SDK mantendrá las preferencias de usuario con respecto a una cookie. La próxima vez que el usuario cargue el sitio web en el explorador, el SDK web recuperará y utilizará estas preferencias persistentes para determinar si se pueden enviar o no eventos al Adobe.

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

Sincronización de identidades al establecer el consentimiento sync-identities

Cuando el consentimiento predeterminado (establecido a través del parámetro defaultConsent) se establece en pending o out, la configuración setConsent puede ser la primera solicitud que se emita y establezca la identidad. Debido a esto, puede ser importante sincronizar identidades en la primera solicitud. Puede agregar el mapa de identidad al comando setConsent, como en el comando sendEvent. Consulte usar identityMap para ver un ejemplo de cómo incluir el mapa de identidad en el comando.