Cómo configurar el registro de consentimiento

El Registro de Consentimiento (Consent DB) registra cada evento de consentimiento de sus usuarios, permitiéndole consultar y auditar registros de consentimiento por UUID o identidad de usuario. Esta guía le explica cómo habilitar y utilizar esta funcionalidad.

Requisitos previos

• Consent DB debe ser habilitado para su cuenta por UniConsent. Contacte a support@uniconsent.com para habilitarlo.
• Debe estar en un plan Enterprise.

Paso 1: Habilitar Consent DB para su proyecto

1. Vaya a la configuración de su proyecto en el panel de UniConsent
2. Desplácese hasta la sección Consent Logging
3. Active Enable Consent Logging
4. Haga clic en Save y luego Publish para aplicar los cambios

Una vez publicado, el CMP comenzará automáticamente a enviar eventos de consentimiento al Consent DB.

Paso 2: Vincular identidades de usuario (Opcional)

Para asociar registros de consentimiento con sus usuarios (por ejemplo, después del inicio de sesión), agregue el siguiente código a su página:

<script>
window._unicData = window._unicData || [];
_unicData.push({
    user_ids: {
        auth_uid: 'your_user_id'
    }
});
</script>

Este código puede colocarse en cualquier parte de la página, antes o después de que se cargue el script del CMP. El CMP recogerá los IDs de usuario y los incluirá en los eventos de consentimiento.

Puede incluir múltiples tipos de identidad:

_unicData.push({
    user_ids: {
        auth_uid: 'user_12345',
        email_hash: 'sha256_hash_of_email',
        customer_id: 'CUST-9876'
    }
});

Paso 3: Ver los registros de consentimiento en el panel

1. En la barra lateral, haga clic en Consent Data > Consent Logs
2. En la parte superior, verá métricas clave:
   • Consent Records (30d) — Total de eventos de consentimiento en los últimos 30 días
   • Unique IDs — Total de UUIDs únicos de todos los tiempos
3. Use la sección Search para consultar registros:
   • By UUID — Ingrese un UUID de consentimiento para encontrar todos los registros de ese dispositivo
   • By ID Type + Value — Seleccione un tipo de ID (por ejemplo, auth_uid) e ingrese el valor para encontrar registros entre dispositivos

Tipos de registro

Cada registro indica lo que contiene:

Las cadenas GPP se registran completas, con la cabecera GPP, para que cualquier decodificador GPP pueda leerlas.

Paso 4: Agregar tipos de ID personalizados (Opcional)

Si utiliza tipos de identidad más allá de los predeterminados del sistema, puede agregar personalizados:

1. En la página de Consent Logs, haga clic en el icono de engranaje en el encabezado de la sección Search
2. En el área de Custom ID Types, ingrese el nombre de su tipo personalizado (por ejemplo, loyalty_id)
3. Haga clic en Add

Los tipos de ID personalizados aparecerán en el menú desplegable de búsqueda junto con los predeterminados del sistema.

Ejemplo: Integración completa

<!-- UniConsent CMP tag (async) -->
<script async src='https://cmp.uniconsent.com/v2/YOUR_PROJECT_ID/cmp.js'></script>

<!-- Set user identity (works before CMP loads) -->
<script>
window._unicData = window._unicData || [];

// After user login, push their identity
function onUserLogin(userId, emailHash) {
    _unicData.push({
        user_ids: {
            auth_uid: userId,
            email_hash: emailHash
        }
    });
}
</script>

Cómo funciona

1. El script del CMP se carga y lee la configuración del proyecto con enable_consentdb habilitado
2. Los IDs de usuario establecidos mediante _unicData.push() son recogidos
3. Cuando el usuario otorga o actualiza el consentimiento, el evento de consentimiento se envía al Consent DB junto con los IDs de usuario
4. El evento se almacena en ClickHouse y queda disponible para consultas en el panel

¿Tiene más preguntas?

Contáctenos: support@uniconsent.com