Esta guía muestra cómo integrar el marco de transparencia y consentimiento de la agencia de publicidad interactiva, versión 2.0 (IAB TCF 2.0) con el SDK web de Adobe Experience Platform sin utilizar etiquetas. Para obtener una descripción general de la integración con IAB TCF 2.0, lea la descripción general. Para obtener una guía sobre cómo integrar con etiquetas, lea la guía TCF de IAB 2.0 para etiquetas.
Esta guía utiliza la interfaz __tcfapi
para acceder a la información de consentimiento. Puede que le resulte más fácil integrarlo directamente con su proveedor de administración de la nube (CMP). Sin embargo, la información de esta guía puede seguir siendo útil porque las CMP generalmente proporcionan una funcionalidad similar a la API de TCF.
Estos ejemplos suponen que para el momento en que se ejecuta el código, window.__tcfapi
se define en la página. Las CMP pueden proporcionar un enlace en el que se pueden ejecutar estas funciones cuando el objeto __tcfapi
está listo.
Para utilizar IAB TCF 2.0 con etiquetas y la extensión Adobe Experience Platform Web SDK, debe tener disponible un esquema XDM. Si no ha configurado ninguno de estos elementos, comience por ver esta página antes de continuar.
Además, esta guía requiere que conozca bien el SDK web de Adobe Experience Platform. Para obtener una actualización rápida, lea la información general del SDK web de Adobe Experience Platform y la documentación de las preguntas más frecuentes.
Si desea tratar a todos los usuarios desconocidos de la misma manera, puede establecer el consentimiento predeterminado en pending
o out
. Esto coloca en cola o descarta los eventos de experiencia hasta que se reciben las preferencias de consentimiento.
Para obtener más información sobre el consentimiento predeterminado, consulte la sección de consentimiento predeterminado en la documentación de configuración del SDK web de Platform.
gdprApplies
Algunas CMP permiten determinar si el Reglamento General de Protección de Datos (RGPD) se aplica al cliente. Si desea asumir el consentimiento para los clientes a los que no se aplica el RGPD, puede utilizar el indicador gdprApplies
en la llamada a la API de TCF.
El siguiente ejemplo muestra una forma de hacerlo:
var alloyConfiguration = { ... };
window.__tcfapi('getTCData', 2, function (tcData, success) {
if (success) {
alloyConfiguration.defaultConsent = tcData.gdprApplies ? "pending" : "in";
window.alloy("configure", alloyConfiguration);
}
});
En este ejemplo, se llama al comando configure
después de obtener el tcData
de la API de TCF. Si gdprApplies
es verdadero, el consentimiento predeterminado se establece en pending
. Si gdprApplies
es false, el consentimiento predeterminado se establece en in
. Asegúrese de rellenar la variable alloyConfiguration
con la configuración.
Cuando el consentimiento predeterminado se establece en in
, el comando setConsent
puede seguir utilizándose para registrar las preferencias de consentimiento de los clientes.
La API TCF 2.0 de IAB proporciona un evento para cuándo el cliente actualiza el consentimiento. Esto ocurre cuando el cliente establece inicialmente sus preferencias y cuando actualiza sus preferencias.
El siguiente ejemplo muestra una forma de hacerlo:
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
}
]
});
}
});
Este bloque de código escucha el evento useractioncomplete
y luego establece el consentimiento, pasando la cadena de consentimiento y el indicador gdprApplies
. Si tiene identidades personalizadas para sus clientes, asegúrese de rellenar la variable identityMap
. Consulte la guía de compatibilidad con consentimiento para obtener más información sobre cómo llamar a setConsent
.
Dentro de los esquemas XDM, puede almacenar información de preferencias de consentimiento de Experience Events. Existen dos maneras de agregar esta información a cada evento.
En primer lugar, puede proporcionar el esquema XDM relevante en cada llamada sendEvent
. El siguiente ejemplo muestra una forma de hacerlo:
var sendEventOptions = { ... };
window.__tcfapi('getTCData', 2, function (tcData, success) {
if (success) {
sendEventOptions.xdm.consentStrings = [{
consentStandard: "IAB TCF"
consentStandardVersion: "2.0"
consentStringValue: tcData.tcString,
gdprApplies: tcData.gdprApplies
}];
window.alloy("sendEvent", sendEventOptions);
}
});
En este ejemplo se obtiene la información de consentimiento para la API de TCF y, a continuación, se envía un evento con la información de consentimiento agregada al esquema XDM. Consulte la guía tracking events para comprender qué debe haber en las opciones del comando sendEvent
.
La otra forma de agregar la información de consentimiento a cada solicitud es con la llamada de retorno onBeforeEventSend
. Lea la sección sobre modificación global de eventos desde la documentación de seguimiento de eventos para obtener más información sobre cómo hacerlo.
Ahora que ha aprendido a utilizar IAB TCF 2.0 con la extensión web SDK de Platform, también puede optar por integrar con otras soluciones de Adobe, como Adobe Analytics o la plataforma de datos del cliente en tiempo real. Consulte la información general de Transparencia y consentimiento de IAB Framework 2.0 para obtener más información.