Implementación de scripts de Consentimiento de cookies
UUID-7478d3b4-18eb-3ac0-a6fd-fb7ebff9f8dc
Article Content
Las etiquetas de script de prueba y producción son los fragmentos de código que utilizas para implementar el aviso y el centro de preferencias configurado en Consentimiento de cookies en tu sitio web. Una vez que la etiqueta se implemente en el sitio y se vuelva a publicar en la aplicación, cualquier cambio en la plantilla, las reglas de geolocalización o las categorizaciones asociadas se enviará automáticamente a tu sitio.
CDN de prueba y producción
La CDN de prueba o la CDN de producción se deben implementar lo más cerca posible de la parte superior de la sección <head> del HTML del sitio en todas las páginas. Las CDN contienen un identificador único que es específico del dominio para el que se generó. Esto se encuentra en el data-domain-script. La CDN de prueba puede tener la extensión "-test".
El script debe cargarse en cada página del dominio para asegurar que los visitantes del sitio encuentran inmediatamente el aviso y el centro de preferencias si todavía no han dado su consentimiento. Una vez que el usuario haya dado su consentimiento o haya interactuado con el aviso o el centro de preferencias, se incluirá una cookie en la página para evitar que el aviso vuelva a aparecer en las páginas siguientes para el usuario.
Si usas un generador de sitios o un sistema de gestión de contenido (CMS, en inglés) para gestionar tus dominios, podrás personalizarlo en tu plantilla o mediante la función de inyector de código.
Atención
El script debe colocarse antes que cualquier otro script en tu sitio para garantizar que el aviso se cargue antes de que se cargue cualquier otro script o se configuren las cookies. Esto permite que la etiqueta de script comunique las preferencias de consentimiento del visitante del sitio de forma descendente.
Sugerencia
Puedes definir códigos de idioma mediante guiones bajos o guiones.
Ejemplo: es-ES o es_ES.
La CDN de prueba coincide con el script de la CDN de producción, excepto:
No hay caché, lo que significa que los cambios se pueden ver inmediatamente tras volver a publicarla.
Este script funcionará en cualquier sitio de prueba que sea o no un subdominio del dominio escaneado dentro de la aplicación, y debe utilizarse con fines de prueba.
Nota
Cuando se crea una cookie, se hace en un dominio específico, como .ejemplo.com o www.ejemplo-provisional.com.
Una cookie creada en .ejemplo.com se envía en cualquier solicitud para el dominio raíz.
Sin embargo, si te encuentras en un dominio diferente, como www.ejemplo-provisional.com, no puedes crear una cookie en .ejemplo.com. Cualquier dominio con www. se considera un subdominio de un dominio más grande.
El script de CDN de prueba crea cookies en el dominio en el que se encuentra actualmente, lo que le permite comportarse como el script de CDN de producción en un entorno de prueba. La CDN de producción es específica para el dominio analizado dentro de la aplicación.
Aviso
Si tu dominio y el script no son iguales, el script no funcionará correctamente y el aviso seguirá apareciendo continuamente.
Si tu sitio provisional/de prueba es un dominio diferente al del script, debes utilizar el script de prueba para que las pruebas funcionen correctamente.
El script de CDN de producción hace referencia a un SDK alojado por OneTrust. Si deseas alojar el SDK en tus propios servidores, puedes descargar el SDK completo y alojarlo localmente.
Visualización del registro de cambios
Al publicar un script, la primera pantalla será el registro de cambios. Esta pantalla mostrará los cambios principales en el script que se publicará y cualquier función que no sea compatible con la versión del script que estás intentando publicar.
Implementación del script CDN de prueba
En el menú Consentimiento de cookies, selecciona Scripts. Aparecerá la pantalla Scripts.
Selecciona el dominio donde se implementará el aviso de cookies.
Haz clic en el botón Publicar la prueba. Aparecerá el panel Sitio web de prueba.
Selecciona una versión para publicar y revisa las funciones incompatibles. Haz clic en Confirmar.
Haz clic en el botón Copiar Scripts) del script de CDN de prueba.
Pega el script copiado en la sección <head> del entorno de prueba. El script debe colocarse antes que cualquier otro script en la sección <head>.
Referencia de la pantalla CDN de prueba
Campo
Descripción
Escoge una versión de script para publicar
Selecciona la versión del script que deseas publicar. De forma predeterminada, será la versión más reciente.
Esta configuración permite publicar la configuración en una versión anterior de OneTrust.
Cuando publiques un script en una versión anterior a la versión actual de OneTrust de tu entorno de OneTrust (por ejemplo, OneTrust está actualmente en la versión 6.7, pero deseas publicar tu script en la versión 6.6), no podrás utilizar ninguna de las nuevas funciones o correcciones de errores que se lanzaron con la versión más reciente de OneTrust (en la situación anterior, cualquier función publicada en la versión 6.7).
Si seleccionas una versión anterior, habrá una lista de funciones que no son compatibles con la versión de publicación seleccionada. Estas funciones aún podrán configurarse en la herramienta de gestión, pero el script no podrá utilizarlas si se publica en una versión anterior.
Nota
Se mostrará la fecha de finalización del soporte para la versión seleccionada.
Publicar idiomas individuales
Activa este ajuste para publicar el script para un idioma o idiomas específicos. Si no está activado, se publicarán todos los idiomas. De forma predeterminada, está desactivado.
Nota
Si la detección de idioma no está activada para el script, tendrás que publicar los idiomas individualmente.
Si el script se publicó anteriormente para todos los idiomas existentes en las plantillas, estos idiomas seguirán existiendo cuando se cargue el script. Solo se publicarán los cambios aplicados a los idiomas seleccionados.
¿Requiere que los usuarios vuelvan a consentir?
Habilitar este ajuste requerirá que los usuarios del sitio web vuelvan a dar su consentimiento. Esto hará que caduque la cookie OptanonAlertBoxClosed y agregará un valor de AwaitingReconsent=true a la cookie OptanonConsent. El valor previo de consentimiento de los usuarios seguirá estando presente tras el nuevo consentimiento, por lo que los valores de la categoría de cookies no se restablecerán según la configuración predeterminada. Cuando los archivos de script se cargan con la nueva configuración (no se cargan desde la caché), el aviso volverá a presentarse si está configurado como tal para la regla de geolocalización.
Evitar la obtención del aviso
Si la opción Evitar la obtención del aviso o Evitar la opción del Centro de preferencias está activada, al cargar tu página, no se cargará el HTML ni el CSS. Estos elementos solo aparecerán cuando el visitante del sitio tome una acción explícita para que aparezcan. Esto se utiliza para ayudar a optimizar el rendimiento del sitio.
Evitar la obtención del Centro de preferencias
Cuando está activada, la plantilla HTML y CSS del centro de preferencias solo se cargará cuando sea necesario.
Habilitar el bloqueo automático de cookies
Este ajuste activará la función de bloqueo automático de OneTrust. Las cookies se bloquearán automáticamente o se podrán colocar según el modelo de consentimiento configurado y, luego, cuando el usuario proporcione su consentimiento o interactúe, se bloquearán o se podrán colocar según corresponda. Asegúrate de leer OneTrust Cookie Auto-Blocking™ si deseas activar esta función.
Habilitar esta función agrega un script adicional a la CDN, por lo que si ya la has implementado, asegúrate de incluir el script adicional en tu página. El script se encontrará en el mismo lugar en la CDN.
Bloqueo automático de tecnologías de seguimiento conocidas
Si se habilita se bloquearán las cookies, los píxeles y las balizas web conocidas para el seguimiento automático.
De forma predeterminada, esta función se habilitará y se configurará como "Determinar el idioma en los ajustes del navegador del visitante". Esto significa que el usuario verá el aviso y el centro de preferencias en el idioma que configuró para su navegador si el idioma está configurado en tu plantilla.
Si decides cambiar la configuración a "Determinar el idioma en la página HTML", el idioma se controlará por el idioma indicado en el código HTML. El código de idioma del HTML debe coincidir con el código de idioma de la plantilla.
Por ejemplo, si tienes un sitio en alemán donde quieres mostrar el aviso de cookies a los usuarios en alemán y hacerlo según el idioma indicado en el código HTML. El código de idioma para alemán en mi plantilla de OneTrust es "de". Esto se puede ver en Gestionar idiomas. El idioma indicado en el código HTML también tendría que ser "de".
<html lang="de">
Al seleccionar esta configuración se agrega data-document-language="true" al script. Si ya has implementado el script y decides cambiar esta configuración, deberás agregarla al script. Esto se reflejará en la CDN después de la configuración.
Implementación del script de CDN de producción
Importante
[en] Production scripts can only be published within 30 minutes of publishing test scripts. You must first publish you test script to publish your production script.
Utiliza este script para tu sitio web de producción. Los cambios publicados para este script tardan hasta 4 horas en almacenarse en caché. Puedes evitar este retraso con el botón Habilitar la prevención del almacenamiento en memoria caché.
Nota
Para evitar que los eventos se envíen a Google Analytics, agrega el siguiente atributo al script del aviso de cookies.
data-ignore-ga='true'
En el menú Consentimiento de cookies, selecciona Scripts. Aparecerá la pantalla Scripts.
Selecciona el dominio donde se implementará el script.
Haz clic en el botón Publicar la producción. Aparecerá el panel Publicar.
Selecciona la versión del script que quieres publicar y revisa las funciones incompatibles.
Nota
Se mostrará la fecha de finalización del soporte para la versión seleccionada.
Haz clic en el botón Confirmar.
Personaliza la configuración del script de CDN de producción. Si deseas alojar el script localmente, puedes hacer clic en Descargar para descargar el script y ejecutarlo localmente. Consulta Referencia de la pantalla CDN de producción.
Navega a la pestaña Scripts de producción.
Pega el script copiado en la sección <head> del sitio. El script debe colocarse antes que cualquier otro script en la sección <head>.
Haz clic en el botón Publicar para publicar la configuración.
Botón de configuración de cookies
El botón de configuración de cookies es una forma de permitir que los usuarios del sitio web vuelvan a ver el centro de preferencias y cambien su consentimiento. El texto del botón puede definirse en la plantilla. El script de CDN de producción también debe incluirse en la página.
En el menú Consentimiento de cookies, selecciona Scripts. Aparecerá la pantalla Scripts.
Haz clic en el nombre del dominio que quieres implementar. Aparecerá la pantalla Detalles de los scripts.
Navega a la pestaña Scripts de producción o Scripts de prueba.
Haz clic en el botón Copiar Script para el script del botón de configuración de cookies.
Pega el script copiado en el código del sitio. El botón de configuración de cookies hace referencia al script que se ha colocado en la sección <head> del sitio.
Lista de cookies
Este fragmento insertará una lista detallada de cookies, incluida la descripción y la tabla de cookies según la categorización actual de cookies. Puedes incrustar el script en una política de privacidad o en una página de lista de cookies independiente. El script de CDN de producción también debe incluirse en la página.
En el menú Consentimiento de cookies, selecciona Scripts. Aparecerá la pantalla Scripts.
Haz clic en el nombre del dominio que quieres implementar. Aparecerá la pantalla Detalles de los scripts.
Navega a la pestaña Scripts de producción o Scripts de prueba.
Haz clic en el botón Copiar Script para copiar el script de la lista de cookies.
Pega el script copiado en el código de la página donde se mostrará la lista. La lista de cookies hace referencia al script que se ha aplicado en la sección <head> del sitio.
Referencia de la pantalla CDN de producción
Campo
Descripción
Escoge una versión de script para publicar
Selecciona la versión del script que deseas publicar. De forma predeterminada, será la versión más reciente.
Esta configuración permite publicar la configuración en una versión anterior de OneTrust.
Cuando publiques un script en una versión anterior a la versión actual de OneTrust de tu entorno de OneTrust (por ejemplo, OneTrust está actualmente en la versión 6.7, pero deseas publicar tu script en la versión 6.6), no podrás utilizar ninguna de las nuevas funciones o correcciones de errores que se lanzaron con la versión más reciente de OneTrust (en la situación anterior, cualquier función publicada en la versión 6.7).
Si seleccionas una versión anterior, habrá una lista de funciones que no son compatibles con la versión de publicación seleccionada. Estas funciones aún podrán configurarse en la herramienta de gestión, pero el script no podrá utilizarlas si se publica en una versión anterior.
Nota
Se mostrará la fecha de finalización del soporte para la versión seleccionada.
Publicar idiomas individuales
Activa este ajuste para publicar el script para un idioma o idiomas específicos. Si no está activado, se publicarán todos los idiomas. De forma predeterminada, está desactivado.
Nota
Si la detección de idioma no está activada para el script, tendrás que publicar los idiomas individualmente.
¿Requiere que los usuarios vuelvan a consentir?
Habilitar este ajuste requerirá que los usuarios del sitio web vuelvan a dar su consentimiento. Esto hará que caduque la cookie OptanonAlertBoxClosed y agregará un valor de AwaitingReconsent=true a la cookie OptanonConsent. El valor previo de consentimiento de los usuarios seguirá estando presente tras el nuevo consentimiento, por lo que los valores de la categoría de cookies no se restablecerán según la configuración predeterminada. Cuando los archivos de script se cargan con la nueva configuración (no se cargan desde la caché), el aviso volverá a presentarse si está configurado como tal para la regla de geolocalización.
Habilitar la prevención del almacenamiento en memoria caché
Activa esta función para eliminar el retraso entre la publicación del script de producción y la aparición de los cambios en el dominio.
Evitar la obtención del aviso
Si la opción Evitar la obtención del aviso o Evitar la opción del Centro de preferencias está activada, al cargar tu página, no se cargará el HTML ni el CSS. Estos elementos solo aparecerán cuando el visitante del sitio tome una acción explícita para que aparezcan. Esto se utiliza para ayudar a optimizar el rendimiento del sitio.
Evitar la obtención del Centro de preferencias
Cuando está activada, la plantilla HTML y CSS del centro de preferencias solo se cargará cuando sea necesario.
Habilitar el bloqueo automático de cookies
Este ajuste activará la función de bloqueo automático de OneTrust. Las cookies se bloquearán automáticamente o se podrán colocar según el modelo de consentimiento configurado y, luego, cuando el usuario proporcione su consentimiento o interactúe, se bloquearán o se podrán colocar según corresponda. Asegúrate de leer OneTrust Cookie AutoBlocking si quieres activar esta función.
Habilitar esta función agrega un script adicional a la CDN, por lo que si ya la has implementado, asegúrate de incluir el script adicional en tu página. El script se encontrará en el mismo lugar en la CDN.
Bloqueo automático de tecnologías de seguimiento conocidas
Si se habilita se bloquearán las cookies, los píxeles y las balizas web conocidas para el seguimiento automático.
De forma predeterminada, esta función se habilitará y se configurará como "Determinar el idioma en los ajustes del navegador del visitante". Esto significa que el usuario verá el aviso y el centro de preferencias en el idioma que configuró para su navegador si el idioma está configurado en tu plantilla.
Si decides cambiar la configuración a "Determinar el idioma en la página HTML", el idioma se controlará por el idioma indicado en el código HTML. El código de idioma del HTML debe coincidir con el código de idioma de la plantilla.
Por ejemplo, si tienes un sitio en alemán donde quieres mostrar el aviso de cookies a los usuarios en alemán y hacerlo según el idioma indicado en el código HTML. El código de idioma para alemán en mi plantilla de OneTrust es "de". Esto se puede ver en Gestionar idiomas. El idioma indicado en el código HTML también tendría que ser "de".
<html lang="de">
Al seleccionar esta configuración se agrega data-document-language="true" al script. Si ya has implementado el script y decides cambiar esta configuración, deberás agregarla al script. Esto se reflejará en la CDN después de la configuración.