DokumentationExperience PlatformWeb SDK-Anleitung

setConsent

Last update: Tue Mar 05 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Erstellt für:

  • Developer

Die setConsent gibt dem Web SDK an, ob es Daten senden (Opt-in), Daten verwerfen (Opt-out) oder verwenden soll defaultConsent (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. Sie können die setConsent -Befehl bei jedem Laden der Seite. Das Web SDK führt nur dann einen Server-Aufruf durch, wenn sich die Zustimmung ändert.

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.

  1. Anmelden bei experience.adobe.com mit Ihren Adobe ID-Anmeldedaten.
  2. Navigieren Sie zu Datenerfassung > Tags.
  3. Wählen Sie die gewünschte Tag-Eigenschaft aus.
  4. Navigieren Sie zu Regeln und wählen Sie dann die gewünschte Regel aus.
  5. under Aktionen, wählen Sie eine vorhandene Aktion aus oder erstellen Sie eine Aktion.
  6. Legen Sie die Erweiterung Dropdown-Feld zu Adobe Experience Platform Web SDK und legen Sie die Aktionstyp nach Einverständnis festlegen.
  7. Legen Sie die gewünschten Felder rechts fest, einschließlich Standard und Allgemeine Zustimmung.
  8. Klicks Änderungen beibehalten und führen Sie dann Ihren Veröffentlichungs-Workflow aus.

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

Festlegen der Zustimmung mithilfe der Web SDK-JavaScript-Bibliothek

Führen Sie die setConsent beim Aufruf Ihrer konfigurierten Instanz des Web SDK. Sie können die folgenden Objekte in diesen Befehl einfügen:

  • consent[]: Ein Array von consent Objekte. Das Objekt für die Zustimmung wird je nach gewähltem Standard und Version unterschiedlich formatiert.
  • identityMap: Ein Objekt, das steuert, wie eine ECID generiert wird und an welche IDs die Einwilligungsinformationen gebunden sind. Adobe empfiehlt, dieses Objekt einzuschließen, wenn setConsent vor anderen Befehlen ausgeführt wird, z. B. sendEvent.
  • edgeConfigOverrides: Ein Objekt, das Überschreibungen der Datenspeicherkonfiguration.
Adobe 2.0

  • standard: Der von Ihnen ausgewählte Zustimmungsstandard. Legen Sie diese Eigenschaft auf "Adobe" für den Adobe 2.0-Standard.

  • version: Eine Zeichenfolge, die die Version des Zustimmungsstandards darstellt. Legen Sie diese Eigenschaft auf "2.0" für den Adobe 2.0-Standard.

  • value: Ein Objekt, das Zustimmungswerte enthält.

    • value.collect.val: Der Zustimmungswert. Gültige Werte sind "y" (Opt-in) "n" (Abmeldung).
    • value.metadata.time: Der Zeitstempel, mit dem der Benutzer den Zustimmungswert festlegt.
code language-js 
alloy("setConsent", {
  "consent": [{
    "standard": "Adobe",
    "version": "2.0",
    "value": {
      "collect": {
        "val": "y"
      },
      "metadata": {
        "time": "YYYY-03-17T15:48:42-07:00"
      }
    }
  }]
});
IAB TCF 2.0
  • standard: Der von Ihnen ausgewählte Zustimmungsstandard. Legen Sie diese Eigenschaft auf "IAB TCF" für den IAB TCF 2.0-Standard.
  • version: Eine Zeichenfolge, die die Version des Zustimmungsstandards darstellt. Legen Sie diese Eigenschaft auf "2.0" für den IAB TCF 2.0-Standard.
  • value: Eine Zeichenfolge, die den Zustimmungswert enthält.
  • gdprApplies: Ein boolescher Wert, der bestimmt, ob die DSGVO für diesen Zustimmungswert gilt. Der Standardwert lautet true.
  • gdprContainsPersonalData: Ein boolescher Wert, der bestimmt, ob die mit diesem Benutzer verknüpften Ereignisdaten personenbezogene Daten enthalten. Der Standardwert lautet false.
code language-js 
alloy("setConsent", {
  consent: [{
    "standard": "IAB TCF",
    "version": "2.0",
    "value": "CO052l-O052l-DGAMBFRACBgAIBAAAAABIYgEawAQEagAAAA",
    "gdprApplies": true,
    "gdprContainsPersonalData": true
  }]
});
Adobe 1.0
  • standard: Der von Ihnen ausgewählte Zustimmungsstandard. Legen Sie diese Eigenschaft auf "Adobe" für den Adobe 1.0-Standard.
  • version: Eine Zeichenfolge, die die Version des Zustimmungsstandards darstellt. Legen Sie diese Eigenschaft auf "1.0" für den Adobe 1.0-Standard.
  • value.general: Der Zustimmungswert. Gültige Werte sind "in" (Opt-in) "out" (Abmeldung).
code language-js 
// Set consent using the Adobe 1.0 standard
alloy("setConsent", {
  "consent": [{
    "standard": "Adobe",
    "version": "1.0",
    "value": {
      "general": "in"
    }
  }]
});
recommendation-more-help
ad108910-6329-42f1-aa1d-5920a2b13636