Puedes utilizar el SDK de JavaScript del punto de recopilación para asignar tu formulario web a la gestión de preferencias y consentimientos universales de OneTrust y aprobar preferencias para objetivos de tratamiento, temas, preferencias personalizadas y elementos de datos. La implementación del SDK de JavaScript es el método más simple para recopilar registros de consentimiento a través de un punto de recopilación de formularios web y proporciona un medio rápido para implementar los puntos de recopilación de OneTrust. Para obtener más información sobre la asignación de un formulario web existente, consulta Asignación de atributos de campo para un formulario web existente.
Nota
Para generar registros de consentimiento, debes integrar nuestro código en tus formularios web u otras aplicaciones de puntos de recopilación. Existen dos métodos para la integración: un SDK de JavaScript y una API REST del lado del servidor. El SDK de JavaScript solo está disponible para los puntos de recopilación de formularios web. Para obtener más información sobre el método alternativo, consulta Implementación del punto de recopilación con API de REST.
Descripción general del SDK de JavaScript
El SDK de JavaScript del punto de recopilación es la manera más sencilla de integrar los puntos de recopilación de OneTrust en tus interfaces existentes. La finalidad del SDK es proporcionar la funcionalidad principal con cambios mínimos en las interfaces de formulario web existentes. El SDK se debe colocar en la misma página que el formulario web que recopila el consentimiento. De manera opcional, también puedes colocar el SDK en cualquier página a la que se dirijan los interesados una vez que hayan enviado el formulario web.
Integración del SDK de JavaScript
Puedes utilizar el SDK de JavaScript del punto de recopilación para asignar tu formulario web a la gestión de preferencias y consentimientos universales de OneTrust y aprobar preferencias para objetivos de tratamiento, temas, preferencias personalizadas y elementos de datos.
Integrar mediante el nuevo método de integración
Puedes utilizar la opción New SDK Integration (Nueva integración del SDK) en la pantalla Collection Point Details (Detalles del punto de recopilación) para simplificar la integración del SDK alojado para los puntos de recopilación de formularios web.
-
En el menú , selecciona . Aparecerá la pantalla Collection Points (Puntos de recopilación).
-
Haz clic en el enlace de la columna Name (Nombre) para el punto de recopilación que quieras integrar. Aparecerá la pantalla Collection Point Details (Detalles del punto de recopilación).
-
Dirígete a la pestaña SDK. Aparecerá la pantalla SDK Integration (Integración del SDK).
-
Haz clic en el botón SDK.
-
Habilita la opción New SDK Integration (Nueva integración del SDK). La sección SDK Integration (Integración del SDK) se actualizará con las instrucciones para la integración del SDK alojado actualizado.
-
Coloca el SDK en la etiqueta <head> de la página web que contenga un punto de recopilación.
-
Haz clic en el botón Copy (Copiar) correspondiente al Paso 1.
-
Pega el código copiado dentro de una etiqueta <head> de la página web que contenga un punto de recopilación.
-
Coloca el atributo data-ot-cp-id en los formularios que funcionarán como punto de recopilación.
-
Haz clic en el botón Copy (Copiar) correspondiente a la versión Draft (Borrador) o Production (Producción) del punto de recopilación en el Paso 2.
-
Agrega el atributo data-ot-cp-id con el ID del punto de recopilación deseado a una etiqueta <form>.
Integrar mediante el método heredado
-
En el menú , selecciona . Aparecerá la pantalla Collection Points (Puntos de recopilación).
-
Haz clic en el enlace de la columna Name (Nombre) para el punto de recopilación que quieras integrar. Aparecerá la pantalla Collection Point Details (Detalles del punto de recopilación).
-
Dirígete a la pestaña SDK. Aparecerá la pantalla SDK Integration (Integración del SDK).
-
Haz clic en el botón SDK.
-
Haz clic en el botón Copy SDK (Copiar SDK) y pega el SDK copiado en la página de solicitud de formulario web existente.
-
Configure el SDK para que pueda identificar los campos para el botón de envío y la casilla de verificación del activador condicional (si se utiliza).
-
Al activar una transacción con el SDK, el servicio también devuelve un número de transacción único a la página web en forma de nombre de variable receiptID de JavaScript.
-
Puede configurar el SDK para que coloque esta variable en un elemento DOM de la página mediante la identificación del nombre del elemento en JavaScript.
-
Debido a que el ID se genera antes de que se finalice el proceso de envío del formulario normal, puede pasarlo a través de un campo de formulario oculto para almacenar el receiptID junto con tus propios registros. Esto te permite encontrar el registro de la transacción original en OneTrust y recuperar la información adicional almacenada allí.
Información adicional y ejemplos
Configuración local frente a configuración alojada
El SDK se puede implementar mediante una de las siguientes opciones: Configuración local del SDK o configuración alojada del SDK.
-
Local SDK Settings (Configuración local del SDK): esta opción incluye las asignaciones de integración como JavaScript sin codificar que se puede modificar con facilidad para asignar a tu formulario existente una vez copiado.
-
Hosted SDK Settings (Configuración alojada del SDK): esta opción combina la configuración del token de autenticación y del SDK en un archivo publicado al que se accede mediante una URL en el script de la configuración del SDK. La opción Use Hosted SDK Settings (Usar la configuración alojada del SDK) para puntos de recopilación está activada de forma predeterminada.
La ventaja de utilizar la opción Hosted SDK Settings (Configuración hospedada del SDK) es que los cambios realizados en los puntos de recopilación se publican de forma automática en el script de la configuración, incluidas las actualizaciones para nuevas versiones de objetivos. Al usar configuraciones de SDK hospedadas, puedes actualizar la configuración de tu punto de recopilación sin necesidad de reemplazar el SDK integrado en tu sitio. Se hará referencia a la configuración en el SDK mediante una dirección URL al almacenamiento externo.
Componentes clave del SDK de JavaScript
El punto de recopilación de formulario web en OneTrust genera el código de integración de SDK de forma dinámica en función de la cantidad de objetivos en el punto de recopilación, el tipo de interacción de consentimiento, los idiomas definidos en el punto de recopilación y la configuración hospedada del SDK.
Los siguientes son componentes clave:
-
Un enlace a la ubicación del archivo JavaScript donde se aloja la funcionalidad principal del SDK.
-
Un token de autenticación de JWT utilizado para verificar la solicitud y garantizar la integridad de los registros de la transacción. El token se actualiza cada vez que se guarda o publica una nueva versión del punto de recopilación.
-
Cadena de configuración codificada de Base-64 que contiene la URL a la que llamar cuando se crean transacciones.
-
Controles de activación personalizables
-
Parámetros de configuración adicionales sin codificar
Nota
Solo estos dos últimos componentes se deben cambiar de forma local durante la implementación.
Muestra del SDK e instrucciones
