Esta página describe el método Server SDK setConsent. Para Web SDK, consulte setConsent.
El método setConsent indica a Server SDK si puede enviar datos de un visitante (adhesión) o si debe descartarlos (exclusión). SDK envía las preferencias del visitante a Edge Network y, a continuación, almacena el resultado en la cookie kndctr_<orgId>_consent mediante el servicio de cookies que pasa a forRequest.
SDK admite los siguientes estándares de consentimiento:
- Adobe standard: versiones 1.0 y 2.0.
- Marco de transparencia y consentimiento IAB (TCF): Versión 2.0.
Este método está disponible solamente cuando la instancia incluye el componente Consentimiento, que createInstance incluye de manera predeterminada.
Llamar a setConsent para un visitante call
El consentimiento pertenece a un solo visitante, por lo que siempre debe llamar a setConsent en el identificador forRequest de ese visitante, nunca en la instancia de nivel superior. El siguiente ejemplo utiliza el estándar Adobe 2.0:
const visitor = alloy.forRequest({ request: req, cookie: visitorCookies });
await visitor.setConsent({
consent: [{
standard: "Adobe",
version: "2.0",
value: {
collect: { val: "y" }
}
}]
});
El siguiente ejemplo utiliza el estándar Adobe 1.0:
await visitor.setConsent({
consent: [{
standard: "Adobe",
version: "1.0",
value: { general: "in" }
}]
});
El siguiente ejemplo utiliza el estándar IAB TCF 2.0:
await visitor.setConsent({
consent: [{
standard: "IAB TCF",
version: "2.0",
value: "CO052l-O052l-DGAMBFRACBgAIBAAAAAAIYgEawAQEagAAAA",
gdprApplies: true
}]
});
Si utiliza el estándar TCF de IAB y desea datos de consentimiento en el perfil del visitante, incluya también la información de consentimiento de IAB en el objeto de evento xdm. SDK no lo añade automáticamente a los eventos.
Cómo se recuerda el consentimiento stored-consent
SDK lee y escribe la cookie de consentimiento a través del servicio cookie que pasa a forRequest:
- Si el servicio de cookies lee las cookies del explorador del visitante, ya se aplica el consentimiento que el visitante registró anteriormente, en el servidor o en el explorador con Web SDK. No es necesario que vuelva a llamar a
setConsenthasta que cambien las preferencias del visitante. - Si no pasa un servicio de cookies, SDK no puede recordar el consentimiento entre solicitudes. Cada solicitud comienza desde
defaultConsent.
SDK omite la solicitud si ya ha enviado las mismas preferencias para el visitante. Realiza un seguimiento de las preferencias que envió a través del servicio storage, de modo que esta comprobación solo funcionará en todas las solicitudes si pasa el servicio storage de ese visitante a forRequest. De lo contrario, cada llamada a envía una solicitud a Edge Network, aunque las preferencias del visitante no hayan cambiado. Llame a setConsent cuando el visitante realice o cambie una opción de consentimiento, en lugar de hacerlo en cada solicitud.
La solicitud no está autenticada. Asegúrese de que la secuencia de datos acepte solicitudes no autenticadas. Consulte Establecer el tipo de acceso de secuencia de datos.
Opciones options
El método setConsent acepta un objeto con las siguientes propiedades:
consent: obligatorio. Una matriz de objetos de consentimiento, cada uno en uno de los estándares admitidos.identityMap: mapa de identidad del visitante. El Edge Network aplica el consentimiento en el nivel de dispositivo, por lo que solo utiliza elECIDde este mapa.edgeConfigOverrides: un objeto de anulación configuración de secuencia de datos para esta solicitud.
Objeto Result result
El método setConsent devuelve una promesa que se resuelve con un objeto vacío cuando Edge Network acepta las preferencias de consentimiento.