Compliant with GDPR, CCPA, COPPA, LGPD, PECR, PDPA, PIPEDA, and more.
Sie können On-Page-Elemente mit UnicScript verwalten, um Tags basierend auf der Benutzereinwilligung für bestimmte Zweck-IDs oder benutzerdefinierte Anbieter-IDs zu laden, wie sie durch IAB TCF 2.3-Zwecke, Easy Mode-Zwecke oder Google Consent Mode-Typen definiert sind.
UniConsent unterstützt zwei Einwilligungsmodi. Welcher Modus angewendet wird, hängt von Ihrer CMP-Konfiguration und der Region des Besuchers ab:
unic-purpose-id-Attribute mit TCF-Zweck-IDs (1–11).unic-e-purpose-id-Attribute mit Easy-Zweck-IDs (1–4).Wichtig: Wenn Easy Mode für eine Region aktiviert ist, werden nur
unic-e-purpose-id-Attribute verarbeitet. Skripte mitunic-purpose-idwerden nicht aktiviert. Stellen Sie sicher, dass Sie das richtige Attribut für Ihre CMP-Konfiguration verwenden.
Wenn Sie unsicher sind, welcher Modus gilt, überprüfen Sie die Einstellungen für „Easy Mode" und „Region" in Ihrem CMP-Dashboard.
| Zweck-ID | Beschreibung |
|---|---|
| 1 | Unbedingt erforderlich — Essenzielle Cookies für grundlegende Website-Funktionalität (immer erlaubt) |
| 2 | Leistung / Analyse — Analyse- und Mess-Cookies |
| 3 | Funktionalität — Cookies für erweiterte Funktionen und Personalisierung |
| 4 | Targeting / Werbung — Cookies für Werbung und Tracking |
Beispiel 1: Skript für Analyse-Einwilligung laden (Easy Mode)
<script type="text/unicscript" unic-e-purpose-id="2">
console.log('Analytics consent granted');
</script>
Beispiel 2: Externes Skript für Analyse laden (Easy Mode)
<script type="text/unicscript" unic-e-purpose-id="2" src="https://example.com/analytics.js"></script>
Beispiel 3: Google Analytics (gtag.js) mit Easy Mode laden
<script type="text/unicscript" unic-e-purpose-id="2" async src="https://www.googletagmanager.com/gtag/js?id=G-XXXXXXX"></script>
<script type="text/unicscript" unic-e-purpose-id="2">
window.dataLayer = window.dataLayer || [];
function gtag(){ dataLayer.push(arguments); }
gtag('js', new Date());
gtag('config', 'G-XXXXXXX');
</script>
Beispiel 4: Skript für Werbe-Einwilligung laden (Easy Mode)
<script type="text/unicscript" unic-e-purpose-id="4" src="https://example.com/ads.js"></script>
<iframe
data-unicscript
unic-e-purpose-id="2"
width="560"
height="315"
data-src="https://example.com/analytics-widget"
frameborder="0"
></iframe>
| Zweck-ID | Beschreibung |
|---|---|
| 1 | Informationen auf einem Gerät speichern und/oder abrufen |
| 2 | Eingeschränkte Daten zur Auswahl von Werbung verwenden |
| 3 | Profile für personalisierte Werbung erstellen |
| 4 | Profile zur Auswahl personalisierter Werbung verwenden |
| 5 | Profile zur Personalisierung von Inhalten erstellen |
| 6 | Profile zur Auswahl personalisierter Inhalte verwenden |
| 7 | Werbeleistung messen |
| 8 | Inhaltsleistung messen |
| 9 | Zielgruppen durch Statistiken oder Datenkombinationen aus verschiedenen Quellen verstehen |
| 10 | Dienste entwickeln und verbessern |
| 11 | Eingeschränkte Daten zur Auswahl von Inhalten verwenden |
Sie können Inline-JavaScript dynamisch basierend auf der Einwilligung für bestimmte Zweck-IDs laden.
Beispiel 1: Skript für eine einzelne Zweck-ID laden
<script type="text/unicscript" unic-purpose-id="1">
console.log('Consent granted for purpose 1');
</script>
Beispiel 2: Externes Skript mit einer Zweck-ID laden
<script type="text/unicscript" unic-purpose-id="1" src="path-to-external-script.js"></script>
Beispiel: Skript für mehrere Zweck-IDs laden
<script type="text/unicscript" unic-purpose-ids="1,2,3">
console.log('Consent granted for purposes 1, 2, and 3');
</script>
Beispiel:
<script type="text/unicscript" unic-vendor-id="1">
console.log('hello vendor 1');
</script>
Beispiel 2:
<script type="text/unicscript" unic-vendor-id="1" src="xxxxx"></script>
Sie können Iframes dynamisch basierend auf der Einwilligung für eine bestimmte Zweck-ID laden.
Beispiel: Iframe für eine einzelne Zweck-ID laden
<iframe
data-unicscript
unic-purpose-id="1"
width="560"
height="315"
data-src="https://www.youtube.com/embed/XXXX"
frameborder="0"
allow="accelerometer; autoplay; encrypted-media; gyroscope; picture-in-picture"
allowfullscreen
></iframe>
Beispiel: Iframe für mehrere Zweck-IDs laden
<iframe
data-unicscript
unic-purpose-ids="1,2,3"
width="560"
height="315"
data-src="https://www.youtube.com/embed/XXXX"
frameborder="0"
allow="accelerometer; autoplay; encrypted-media; gyroscope; picture-in-picture"
allowfullscreen
></iframe>
Beispiel: Iframe für eine einzelne Anbieter-ID laden
<iframe
unic-vendor-id="1"
width="560"
height="315"
data-src="https://www.youtube.com/embed/XXXX"
frameborder="0"
allow="accelerometer; autoplay; encrypted-media; gyroscope; picture-in-picture"
allowfullscreen
></iframe>
Sie können Skripte und Iframes basierend auf der Einwilligung für benutzerdefinierte Zwecke mit den Attributen unic-cp-id und unic-cp-ids laden.
Beispiel 1: Skript für eine einzelne benutzerdefinierte Zweck-ID laden
<script type="text/unicscript" unic-cp-id="custom_analytics">
console.log('Custom analytics consent granted');
</script>
Beispiel 2: Externes Skript für eine benutzerdefinierte Zweck-ID laden
<script type="text/unicscript" unic-cp-id="custom_analytics" src="https://example.com/analytics.js"></script>
Beispiel 3: Skript für mehrere benutzerdefinierte Zweck-IDs laden (alle müssen eingewilligt sein)
<script type="text/unicscript" unic-cp-ids="custom_analytics,ab_testing">
console.log('Both custom purposes consented');
</script>
Beispiel 4: Iframe für eine benutzerdefinierte Zweck-ID laden
<iframe
data-unicscript
unic-cp-id="custom_analytics"
width="560"
height="315"
data-src="https://example.com/widget"
frameborder="0"
></iframe>
Dieser Abschnitt beschreibt, wie Sie Inline-JavaScript basierend auf den Einwilligungstypen in Google Consent Mode laden, abgeglichen mit den Einwilligungstypen des UniConsent Simple Mode.
Die folgende Tabelle zeigt, wie verschiedene Google Consent Mode-Einwilligungstypen den UniConsent Simple Mode-Einwilligungstypen zugeordnet werden und welche Zwecke sie jeweils haben:
| Google Consent-Typ | UniConsent Simple Mode-Typ | Zweck |
|---|---|---|
ad_storage | Targeting und Werbung | Aktiviert Werbe-Cookies. |
analytics_storage | Leistung | Aktiviert Analyse-Cookies. |
functionality_storage | Funktionalität | Aktiviert funktionale Cookies für Website-Funktionalität und -Einstellungen. |
personalization_storage | Funktionalität | Aktiviert funktionale Cookies für die Benutzerpersonalisierung. |
security_storage | Unbedingt erforderlich | Aktiviert notwendige Cookies für Website-Sicherheit, Schutz und UI-Einstellungen. Diese Cookies erfordern keine Einwilligung. |
ad_user_data | Targeting und Werbung | Aktiviert Werbe-Cookies und setzt die Einwilligung zum Senden personenbezogener Daten an Googles Kerndienste. |
ad_personalization | Targeting und Werbung | Aktiviert Werbe-Cookies für die Datennutzung in der Anzeigenpersonalisierung, wie z. B. Remarketing. |
Verwenden Sie das folgende Format, um Inline-JavaScript basierend auf der Benutzereinwilligung zu laden:
<script type="text/unicscript" unic-gcm-id="functionality_storage">
console.log('Consent for functionality storage is granted, script is executed.');
</script>
Sie können mehrere Einwilligungstypen mit dem Attribut unic-gcm-ids angeben, wie unten gezeigt:
<script type="text/unicscript" unic-gcm-ids="analytics_storage,ad_user_data">
console.log('Consent for analytics storage and ad user data is granted, script is executed.');
</script>
Sie können Einwilligungseinstellungen auch auf Iframes anwenden. Hier ein Beispiel:
<iframe data-unicscript unic-gcm-ids="functionality_storage,ad_personalization"
width="560" height="315"
data-src="https://www.youtube.com/embed/XXXXXXX"
frameborder="0" allow="accelerometer; autoplay; encrypted-media; gyroscope; picture-in-picture"
allowfullscreen>
</iframe>
Dieses Beispiel stellt sicher, dass der Iframe-Inhalt nur geladen wird, wenn die Einwilligung für die angegebenen Kategorien (functionality_storage und ad_personalization) erteilt wurde.
Ändern Sie:
<script
async
src="//pagead2.googlesyndication.com/pagead/js/adsbygoogle.js"
type="text/javascript"
></script>
zu:
<script
async
src="//pagead2.googlesyndication.com/pagead/js/adsbygoogle.js"
unic-purpose-id="3"
type="text/unicscript"
></script>
Ändern Sie den Google Adsense-Anzeigenslot-Tag auf der Seite von:
<ins class="adsbygoogle" style="display:block" data-ad-client="ca-pub-XXXXXX" data-ad-slot="XXXXXXX" data-ad-format="auto" data-full-width-responsive="true"></ins>
<script type="text/javascript">
(adsbygoogle = window.adsbygoogle || []).push({});
</script>
zu:
<ins class="adsbygoogle" style="display:block" data-ad-client="ca-pub-XXXXXX" data-ad-slot="XXXXXXX" data-ad-format="auto" data-full-width-responsive="true"></ins>
<script type="text/unicscript" unic-purpose-id="3" >
(adsbygoogle = window.adsbygoogle || []).push({});
</script>
Zeigen Sie einen Inline-Platzhalter mit einer benutzerdefinierten Nachricht an, wenn Inhalte aufgrund fehlender Einwilligung blockiert werden. Sobald die Einwilligung erteilt wird, verschwindet der Platzhalter und der ursprüngliche Inhalt wird angezeigt.
Dies ist nützlich für eingebettete Inhalte wie YouTube-Videos, Social-Media-Beiträge, Analyse-Widgets oder Drittanbieter-Skripte, bei denen Sie den Benutzern zeigen möchten, warum der Inhalt blockiert ist, und ihnen eine Möglichkeit geben, die Einwilligung direkt zu erteilen.
Umschließen Sie Ihren Inhalt in einem <div> mit data-unicscript und dem entsprechenden Zweck-Attribut:
<div data-unicscript
style="display:none"
unic-e-purpose-id="2"
unic-consent-message="Wir benötigen Ihre Einwilligung, um diesen Inhalt anzuzeigen."
unic-consent-button="Erlauben">
<iframe data-src="https://www.youtube.com/embed/XXXX"
width="560" height="315" allowfullscreen></iframe>
</div>
Wichtig: Fügen Sie immer
style="display:none"hinzu, um ein Aufblitzen des Inhalts vor dem Laden des CMP zu verhindern.
| Attribut | Erforderlich | Beschreibung |
|---|---|---|
data-unicscript | Ja | Markiert das Div für die Einwilligungskontrolle |
style="display:none" | Ja | Verhindert das Aufblitzen von Inhalten vor dem Laden des CMP |
unic-purpose-id | * | Einzelne IAB TCF Zweck-ID (z. B. "1") |
unic-purpose-ids | * | Mehrere IAB TCF Zweck-IDs, kommagetrennt (z. B. "1,3,4" — alle müssen erteilt sein) |
unic-cp-id | * | Benutzerdefinierte Zweck-ID |
unic-e-purpose-id | * | Easy Zweck-ID |
unic-gcm-id | * | Google Consent Mode-Signal (z. B. "analytics_storage") |
unic-vendor-id | * | Benutzerdefinierte Anbieter-ID |
unic-consent-message | Nein | Benutzerdefinierte Nachricht (Standard: „This content requires your consent to be displayed.") |
unic-consent-button | Nein | Schaltflächentext (Standard: „Accept") |
unic-consent-action | Nein | "grant" = Einwilligung still über API erteilen, "open" oder weggelassen = CMP-Dialog öffnen |
* Ein Zweck-Attribut ist erforderlich.
Iframes — verwenden Sie data-src statt src, um das Laden vor der Einwilligung zu verhindern:
<iframe data-src="https://www.youtube.com/embed/XXXX" width="560" height="315"></iframe>
Skripte — verwenden Sie type="text/plain", um die Ausführung vor der Einwilligung zu verhindern:
<script type="text/plain" src="https://example.com/analytics.js"></script>
<script type="text/plain">
console.log('Dies wird nur nach Erteilung der Einwilligung ausgeführt');
</script>
Nach Erteilung der Einwilligung wird data-src automatisch in src kopiert und Skripte mit type="text/plain" werden automatisch aktiviert.
YouTube-Video:
<div data-unicscript
style="display:none"
unic-e-purpose-id="4"
unic-consent-message="Bitte akzeptieren Sie Werbe-Cookies, um dieses Video anzusehen."
unic-consent-button="Akzeptieren & Abspielen"
unic-consent-action="grant">
<iframe data-src="https://www.youtube.com/embed/XXXX"
width="560" height="315" allowfullscreen></iframe>
</div>
X (Twitter) Beitrag:
<div data-unicscript
style="display:none"
unic-e-purpose-id="4"
unic-consent-message="Bitte akzeptieren Sie Cookies, um diesen X-Beitrag anzuzeigen."
unic-consent-button="Beitrag anzeigen"
unic-consent-action="grant">
<blockquote class="twitter-tweet">
<a href="https://twitter.com/user/status/XXXX"></a>
</blockquote>
<script type="text/plain" src="https://platform.twitter.com/widgets.js"></script>
</div>
Instagram-Beitrag:
<div data-unicscript
style="display:none"
unic-e-purpose-id="4"
unic-consent-message="Bitte akzeptieren Sie Cookies, um diesen Instagram-Beitrag anzuzeigen."
unic-consent-button="Beitrag anzeigen"
unic-consent-action="grant">
<blockquote class="instagram-media" data-instgrm-permalink="https://www.instagram.com/p/XXXX/">
</blockquote>
<script type="text/plain" src="https://www.instagram.com/embed.js"></script>
</div>
Facebook-Beitrag:
<div data-unicscript
style="display:none"
unic-e-purpose-id="4"
unic-consent-message="Bitte akzeptieren Sie Cookies, um diesen Facebook-Beitrag anzuzeigen."
unic-consent-button="Beitrag anzeigen"
unic-consent-action="grant">
<div class="fb-post" data-href="https://www.facebook.com/user/posts/XXXX"></div>
<script type="text/plain" src="https://connect.facebook.net/en_US/sdk.js#xfbml=1&version=v18.0"></script>
</div>
TikTok-Video:
<div data-unicscript
style="display:none"
unic-e-purpose-id="4"
unic-consent-message="Bitte akzeptieren Sie Cookies, um dieses TikTok-Video anzuzeigen."
unic-consent-button="Video anzeigen"
unic-consent-action="grant">
<blockquote class="tiktok-embed" cite="https://www.tiktok.com/@user/video/XXXX">
</blockquote>
<script type="text/plain" src="https://www.tiktok.com/embed.js"></script>
</div>
Google Maps:
<div data-unicscript
style="display:none"
unic-e-purpose-id="3"
unic-consent-message="Bitte akzeptieren Sie Cookies, um die Karte anzuzeigen."
unic-consent-button="Karte anzeigen"
unic-consent-action="grant">
<iframe data-src="https://www.google.com/maps/embed?pb=XXXX"
width="600" height="450" style="border:0;" allowfullscreen loading="lazy"></iframe>
</div>
Disqus-Kommentare:
<div data-unicscript
style="display:none"
unic-e-purpose-id="3"
unic-consent-message="Wir benötigen Ihre Einwilligung, um Kommentare anzuzeigen."
unic-consent-button="Kommentare anzeigen"
unic-consent-action="grant">
<div id="disqus_thread"></div>
<script type="text/plain">
var disqus_config = function () { this.page.url = PAGE_URL; this.page.identifier = PAGE_IDENTIFIER; };
(function() { var d = document, s = d.createElement('script');
s.src = 'https://EXAMPLE.disqus.com/embed.js';
s.setAttribute('data-timestamp', +new Date());
(d.head || d.body).appendChild(s); })();
</script>
</div>
Hinweis: Die obigen Beispiele verwenden
unic-e-purpose-id(Easy Mode). Wenn Ihre Website den IAB TCF-Modus verwendet, ersetzen Sie durch den entsprechendenunic-purpose-id(z. B.unic-purpose-id="1"für Gerätespeicher,unic-purpose-id="4"für personalisierte Werbung).
Kontaktieren Sie uns: support@uniconsent.com