Einwilligungs-Logging einrichten

Das Einwilligungs-Logging (Consent DB) zeichnet jedes Einwilligungsereignis Ihrer Nutzer auf und ermöglicht es Ihnen, Einwilligungsdatensätze nach UUID oder Nutzeridentität abzufragen und zu prüfen. Diese Anleitung führt Sie durch die Aktivierung und Nutzung der Funktion.

Voraussetzungen

• Consent DB muss von UniConsent für Ihr Konto aktiviert werden. Kontaktieren Sie support@uniconsent.com zur Aktivierung.
• Sie müssen einen Enterprise-Tarif nutzen.

Schritt 1: Consent DB für Ihr Projekt aktivieren

1. Gehen Sie zu Ihren Projekteinstellungen im UniConsent-Dashboard
2. Scrollen Sie zum Abschnitt Consent Logging
3. Schalten Sie Enable Consent Logging ein
4. Klicken Sie auf Save und dann auf Publish, um Ihre Änderungen zu veröffentlichen

Nach der Veröffentlichung beginnt die CMP automatisch, Einwilligungsereignisse an die Consent DB zu senden.

Schritt 2: Nutzeridentitäten verknüpfen (Optional)

Um Einwilligungsdatensätze mit Ihren Nutzern zu verknüpfen (z. B. nach der Anmeldung), fügen Sie den folgenden Code auf Ihrer Seite hinzu:

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

Dieser Code kann an beliebiger Stelle auf der Seite platziert werden — vor oder nach dem Laden des CMP-Skripts. Die CMP erfasst die Nutzer-IDs und fügt sie den Einwilligungsereignissen hinzu.

Sie können mehrere Identitätstypen angeben:

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

Schritt 3: Einwilligungs-Logs im Dashboard anzeigen

1. Klicken Sie in der Seitenleiste auf Consent Data > Consent Logs
2. Oben sehen Sie wichtige Kennzahlen:
   • Consent Records (30d) — Gesamtzahl der Einwilligungsereignisse in den letzten 30 Tagen
   • Unique IDs — Gesamtzahl der eindeutigen UUIDs über alle Zeiträume
3. Verwenden Sie den Abschnitt Search, um Logs abzufragen:
   • By UUID — Geben Sie eine Einwilligungs-UUID ein, um alle Datensätze für dieses Gerät zu finden
   • By ID Type + Value — Wählen Sie einen ID-Typ (z. B. auth_uid) und geben Sie den Wert ein, um Datensätze geräteübergreifend zu finden

Eintragstypen

Jeder Eintrag zeigt, was er enthält:

GPP-Strings werden vollständig mit GPP-Header gespeichert, sodass jeder GPP-Decoder sie lesen kann.

Schritt 4: Benutzerdefinierte ID-Typen hinzufügen (Optional)

Wenn Sie Identitätstypen über die Systemstandards hinaus verwenden, können Sie benutzerdefinierte hinzufügen:

1. Klicken Sie auf der Seite Consent Logs auf das Zahnradsymbol in der Kopfzeile des Suchbereichs
2. Geben Sie im Bereich Custom ID Types Ihren benutzerdefinierten Typnamen ein (z. B. loyalty_id)
3. Klicken Sie auf Add

Benutzerdefinierte ID-Typen erscheinen im Such-Dropdown neben den Systemstandards.

Beispiel: Vollständige Integration

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

So funktioniert es

1. Das CMP-Skript wird geladen und liest die Projektkonfiguration mit aktiviertem enable_consentdb
2. Alle über _unicData.push() gesetzten Nutzer-IDs werden erfasst
3. Wenn der Nutzer seine Einwilligung erteilt oder aktualisiert, wird das Einwilligungsereignis zusammen mit den Nutzer-IDs an die Consent DB gesendet
4. Das Ereignis wird in ClickHouse gespeichert und ist im Dashboard abfragbar

Noch Fragen?

Kontaktieren Sie uns: support@uniconsent.com