Zum Hauptinhalt springen
Die Usercentrics Consent Management Platform enthält alle erforderlichen und aktuellen Datenschutzinformationen. Mit der Usercentrics-Integration verbindet sich Kameleoon automatisch mit Usercentrics, greift auf die Einwilligungsrichtlinie innerhalb der Plattform zu und verwendet diese bei der Anzeige von Experimenten und Personalisierungen auf Ihrer Website. Wichtige Vorteile:
  • Automatische Verwaltung der Nutzereinwilligung über die Usercentrics CMP ohne zusätzliche Einrichtung.
  • Sorgt für Konsistenz bei der Einwilligungsverwaltung und ermöglicht nahtlose Compliance.
  • Geben Sie Ihren Nutzern die Gewissheit, dass ihre Daten konform verwendet werden.

​
Kameleoon als Data Processing Service in Usercentrics hinzufügen

Sie müssen einen neuen Data Processing Service in Usercentrics auswählen. Gehen Sie dazu wie folgt vor:
  1. Klicken Sie in der Admin-Oberfläche von Usercentrics auf Service Settings.
  2. Klicken Sie auf Add DPS via Database > Kameleoon.
  1. Wählen Sie Ihre Kategorie im Dropdown Category aus.
Kameleoon Template-IDs:
  • Kameleoon AB Testing&Personalization / Template ID: H1yDxp7JN
  • Kameleoon Only AB Testing Module / Template ID: 9FYjH37-J
  • Kameleoon Only Personalization Module / Template ID: 2lh8-reEz

​
IAB TCF in Usercentrics einrichten

Um IAB TCF 2.2 (Usercentrics & Kameleoon) zu aktivieren, müssen Sie diese Schritte abschließen:
  1. Richten Sie Kameleoon als Anbieter (id:820) in Usercentrics ein.
  2. Navigieren Sie in der Admin-Oberfläche von Usercentrics zu Service Settings.
  3. Setzen Sie die CMP-Version auf Version 2.
  1. Klicken Sie auf Configuration.
  2. Aktivieren Sie Transparency & Consent Framework 2.2 (TCF)
  1. Aktivieren Sie die IAB TCF-Integration in Kameleoon.
Wenn Sie TCF 2.2 in Usercentrics nicht aktivieren können, können Sie eine benutzerdefinierte Skript-Einrichtung verwenden.
Blockieren Sie Kameleoon nicht, wenn der Einwilligungsstatus unbekannt ist (erster Besuch). Andernfalls ist diese Einrichtung obsolet.
Diese Einrichtung ist optimiert, um Nutzern Kampagnen bei unbekanntem Einwilligungsstatus ohne Tracking anzuzeigen. Sie können auch Änderungen für A/B-Tests auf den Einstiegsseiten Ihres Projekts anzeigen.
  1. Definieren Sie in Kameleoon Ihre Einwilligungsverwaltungsrichtlinie und wählen Sie Consent required.
  2. Integrieren Sie die folgenden Kameleoon-Funktionen:
    • enableLegalConsent
    • disableLegalConsent
Um mehr über die rechtliche Einwilligung in Kameleoon zu erfahren, lesen Sie diese Dokumentation. Weitere technische Informationen zu Zuständen und Modi finden Sie in dieser Dokumentation.
Sie können benutzerdefinierte Skripte direkt auf einer Seite, in Google Tag Manager oder als Global custom script in der Kameleoon-App verwenden. Wenn Sie benutzerdefinierte Skripte im Global custom script verwenden möchten, befolgen Sie diese Schritte:
  1. Gehen Sie zum Menü Projects.
  2. Klicken Sie auf Configuration auf der Karte für Ihre Website oder mobile App.
  1. Öffnen Sie den Abschnitt General.
  2. Kopieren Sie einen der untenstehenden Codeblöcke und fügen Sie ihn ein, je nach dem von Ihnen gewählten Kameleoon-Template.

​
Beispiel eines benutzerdefinierten Skripts, wenn A/B-Testing und Personalisierung im selben Service sind

