setConsent

Der Befehl setConsent teilt dem Web SDK mit, ob es Daten senden (Opt-in), Daten verwerfen (Opt-out) oder defaultConsent verwenden soll (Einverständnis unbekannt).

Das Web SDK unterstützt die folgenden Standards:

Nach Verwendung dieses Befehls schreibt das Web SDK die Voreinstellungen des Benutzers in ein Cookie. Wenn der Benutzer das nächste Mal Ihre Website im Browser lädt, ruft das SDK diese beibehaltenen Voreinstellungen ab, um zu bestimmen, ob Ereignisse an Adobe gesendet werden können.

Adobe empfiehlt, dass Sie alle Voreinstellungen für das Einwilligungsdialogfeld getrennt von der Web SDK-Zustimmung speichern. Das Web SDK bietet keine Möglichkeit, die Zustimmung abzurufen. Um sicherzustellen, dass die Benutzereinstellungen mit dem SDK synchronisiert bleiben, können Sie bei jedem Laden der Seite den Befehl setConsent aufrufen. Das Web SDK führt nur dann einen Server-Aufruf durch, wenn sich die Zustimmung ändert.

Verwenden von defaultConsent zusammen mit setConsent using-consent

Das Web SDK bietet zwei komplementäre Konfigurationsbefehle für die Zustimmung:

Wenn diese Einstellungen zusammen verwendet werden, können sie je nach konfigurierten Werten zu unterschiedlichen Ergebnissen bei der Datenerfassung und Cookie-Einstellung führen.

Die nachstehende Tabelle zeigt, wann und wann Cookies basierend auf den Zustimmungseinstellungen erfasst werden.

Die folgenden Cookies werden gesetzt, wenn die Konfiguration der Zustimmung Folgendes zulässt:

Festlegen der Zustimmung mithilfe der Web SDK-Tag-Erweiterung

Das Festlegen der Zustimmung wird als Aktion innerhalb einer Regel in der Adobe Experience Platform-Oberfläche für Datenerfassungs-Tags durchgeführt.

Sie können in diese Aktion mehrere Zustimmungsobjekte einfügen.

Festlegen der Zustimmung mithilfe der Web SDK JavaScript-Bibliothek

Führen Sie den Befehl setConsent aus, wenn Sie Ihre konfigurierte Instanz des Web SDK aufrufen. Sie können die folgenden Objekte in diesen Befehl einfügen:

// Set consent using the Adobe 2.0 standard
alloy("setConsent", {
  "consent": [{
    "standard": "Adobe",
    "version": "2.0",
    "value": {
      "collect": {
        "val": "y"
      },
      "metadata": {
        "time": "YYYY-03-17T15:48:42-07:00"
      }
    }
  }]
});

// Set consent using the IAB TCF 2.0 standard
alloy("setConsent", {
  consent: [{
    "standard": "IAB TCF",
    "version": "2.0",
    "value": "CO052l-O052l-DGAMBFRACBgAIBAAAAABIYgEawAQEagAAAA",
    "gdprApplies": true,
    "gdprContainsPersonalData": true
  }]
});

// Set consent using the Adobe 1.0 standard
alloy("setConsent", {
  "consent": [{
    "standard": "Adobe",
    "version": "1.0",
    "value": {
      "general": "in"
    }
  }]
});

Senden mehrerer Standards in einer Anfrage multiple-standards

Das Web SDK unterstützt auch das Senden von mehr als einem Zustimmungsobjekt in einer Anfrage, wie im folgenden Beispiel gezeigt.

alloy("setConsent", {
    consent: [{
        standard: "Adobe",
        version: "2.0",
        value: {
            collect: {
                val: "y"
            },
            metadata: {
                time: "2021-03-17T15:48:42-07:00"
            }
        }
    }, {
        standard: "IAB TCF",
        version: "2.0",
        value: "CO1Z4yuO1Z4yuAcABBENArCsAP_AAH_AACiQGCNX_T5eb2vj-3Zdt_tkaYwf55y3o-wzhhaIse8NwIeH7BoGP2MwvBX4JiQCGBAkkiKBAQdtHGhcCQABgIhRiTKMYk2MjzNKJLJAilsbe0NYCD9mnsHT3ZCY70--u__7P3fAwQgkwVLwCRIWwgJJs0ohTABCOICpBwCUEIQEClhoACAnYFAR6gAAAIDAACAAAAEEEBAIABAAAkIgAAAEBAKACIBAACAEaAhAARIEAsAJEgCAAVA0JACKIIQBCDgwCjlACAoAAAAA.YAAAAAAAAAAA",
        gdprApplies: true
    }]
});

Beständigkeit der Zustimmungseinstellungen persistence

Nachdem Sie dem Web SDK mithilfe des Befehls setConsent Benutzereinstellungen mitgeteilt haben, behält das SDK Benutzereinstellungen in einem Cookie bei. Wenn der Benutzer das nächste Mal Ihre Website im Browser lädt, ruft das Web SDK diese beibehaltenen Voreinstellungen ab und verwendet sie, um zu bestimmen, ob Ereignisse an Adobe gesendet werden können oder nicht.

Sie müssen die Benutzereinstellungen unabhängig speichern, um das Dialogfeld "Einverständnis"mit den aktuellen Voreinstellungen anzeigen zu können. Es gibt keine Möglichkeit, die Benutzereinstellungen vom Web SDK abzurufen. Um sicherzustellen, dass die Benutzereinstellungen mit dem SDK synchronisiert bleiben, können Sie bei jedem Laden der Seite den Befehl setConsent aufrufen. Das Web SDK führt nur dann einen Server-Aufruf durch, wenn sich die Voreinstellungen geändert haben.

Synchronisieren von Identitäten beim Festlegen der Zustimmung sync-identities

Wenn die Standardzustimmung (festgelegt durch den Parameter defaultConsent ) auf pending oder out festgelegt ist, kann die Einstellung setConsent die erste ausgehende Anfrage sein, die zur Identitätsfeststellung führt. Daher kann es wichtig sein, Identitäten bei der ersten Anfrage zu synchronisieren. Sie können die Identitätszuordnung dem Befehl setConsent hinzufügen, genau wie beim Befehl sendEvent . Unter Verwenden von identityMap finden Sie ein Beispiel dafür, wie Sie die Identitätszuordnung in Ihren Befehl einbeziehen.