Come configurare il Consent Logging

Il Consent Logging (Consent DB) registra ogni evento di consenso dei tuoi utenti, consentendoti di interrogare e verificare i record di consenso per UUID o per identità dell'utente. Questa guida ti accompagna nell'abilitazione e nell'uso della funzionalità.

Prerequisiti

• Il Consent Audit Trail deve essere abilitato per il tuo account. È incluso nel piano Pro oppure disponibile come componente aggiuntivo per i piani Basic e Value.
• Abilitalo dalla dashboard in Account > Add-ons, oppure contatta support@uniconsent.com.

Passaggio 1: abilita il Consent DB per il tuo progetto

1. Vai alle impostazioni del progetto nella dashboard di UniConsent
2. Scorri fino alla sezione Consent Logging
3. Attiva l'interruttore Enable Consent Logging
4. Fai clic su Save e poi su Publish per pubblicare le modifiche

Una volta pubblicate le modifiche, la CMP inizierà automaticamente a inviare gli eventi di consenso al Consent DB.

Passaggio 2: collega le identità degli utenti (facoltativo)

Per associare i record di consenso ai tuoi utenti (ad es. dopo il login), aggiungi il seguente codice alla pagina:

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

Questo codice può essere inserito in qualsiasi punto della pagina, prima o dopo il caricamento dello script della CMP. La CMP rileverà gli ID utente e li includerà negli eventi di consenso.

Puoi includere più tipi di identità:

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

Passaggio 3: visualizza i log del consenso nella dashboard

1. Nella barra laterale, fai clic su Consent Data > Consent Logs
2. In alto vedrai le metriche principali:
   • Consent Records (30d): eventi di consenso totali negli ultimi 30 giorni
   • Unique IDs: UUID univoci totali di sempre
3. Usa la sezione Search per interrogare i log:
   • Per UUID: inserisci un UUID di consenso per trovare tutti i record di quel dispositivo
   • Per tipo di ID + valore: seleziona un tipo di ID (ad es. auth_uid) e inserisci il valore per trovare i record su tutti i dispositivi

Tipi di record

Ogni record indica cosa contiene:

Le stringhe GPP vengono registrate per intero, con l'intestazione GPP, così qualsiasi decoder GPP può leggerle.

Passaggio 4: aggiungi tipi di ID personalizzati (facoltativo)

Se usi tipi di identità diversi da quelli predefiniti del sistema, puoi aggiungerne di personalizzati:

1. Nella pagina Consent Logs, fai clic sull'icona a forma di ingranaggio nell'intestazione della sezione Search
2. Nell'area Custom ID Types, inserisci il nome del tipo personalizzato (ad es. loyalty_id)
3. Fai clic su Add

I tipi di ID personalizzati compariranno nel menu a tendina di ricerca insieme a quelli predefiniti del sistema.

Esempio: integrazione 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>

Come funziona

1. Lo script della CMP si carica e legge la configurazione del progetto con enable_consentdb abilitato
2. Vengono rilevati tutti gli ID utente impostati tramite _unicData.push()
3. Quando l'utente fornisce o aggiorna il consenso, l'evento di consenso viene inviato al Consent DB insieme agli ID utente
4. L'evento viene memorizzato in ClickHouse e diventa interrogabile nella dashboard

Hai ancora domande?

Contattaci: support@uniconsent.com