Consent DB API (nur Enterprise)

Consent DB ermöglicht es Ihnen, Einwilligungsdatensätze in Echtzeit zu protokollieren, zu speichern und abzufragen. Wenn aktiviert, wird jedes Einwilligungsereignis mit der UUID des Nutzers, dem Consent-String, der IP-Adresse und optionalen Identitätszuordnungen erfasst.

Consent DB ist nur für Enterprise-Konten verfügbar. Bitte kontaktieren Sie support@uniconsent.com, um es zu aktivieren.

JavaScript Data Layer API

Die Consent DB verwendet ein Data-Layer-Muster ähnlich dem dataLayer von Google Tag Manager. Sie können jederzeit Daten an window._unicData übermitteln – vor oder nach dem Laden des CMP-Skripts.

Einrichtung

<script>
window._unicData = window._unicData || [];
</script>

Nutzer-IDs festlegen

Verknüpfen Sie Nutzeridentitäten (z. B. nach dem Login) mit der Consent-UUID. Diese IDs werden in alle nachfolgenden Consent-Log-Ereignisse einbezogen.

window._unicData = window._unicData || [];
_unicData.push({
    user_ids: {
        auth_uid: 'user_12345',
        email_hash: 'sha256_of_email'
    }
});

Sie können mehrfach Daten übermitteln – Nutzer-IDs werden zusammengeführt:

_unicData.push({ user_ids: { auth_uid: 'user_12345' } });
_unicData.push({ user_ids: { loyalty_id: 'LY9876' } });
// Result: { auth_uid: 'user_12345', loyalty_id: 'LY9876' }

Identitätsereignis senden

Um sofort ein Identitätsereignis zu senden, das Nutzer-IDs mit der Consent-UUID verknüpft, ohne auf eine Einwilligungsaktion zu warten:

_unicData.push({
    event: 'send_identity',
    user_ids: {
        auth_uid: 'user_12345'
    }
});

Unterstützte ID-Typen

Die folgenden systemstandardmäßigen ID-Typen sind verfügbar:

• auth_uid — Authentifizierte Nutzer-ID
• email — E-Mail-Adresse
• email_hash — Gehashte E-Mail-Adresse
• phone — Telefonnummer
• phone_hash — Gehashte Telefonnummer
• customer_id — Kunden-ID
• crm_id — CRM-ID

Sie können auch benutzerdefinierte ID-Typen im Dashboard unter Consent Logs > Search > Settings (Zahnrad-Symbol) festlegen.

Consent-UUID abrufen

Sie können die Consent-UUID aus dem Local-Storage-Schlüssel __unid des Nutzers abrufen oder über die JavaScript API:

__unicapi('getConsentId', 2, (consentId) => {
    console.log(consentId);
});

Dashboard

Wenn Consent DB aktiviert ist, erscheint eine Seite Consent Logs in der Seitenleiste unter Consent Data. Das Dashboard bietet:

• Metriken — Anzahl der Einwilligungsdatensätze (letzte 30 Tage) und Anzahl eindeutiger IDs
• Suche — Protokolle nach UUID oder nach ID-Typ und Wert durchsuchen (z. B. alle Einwilligungsdatensätze für eine bestimmte auth_uid finden)
• Datensatztabelle — Zeit, Projekt, UUID, Einwilligungstyp, IP (maskiert), Seiten-URL, Consent-String, Nutzer-IDs

Einwilligungsprotokolle abfragen

Nach UUID

Geben Sie die Consent-UUID in das UUID-Suchfeld ein, um alle Einwilligungsdatensätze für ein bestimmtes Gerät oder einen bestimmten Browser zu finden.

Nach Nutzeridentität

Wählen Sie einen ID-Typ (z. B. auth_uid) und geben Sie den ID-Wert ein, um alle geräteübergreifenden Einwilligungsdatensätze zu finden, die mit dieser Identität verknüpft sind.

Noch Fragen?

Kontaktieren Sie uns: support@uniconsent.com