Auf dieser Seite wird die ServerSDK-setConsent beschrieben. Informationen zu Web SDK finden Sie unter setConsent.
Die setConsent-Methode teilt dem Server-SDK mit, ob er Daten an einen Besucher senden kann (Opt-in) oder verwerfen muss (Opt-out). Die SDK sendet die Präferenzen der Besucherin bzw. des Besuchers an die Edge Network und speichert dann das Ergebnis im kndctr_<orgId>_consent Cookie über den Cookie-Service, den Sie an forRequest übergeben.
SDK unterstützt die folgenden Einverständnisstandards:
- Adobe Standard: Versionen 1.0 und 2.0.
- IAB Transparency & Consent Framework (TCF): Version 2.0.
Diese Methode ist nur verfügbar, wenn die -Instanz die Einverständniskomponente enthält, die createInstance standardmäßig enthält.
Aufrufen von setConsent für einen Besucher call
Das Einverständnis gehört zu einem einzelnen Besucher. Rufen Sie daher immer setConsent auf dem forRequest des Besuchers auf, nie in der Instanz auf oberster Ebene. Im folgenden Beispiel wird der Adobe 2.0-Standard verwendet:
const visitor = alloy.forRequest({ request: req, cookie: visitorCookies });
await visitor.setConsent({
consent: [{
standard: "Adobe",
version: "2.0",
value: {
collect: { val: "y" }
}
}]
});
Im folgenden Beispiel wird der Adobe 1.0-Standard verwendet:
await visitor.setConsent({
consent: [{
standard: "Adobe",
version: "1.0",
value: { general: "in" }
}]
});
Im folgenden Beispiel wird der IAB TCF 2.0-Standard verwendet:
await visitor.setConsent({
consent: [{
standard: "IAB TCF",
version: "2.0",
value: "CO052l-O052l-DGAMBFRACBgAIBAAAAAAIYgEawAQEagAAAA",
gdprApplies: true
}]
});
Wenn Sie den IAB-TCF-Standard verwenden und Einverständnisdaten zum Besucherprofil benötigen, schließen Sie die IAB-Einverständnisinformationen auch in das xdm ein. SDK fügt sie nicht automatisch zu Ereignissen hinzu.
Wie Einverständnis gespeichert wird stored-consent
Der SDK liest und schreibt das Einverständnis-Cookie über den cookie-Service, den Sie an forRequest übergeben:
- Wenn Ihr Cookie-Dienst die Browser-Cookies des Besuchers liest gilt bereits die Einwilligung, dass der Besucher zuvor, auf dem Server oder im Browser mit der Web-SDK aufgezeichnet hat. Sie müssen
setConsenterst dann erneut anrufen, wenn sich die Präferenzen des Besuchers ändern. - Wenn Sie keinen Cookie-Dienst übergeben kann sich die SDK nicht an die Einverständniserklärungen zwischen den Anfragen erinnern. Jede Anfrage beginnt am
defaultConsent.
Die SDK überspringt die Anfrage, wenn sie bereits dieselben Voreinstellungen für den Besucher gesendet hat. Es verfolgt die Voreinstellungen, die über den storage-Service gesendet wurden, sodass diese Prüfung nur dann anforderungsübergreifend funktioniert, wenn Sie den storage-Service Besuchers an forRequest übergeben. Andernfalls sendet jeder Aufruf eine Anfrage an die Edge Network, selbst wenn sich die Präferenzen des Besuchers nicht geändert haben. Rufen Sie setConsent auf, wenn der Besucher eine Einverständnisentscheidung trifft oder ändert, und nicht bei jeder Anfrage.
Die Anfrage ist nicht authentifiziert. Stellen Sie sicher, dass Ihr Datenstrom nicht authentifizierte Anfragen akzeptiert. Siehe Festlegen des Datenstromzugriffstyps.
Optionen options
Die setConsent-Methode akzeptiert ein -Objekt mit den folgenden Eigenschaften:
consent: Erforderlich. Ein Array von Einverständnisobjekten, jedes in einem der unterstützten Standards.identityMap: Eine Identitätszuordnung für den Besucher. Edge Network wendet das Einverständnis auf Geräteebene an und verwendet daher nur dieECIDaus dieser Zuordnung.edgeConfigOverrides: Ein Datenstromkonfigurations-Überschreibungsobjekt für diese Anfrage.
Ergebnisobjekt result
Die setConsent-Methode gibt eine Zusage zurück, die mit einem leeren Objekt aufgelöst wird, wenn die Edge Network die Einverständnisvoreinstellungen akzeptiert.