setConsent
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:
-
Adobe-Standard: Sowohl 1.0- als auch 2.0-Standards werden unterstützt.
-
IAB Transparency & Consent Framework: Wenn Sie diesen Standard verwenden, wird das Echtzeit-Kundenprofil des Besuchers mit den Zustimmungsinformationen aktualisiert, wenn Ihre Implementierung richtig konfiguriert ist:
- Das individuelle XDM-Profilschema enthält die IAB TCF 2.0-Feldergruppe "Einwilligung".
- Das Schema Erlebnisereignis enthält die IAB TCF 2.0-Feldergruppe "Einwilligung".
- Sie fügen die IAB-Zustimmungsinformationen in das Ereignis ein. XDM-Objekt. Das Web SDK enthält beim Senden von Ereignisdaten nicht automatisch die Zustimmungsinformationen.
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.
Verwenden defaultConsent
zusammen mit setConsent
using-consent
Das Web SDK bietet zwei komplementäre Konfigurationsbefehle für die Zustimmung:
defaultConsent
: Dieser Befehl dient zum Erfassen der Zustimmungsvoreinstellungen von Adobe-Kunden, die das Web SDK verwenden.setConsent
: Mit diesem Befehl können Sie die Zustimmungsvoreinstellungen Ihrer Site-Besucher erfassen.
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.
in
in
in
out
in
pending
in
pending
out
pending
out
in
out
out
out
Die folgenden Cookies werden gesetzt, wenn die Konfiguration der Zustimmung Folgendes zulässt:
idMigrationEnabled
aktiviert ist. Dies ist beim Übergang zum Web SDK hilfreich, während einige Teile der Site weiterhin verwenden visitor.js
.s_ecid=MCMID|<ECID>
.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.
- Anmelden bei experience.adobe.com mit Ihren Adobe ID-Anmeldedaten.
- Navigieren Sie zu Datenerfassung > Tags.
- Wählen Sie die gewünschte Tag-Eigenschaft aus.
- Navigieren Sie zu Regeln und wählen Sie dann die gewünschte Regel aus.
- under Aktionen, wählen Sie eine vorhandene Aktion aus oder erstellen Sie eine Aktion.
- Legen Sie die Erweiterung Dropdown-Feld zu Adobe Experience Platform Web SDK und legen Sie die Aktionstyp nach Einverständnis festlegen.
- Legen Sie die gewünschten Felder rechts fest, einschließlich Standard und Allgemeine Zustimmung.
- 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 vonconsent
Objekte. Das Objekt für die Zustimmung wird je nach gewähltem Standard und Version unterschiedlich formatiert. Auf den folgenden Registerkarten finden Sie Beispiele für jedes Einverständnisobjekt, je nach Zustimmungsstandard.identityMap
: Ein Objekt, das steuert, wie eine ECID generiert wird und an welche IDs die Einwilligungsinformationen gebunden sind. Adobe empfiehlt, dieses Objekt einzuschließen, wennsetConsent
vor anderen Befehlen ausgeführt wird, z. B.sendEvent
.edgeConfigOverrides
: Ein Objekt, das Überschreibungen der Datenspeicherkonfiguration.
Adobe 2.0-Standard consent
Objekt
Wenn Sie Adobe Experience Platform verwenden, müssen Sie eine Datenschutzschema-Feldergruppe in Ihr Profilschema aufnehmen. Siehe Governance, Datenschutz und Sicherheit in Adobe Experience Platform für weitere Informationen zum Adobe 2.0-Standard. Sie können Daten innerhalb des Wertobjekts hinzufügen, die dem Schema des consents
des Einverständnis und Voreinstellungen Profilfeldgruppe.
-
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. Legen Sie hier fest"y"
, wenn sich Benutzer anmelden und"n"
, wenn Benutzer sich abmelden.value.metadata.time
: Der Zeitstempel, mit dem Benutzer ihre Zustimmungseinstellungen zuletzt aktualisiert haben.
code language-js |
---|
|
IAB TCF 2.0-Standard consent
Objekt
Legen Sie die Zustimmungszeichenfolge wie unten dargestellt fest, um die über den IAB Transparency and Consent Framework (TCF)-Standard (Interactive Advertising Bureau Europe) bereitgestellten Zustimmungsvoreinstellungen der Benutzer aufzuzeichnen.
Wenn die Zustimmung auf diese Weise festgelegt wird, wird das Echtzeit-Kundenprofil mit den Zustimmungsinformationen aktualisiert. Dazu muss das Profil-XDM-Schema die Feldergruppe zum Profildatenschutzschema. Beim Senden von Ereignissen müssen die IAB-Zustimmungsinformationen manuell zum Ereignis-XDM-Objekt hinzugefügt werden. Das Web SDK nimmt die Zustimmungsinformationen nicht automatisch in die Ereignisse auf.
Um die Einwilligungsinformationen in Ereignissen zu senden, müssen Sie die Feldergruppe "Erlebnisereignis-Datenschutz"zu Ihrer Profile-enabled XDM ExperienceEvent Schema. Siehe Abschnitt zu Aktualisieren des ExperienceEvent-Schemas Anweisungen zur Konfiguration finden Sie im Leitfaden zur Datensatzvorbereitung .
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 lautettrue
.gdprContainsPersonalData
: Ein boolescher Wert, der bestimmt, ob die mit diesem Benutzer verknüpften Ereignisdaten personenbezogene Daten enthalten. Der Standardwert lautetfalse
.
code language-js |
---|
|
Adobe 1.0-Standard consent
Objekt
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. Legen Sie hier fest"in"
, wenn sich Benutzer anmelden und"out"
, wenn Benutzer sich abmelden.
code language-js |
---|
|
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 die Benutzereinstellungen mithilfe der setConsent
festgelegt ist, 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. 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 Voreinstellungen geändert haben.
Synchronisieren von Identitäten beim Festlegen der Zustimmung sync-identities
Wenn die Standardzustimmung (festgelegt über die defaultConsent Parameter) auf pending
oder out
, die setConsent
-Einstellung kann die erste Anfrage sein, die gesendet wird und die Identität festlegt. Daher kann es wichtig sein, Identitäten bei der ersten Anfrage zu synchronisieren. Sie können die Identitätszuordnung zum setConsent
-Befehl wie auf der sendEvent
Befehl. Siehe Verwenden von identityMap ein Beispiel dafür, wie Sie die Identitätszuordnung in Ihren Befehl einbeziehen.