Kameleoon AB Testing&Personalization / Template ID: H1yDxp7JN

function setConsentStatus(type, status, action) {
        if (status) {
            window.kameleoonQueue.push(function() {
                Kameleoon.API.Core.enableLegalConsent(type);
                console.log('enableLegalConsent ' + type)
            });
        } else if (!status) {
            window.kameleoonQueue.push(function() {
                Kameleoon.API.Core.disableLegalConsent(type);
                console.log('disableLegalConsent ' + type)
            });
        }
    }

    function initKameleoonLegalConsent(type) {
        window.kameleoonQueue = window.kameleoonQueue || [];
        window.kameleoonQueue.push(function() {
            Kameleoon.API.Core.runWhenConditionTrue(() => typeof UC_UI !== 'undefined' 
            && UC_UI.isInitialized() === true
            && window.localStorage.getItem('uc_user_interaction') === 'true', () => {
                const abtesting = UC_UI.getServicesBaseInfo().filter((service) => service && service.id === 'H1yDxp7JN');
                if (abtesting.length > 0) {
                    setConsentStatus('BOTH', abtesting[0].consent.status);
                }
            }, 200);
        });
    }
    initKameleoonLegalConsent();

​
Beispiel eines benutzerdefinierten Skripts, wenn A/B-Testing und Personalisierung in verschiedenen Services sind

  • Kameleoon Only AB Testing Module = Template ID: 9FYjH37-J
  • Kameleoon Only Personalization Module = Template ID: 2lh8-reEz
function setConsentStatus(type, status, action) {
        if (status) {
            window.kameleoonQueue.push(function() {
                Kameleoon.API.Core.enableLegalConsent(type);
                console.log('enableLegalConsent ' + type)
            });
        } else if (!status) {
            window.kameleoonQueue.push(function() {
                Kameleoon.API.Core.disableLegalConsent(type);
                console.log('disableLegalConsent ' + type)
            });
        }
    }

    function initKameleoonLegalConsent(type) {
        window.kameleoonQueue = window.kameleoonQueue || [];
        window.kameleoonQueue.push(function() {
            Kameleoon.API.Core.runWhenConditionTrue(() => typeof UC_UI !== 'undefined' 
            && UC_UI.isInitialized() === true
            && window.localStorage.getItem('uc_user_interaction') === 'true', () => {
                const abtesting = UC_UI.getServicesBaseInfo().filter((service) => service && service.id === '9FYjH37-J');
                if (abtesting.length > 0) {
                    setConsentStatus('AB_TESTING', abtesting[0].consent.status);
                }
                const perso = UC_UI.getServicesBaseInfo().filter((service) => service && service.id === '2lh8-reEz');
                if (perso.length > 0) {
                    setConsentStatus('PERSONALIZATION',perso[0].consent.status);
                }
            }, 200);
        });
    }
    initKameleoonLegalConsent();
Falls Sie Fragen haben, wenden Sie sich gerne an Ihren Kameleoon Custom Success Manager.

​
A/B-Test des Usercentrics-Einwilligungsbanners

Wir empfehlen, pro Website nur ein Consent-Experiment auszuführen.
Um einen A/B-Test auf einem Usercentrics-Einwilligungsbanner durchzuführen, müssen Sie zunächst ein Ziel erstellen:
  1. Klicken Sie auf Configure > Goals > New goal.
  2. Wählen Sie in Website Selection die Website aus, die Sie bei der Erstellung Ihres Kontos definiert haben.
  3. Wählen Sie Custom Goal in Type.
    • Derzeit unterstützt Usercentrics mehrere benutzerdefinierte Ereignisse für benutzerdefinierte Ziele. Mehr dazu lesen Sie hier.
  4. Klicken Sie auf Next.
  5. Geben Sie im Feld Name your goal einen Namen für Ihr Ziel ein.
  6. Geben Sie Kameleoon.API.Goals.processConversion (und die Unique ID darin) in Describe your goal ein.
    • Sie finden die ID im Pop-in New goal am Ende des Funktionstexts.
