Compliant with GDPR, CCPA, COPPA, LGPD, PECR, PDPA, PIPEDA, and more.
Benutzerdefinierte Zwecke (Custom Purposes) ermöglichen es Ihnen, eigene Einwilligungszwecke über die standardmäßigen IAB TCF-Zwecke und Google Consent Mode-Typen hinaus zu definieren. Sie werden in der Einwilligungs-UI angezeigt, separat von der TCF-Einwilligung gespeichert und können über die JavaScript API abgefragt oder mit UnicScript-Tag-Loading verwendet werden.
custom_analytics, ab_testing, newsletter_tracking). Leerzeichen werden automatisch in Unterstriche umgewandelt. Diese ID wird in der Speicherung, im dataLayer, beim Tag-Loading und bei API-Abfragen verwendet.Sie können mehrere benutzerdefinierte Zwecke hinzufügen. Jeder muss eine eindeutige ID haben.
Benutzerdefinierte Zwecke unterstützen mehrsprachige Übersetzungen. So fügen Sie Übersetzungen hinzu:
__unic_custom_consent) gespeichert, unabhängig von TCF-Einwilligungsstrings und Google Consent Mode.Verwenden Sie getCustomConsent, um den aktuellen Einwilligungsstatus aller benutzerdefinierten Zwecke abzurufen:
__tcfapi('getCustomConsent', 2, function(data, success) {
if (success) {
console.log(data);
// Example output: { "custom_analytics": true, "ab_testing": false }
}
});
Oder mit dem __unicapi-Alias:
__unicapi('getCustomConsent', 2, function(data, success) {
if (success) {
// Check a specific custom purpose
if (data['custom_analytics']) {
// Custom analytics consent is granted
}
}
});
Verwenden Sie setCustomConsent, um den Einwilligungsstatus benutzerdefinierter Zwecke programmatisch zu setzen:
__tcfapi('setCustomConsent', 2, { "custom_analytics": true, "ab_testing": false });
Oder mit dem __unicapi-Alias:
__unicapi('setCustomConsent', 2, { "custom_analytics": true, "ab_testing": false });
Die angegebenen Werte werden mit dem bestehenden Einwilligungsstatus zusammengeführt und in localStorage gespeichert. Sie müssen nur die Zwecke angeben, die Sie aktualisieren möchten — andere Zwecke behalten ihre aktuellen Werte.
Der Einwilligungsstatus benutzerdefinierter Zwecke wird als UNIC_CP_{id} in den dataLayer gepusht:
// Listen for consent data
(function waitCMP() {
var readyCMP;
if (!readyCMP && window['dataLayer']) {
window['dataLayer'].forEach(function(event) {
if (event['event'] === 'unic_data') {
readyCMP = 1;
console.log(event['UNIC_CP_custom_analytics']); // true or false
console.log(event['UNIC_CP_ab_testing']); // true or false
}
});
}
if (!readyCMP) {
setTimeout(waitCMP, 100);
}
})();
Sie können Skripte und Iframes bedingt basierend auf der Einwilligung für benutzerdefinierte Zwecke laden, indem Sie die Attribute unic-cp-id und unic-cp-ids verwenden.
<script type="text/unicscript" unic-cp-id="custom_analytics">
console.log('Custom analytics consent granted');
</script>
<script type="text/unicscript" unic-cp-id="custom_analytics" src="https://example.com/analytics.js"></script>
Alle angegebenen Zwecke müssen eingewilligt sein, damit das Skript geladen wird:
<script type="text/unicscript" unic-cp-ids="custom_analytics,ab_testing">
console.log('Both custom analytics and A/B testing consent granted');
</script>
<iframe
data-unicscript
unic-cp-id="custom_analytics"
width="560"
height="315"
data-src="https://example.com/widget"
frameborder="0"
></iframe>
<iframe
data-unicscript
unic-cp-ids="custom_analytics,ab_testing"
width="560"
height="315"
data-src="https://example.com/widget"
frameborder="0"
></iframe>
In GTM können Sie die dataLayer-Variablen UNIC_CP_{id} verwenden, um Trigger basierend auf der Einwilligung für benutzerdefinierte Zwecke zu erstellen:
UNIC_CP_custom_analytics.UNIC_CP_custom_analytics gleich true ist.Benutzerdefinierte Einwilligungsdaten werden unter dem Schlüssel __unic_custom_consent in localStorage (Web) oder im nativen Key-Value-Speicher (mobile Apps) gespeichert. Das Format ist:
{
"custom_analytics": true,
"ab_testing": false
}
Diese Speicherung ist unabhängig von:
euconsent-v2)__unic_consent_mode)Benutzerdefinierte Einwilligungen werden gelöscht, wenn Nutzer ihre Einwilligung über die CMP zurücksetzen.
Kontaktieren Sie uns: support@uniconsent.com