Comment configurer la journalisation du consentement

La journalisation du consentement (Consent DB) enregistre chaque événement de consentement de vos utilisateurs, vous permettant d'interroger et d'auditer les enregistrements de consentement par UUID ou identité utilisateur. Ce guide vous accompagne dans l'activation et l'utilisation de cette fonctionnalité.

Prérequis

• Consent DB doit être activé pour votre compte par UniConsent. Contactez support@uniconsent.com pour l'activer.
• Vous devez disposer d'un abonnement Enterprise.

Étape 1 : Activer Consent DB pour votre projet

1. Accédez aux paramètres de votre projet dans le tableau de bord UniConsent
2. Faites défiler jusqu'à la section Consent Logging
3. Activez Enable Consent Logging
4. Cliquez sur Save puis Publish vos modifications

Une fois publié, la CMP commencera automatiquement à envoyer les événements de consentement vers Consent DB.

Étape 2 : Associer les identités utilisateur (optionnel)

Pour associer les enregistrements de consentement à vos utilisateurs (par exemple après connexion), ajoutez le code suivant à votre page :

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

Ce code peut être placé n'importe où sur la page — avant ou après le chargement du script CMP. La CMP récupérera les identifiants utilisateur et les inclura dans les événements de consentement.

Vous pouvez inclure plusieurs types d'identité :

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

Étape 3 : Consulter les logs de consentement dans le tableau de bord

1. Dans la barre latérale, cliquez sur Consent Data > Consent Logs
2. En haut, vous verrez les métriques clés :
   • Consent Records (30d) — Total des événements de consentement des 30 derniers jours
   • Unique IDs — Total des UUID uniques sur l'ensemble de la période
3. Utilisez la section Search pour interroger les logs :
   • By UUID — Saisissez un UUID de consentement pour trouver tous les enregistrements de cet appareil
   • By ID Type + Value — Sélectionnez un type d'identifiant (par ex. auth_uid) et saisissez la valeur pour trouver les enregistrements sur tous les appareils

Types d'enregistrement

Chaque enregistrement indique ce qu'il contient :

Les chaînes GPP sont enregistrées en entier, avec l'en-tête GPP, afin que tout décodeur GPP puisse les lire.

Étape 4 : Ajouter des types d'identifiants personnalisés (optionnel)

Si vous utilisez des types d'identité autres que ceux par défaut du système, vous pouvez en ajouter des personnalisés :

1. Sur la page Consent Logs, cliquez sur l'icône d'engrenage dans l'en-tête de la section Search
2. Dans la zone Custom ID Types, saisissez le nom de votre type personnalisé (par ex. loyalty_id)
3. Cliquez sur Add

Les types d'identifiants personnalisés apparaîtront dans le menu déroulant de recherche aux côtés des types par défaut du système.

Exemple : Intégration complète

<!-- 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>

Comment ça fonctionne

1. Le script CMP se charge et lit la configuration du projet avec enable_consentdb activé
2. Les identifiants utilisateur définis via _unicData.push() sont récupérés
3. Lorsque l'utilisateur donne ou met à jour son consentement, l'événement de consentement est envoyé à Consent DB avec les identifiants utilisateur
4. L'événement est stocké dans ClickHouse et devient interrogeable dans le tableau de bord

Des questions ?

Contactez-nous : support@uniconsent.com