Consent Manager

Wenn deine Website einen Consent Manager verwendet (auch Cookie-Banner oder CMP genannt), muss ABlyft wissen, wozu der Visitor zugestimmt hat. ABlyft unterstützt das mit zwei Regeln in deinem Project und zwei API-Aufrufen, die du aus deinem Consent Manager auslöst.

Ein Setup wählenCopy Anchor Link

Technisch kann ABlyft auf drei Arten mit einer Consent-Management-Plattform (CMP) zusammenarbeiten. Welche passt, hängt von deiner Architektur, deinem Testing-Setup und deinen Datenschutzanforderungen ab. Bewerte die rechtliche Seite unabhängig davon, was technisch möglich ist.

1. Unabhängig von der Einwilligung. Das Snippet läuft ohne Einschränkungen und ist nicht mit der CMP verknüpft. Lass beide Regeln unten auf dem Standardwert return true;.

2. Nach der Einwilligung laden. Das Snippet wird von deiner CMP blockiert und geladen, sobald der Visitor zugestimmt hat. Bis dahin läuft ABlyft gar nicht. Das ist einfach, aber Visitors sehen möglicherweise Flackern, weil Variations erst nach der Entscheidung angewendet werden können.

3. Einwilligungsabhängiges Speichern und Tracking. Das Snippet sitzt direkt in der Seite und läuft vor der Einwilligung, sodass Variations ohne Flackern erscheinen. Speichern und Tracking warten auf die Entscheidung des Visitors. Dieses Setup wird im Rest dieser Seite beschrieben.

So funktioniert esCopy Anchor Link

ABlyft trennt zwei Dinge:

Du kannst Variations immer anzeigen und erst tracken, wenn der Visitor eingewilligt hat. Das vermeidet Flackern, weil das Snippet im <head> deiner Seite bleiben kann.

Solange die Tracking-Regel nicht true zurückgibt:

• Daten, die ABlyft in den Browser schreiben würde (zum Beispiel die Variation-Zuweisung), werden nur im Arbeitsspeicher gehalten.
• Events, die gesendet würden (Bucketing, Goals), werden im sessionStorage-Schlüssel ablyft_temp_events des Browsers zurückgehalten.
• Der Consent-Status selbst (ablyft_tracking_consent) und eine Redirect-Markierung werden weiterhin gespeichert, weil sie nötig sind, um die Entscheidung zu merken.

Sobald die Einwilligung erteilt ist, werden die zurückgehaltenen Daten in den konfigurierten Speicher verschoben und die Events gesendet.

Schritt 1: Die Regeln in ABlyft setzenCopy Anchor Link

1. Öffne dein Project und gehe zu Settings → Prerequisites ("Project Prerequisites").
2. Bearbeite die beiden Code-Felder. Jedes ist der Rumpf einer JavaScript-Funktion. Gib true zurück, um die Stufe zu erlauben.

Eine leere Regel zählt als true. Wirft dein Code einen Fehler, wird der Fehler geloggt und die Regel gilt als nicht erfüllt.

Beispiel: Variations immer anzeigen und nur nach der Einwilligung tracken. Das sind die Beispiele, die auf der Prerequisites-Seite angezeigt werden.

Show Variations (General Startup)

if (ablyft.get('trackingConsentEnabled') !== false) {
  return true;
}

Start Tracking (and Browser Storage)

return ablyft.get('trackingConsentEnabled');

ablyft.get('trackingConsentEnabled') gibt nach enableTrackingConsent true zurück, nach disableTrackingConsent false und einen leeren Wert, solange der Visitor noch nicht entschieden hat. Deshalb verwendet die erste Regel !== false: Variations werden angezeigt, bis der Visitor ausdrücklich ablehnt.

Wenn du bei Show Variations false zurückgibst, führt ABlyft bei diesem Seitenaufruf keine Experiments aus.

Schritt 2: ABlyft über die Entscheidung informierenCopy Anchor Link

Rufe diese Aufrufe aus dem Consent-Callback deines Consent Managers auf. Die Aufrufe funktionieren auch, bevor das Snippet geladen wurde.

window.ablyft = window.ablyft || [];

// Visitor accepted
window.ablyft.push({ eventType: 'enableTrackingConsent' });

// Visitor declined
window.ablyft.push({ eventType: 'disableTrackingConsent' });

Was die einzelnen Aufrufe bewirken, steht unter enableTrackingConsent und disableTrackingConsent.

Beispiel mit einem generischen Consent ManagerCopy Anchor Link

Die meisten Consent Manager können JavaScript ausführen, wenn der Visitor zustimmt oder ablehnt, oder stellen einen Status bereit, den du auslesen kannst. Die genaue API unterscheidet sich je Produkt, daher sind die Namen onConsentChange und hasStatisticsConsent unten Platzhalter für die Funktionen deines Consent Managers.

<script>
  window.ablyft = window.ablyft || [];

  function syncAblyftConsent(hasConsent) {
    window.ablyft.push({
      eventType: hasConsent ? 'enableTrackingConsent' : 'disableTrackingConsent',
    });
  }

  // 1. Remember the decision of returning visitors
  if (typeof hasStatisticsConsent === 'function' && hasStatisticsConsent()) {
    syncAblyftConsent(true);
  }

  // 2. React when the visitor decides
  if (typeof onConsentChange === 'function') {
    onConsentChange(function (consent) {
      syncAblyftConsent(consent.statistics === true);
    });
  }
</script>

Prüfen, ob es funktioniertCopy Anchor Link

1. Öffne deine Website in einem privaten Fenster, ohne einzuwilligen.
2. Führe in der Konsole ablyft.get('trackingConsentEnabled') aus. Es gibt einen leeren Wert zurück.
3. Stimme in deinem Consent Manager zu und führe es erneut aus. Es gibt true zurück.
4. Schalte den Debug-Modus ein. Die Konsole zeigt dann, ob die allgemeinen Prerequisite-Regeln und die Tracking-Regeln erfüllt sind.

Nächste SchritteCopy Anchor Link