Nach dem Erstellen des neuen Ziels müssen Sie ein Experiment erstellen:
  1. Gehen Sie zum Experiments-Dashboard.
  2. Klicken Sie auf New Experiment. Ein Pop-in öffnet sich und fragt, welchen Typ von Experiment Sie erstellen möchten.
  3. Klicken Sie auf In the code editor > JS/CSS.
  4. Geben Sie den Name, die Website und die URL of the page where you want to launch your experiment ein.
  5. Klicken Sie auf Validate. Der Code Editor wird geöffnet.
  1. Klicken Sie auf Experiment (direkt über Variations im linken Menü) und klicken Sie im rechten Menü auf Test specific code.
  2. Fügen Sie den folgenden Code hinzu:
window.UC_AB_VARIANT = "variant0";
 window.addEventListener('UC_UI_CMP_EVENT', function (data) {
      console.log("TEST: source =>", data.detail.source);
      console.log("TEST: type =>", data.detail.type);
      console.log("TEST: Variant =>", data.detail.abTestVariant);
      //These are our custom events for each basic action
      //in our Consent Management Platform
      if (data.detail.type === "CMP_SHOWN") Kameleoon.API.Goals.processConversion(Your Unique ID);
      if (data.detail.type === "ACCEPT_ALL") Kameleoon.API.Goals.processConversion(Your Unique ID);
      if (data.detail.type === "DENY_ALL") Kameleoon.API.Goals.processConversion(Your Unique ID);
      if (data.detail.type === "SAVE") Kameleoon.API.Goals.processConversion(Your Unique ID);
      if (data.detail.type === "MORE_INFORMATION_LINK") Kameleoon.API.Goals.processConversion(Your Unique ID);
      if (data.detail.type === "IMPRINT_LINK") Kameleoon.API.Goals.processConversion(Your Unique ID);
      if (data.detail.type === "PRIVACY_POLICY_LINK") Kameleoon.API.Goals.processConversion(Your Unique ID);
  });
  • variant0 ist die Standard-Variation, die wir als leere Variation definiert haben, was bedeutet, dass sie keine Änderungen an der Consent Management Platform vornimmt. Wenn Ihre Standard-Variation einen anderen Namen hat, ändern Sie sie entsprechend. Verwenden Sie window.UC_AB_VARIANT="variant0", um zu Ihrer Standard-Variation zu wechseln.
  • Der Event Listener wird jedes Mal ausgelöst, wenn Sie eines unserer Custom Events auslösen. Weitere Informationen zu Custom Events für A/B Testing finden Sie hier
  • Die drei console.logs geben wichtige Informationen zu Ihrem Event zurück. Um beispielsweise ACCEPT_ALL wie im Code dargestellt zu verfolgen, werden Ihnen diese Logs angezeigt:
 TEST: source => FIRST_LAYER
 TEST: type => ACCEPT_ALL
 TEST: Variant => variant1
Sie können diesem Experiment bei Bedarf weitere Ziele hinzufügen. Um ein neues Ziel hinzuzufügen, fügen Sie einfach den folgenden Code unter die letzte „if”-Anweisung ein. if (data.detail.type === "Consent Management Platform event here") Kameleoon.API.Goals.processConversion(goalID)
  1. Gehen Sie zurück zum Tab Variations.
  2. Fügen Sie in Variation 1 den folgenden Code hinzu: window.UC_AB_VARIANT = "variant1";
  3. Ersetzen Sie variant1, falls Sie Ihrer Variation einen anderen Namen gegeben haben.
  4. Wählen Sie im Tab Finalize Ihre Traffic-Verteilung, Ihr Targeting, Tracking und Ihre Ziele aus.
    • Hier fügen Sie das von Ihnen erstellte Ziel hinzu. Sie können nach der eindeutigen ID des Ziels suchen. Falls Sie Schwierigkeiten bei der Suche haben, versuchen Sie es nur mit den ersten Ziffern der Ziel-ID.
  5. Klicken Sie auf Publish, um die Einrichtung des Experiments abzuschließen.
Diese Anleitung führt Sie durch das interne A/B-Testing von Usercentrics.