Leading Consent Management Platform

Compliant with GDPR, CCPA, COPPA, LGPD, PECR, PDPA, PIPEDA, and more.

Verwaltung von On-Page-Elementen und Tags mit UnicScript

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.

Zwei Einwilligungsmodi

UniConsent unterstützt zwei Einwilligungsmodi. Welcher Modus angewendet wird, hängt von Ihrer CMP-Konfiguration und der Region des Besuchers ab:

  • IAB TCF-Modus — Wird für die DSGVO-Konformität (EU) mit dem IAB Transparency & Consent Framework verwendet. Verwendet unic-purpose-id-Attribute mit TCF-Zweck-IDs (1–11).
  • Easy Mode (Einfacher Modus) — Ein vereinfachter Einwilligungsmodus für Nicht-TCF-Regionen wie LGPD (Brasilien), PIPL (China), POPIA (Südafrika) oder jede Region, in der Sie Easy Mode aktivieren. Verwendet 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 mit unic-purpose-id werden 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.

Easy Mode Zweck-IDs

Zweck-IDBeschreibung
1Unbedingt erforderlich — Essenzielle Cookies für grundlegende Website-Funktionalität (immer erlaubt)
2Leistung / Analyse — Analyse- und Mess-Cookies
3Funktionalität — Cookies für erweiterte Funktionen und Personalisierung
4Targeting / Werbung — Cookies für Werbung und Tracking

Skripte basierend auf Easy Mode Zweck-ID laden

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>

Iframes basierend auf Easy Mode Zweck-ID laden

<iframe
  data-unicscript
  unic-e-purpose-id="2"
  width="560"
  height="315"
  data-src="https://example.com/analytics-widget"
  frameborder="0"
></iframe>

IAB TCF-Modus

IAB TCF 2.3 Zweck-IDs

Zweck-IDBeschreibung
1Informationen auf einem Gerät speichern und/oder abrufen
2Eingeschränkte Daten zur Auswahl von Werbung verwenden
3Profile für personalisierte Werbung erstellen
4Profile zur Auswahl personalisierter Werbung verwenden
5Profile zur Personalisierung von Inhalten erstellen
6Profile zur Auswahl personalisierter Inhalte verwenden
7Werbeleistung messen
8Inhaltsleistung messen
9Zielgruppen durch Statistiken oder Datenkombinationen aus verschiedenen Quellen verstehen
10Dienste entwickeln und verbessern
11Eingeschränkte Daten zur Auswahl von Inhalten verwenden

Skripte basierend auf TCF Zweck-ID laden

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>

Inline-JavaScript basierend auf mehreren Zweck-IDs laden

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>

Inline-JavaScript basierend auf der Einwilligung für eine benutzerdefinierte Anbieter-ID laden

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>

Inline-Iframes basierend auf der Einwilligung für eine Zweck-ID laden

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>

Inline-Iframes basierend auf mehreren Zweck-IDs laden

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>

Inline-Iframes basierend auf der Einwilligung für eine benutzerdefinierte Anbieter-ID laden

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>

Inline-JavaScript basierend auf benutzerdefinierten Zweck-IDs laden

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-TypUniConsent Simple Mode-TypZweck
ad_storageTargeting und WerbungAktiviert Werbe-Cookies.
analytics_storageLeistungAktiviert Analyse-Cookies.
functionality_storageFunktionalitätAktiviert funktionale Cookies für Website-Funktionalität und -Einstellungen.
personalization_storageFunktionalitätAktiviert funktionale Cookies für die Benutzerpersonalisierung.
security_storageUnbedingt erforderlichAktiviert notwendige Cookies für Website-Sicherheit, Schutz und UI-Einstellungen. Diese Cookies erfordern keine Einwilligung.
ad_user_dataTargeting und WerbungAktiviert Werbe-Cookies und setzt die Einwilligung zum Senden personenbezogener Daten an Googles Kerndienste.
ad_personalizationTargeting und WerbungAktiviert Werbe-Cookies für die Datennutzung in der Anzeigenpersonalisierung, wie z. B. Remarketing.

Beispiel: Inline-JavaScript laden

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>

Beispiel: Iframes basierend auf Einwilligung laden

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.

Google Adsense mit UnicScript verwalten

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

Inline-Einwilligungs-Platzhalterblöcke

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.

Grundlegende Verwendung

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.

Attribute

AttributErforderlichBeschreibung
data-unicscriptJaMarkiert das Div für die Einwilligungskontrolle
style="display:none"JaVerhindert 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-messageNeinBenutzerdefinierte Nachricht (Standard: „This content requires your consent to be displayed.")
unic-consent-buttonNeinSchaltflächentext (Standard: „Accept")
unic-consent-actionNein"grant" = Einwilligung still über API erteilen, "open" oder weggelassen = CMP-Dialog öffnen

* Ein Zweck-Attribut ist erforderlich.

Inhalte innerhalb des Div blockieren

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.

Beispiele für Social-Media-Einbettungen und Drittanbieter-Widgets

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 entsprechenden unic-purpose-id (z. B. unic-purpose-id="1" für Gerätespeicher, unic-purpose-id="4" für personalisierte Werbung).

Noch Fragen?

Kontaktieren Sie uns: support@uniconsent.com