In diesem Handbuch wird gezeigt, wie das Interactive Advertising Bureau Transparency & Consent Framework, Version 2.0 (IAB TCF 2.0), ohne Tags mit dem Adobe Experience Platform Web SDK integriert werden kann. Eine Übersicht über die Integration mit IAB TCF 2.0 finden Sie im Abschnitt Übersicht. Eine Anleitung zur Integration mit Tags finden Sie im Abschnitt IAB TCF 2.0-Handbuch für Tags.
In diesem Handbuch werden die __tcfapi
-Schnittstelle für den Zugriff auf die Zustimmungsinformationen. Die direkte Integration mit Ihrem Cloud Management-Provider (CMP) kann für Sie einfacher sein. Die Informationen in diesem Handbuch können jedoch weiterhin nützlich sein, da die CMPs im Allgemeinen ähnliche Funktionen wie die TCF-API bieten.
Bei diesen Beispielen wird davon ausgegangen, dass zum Zeitpunkt der Ausführung des Codes window.__tcfapi
wird auf der Seite definiert. CMPs können einen Hook bereitstellen, mit dem Sie diese Funktionen ausführen können, wenn die __tcfapi
-Objekt bereit ist.
Um das IAB TCF 2.0 mit Tags und die Adobe Experience Platform Web SDK-Erweiterung zu verwenden, benötigen Sie ein XDM-Schema. Wenn Sie keines dieser beiden Optionen eingerichtet haben, sehen Sie sich diese Seite an, bevor Sie fortfahren.
Darüber hinaus setzt dieses Handbuch ein Verständnis des Adobe Experience Platform Web SDK voraus. Für einen schnellen Auffrischungskurs lesen Sie bitte die Übersicht über das Adobe Experience Platform Web SDK und Häufig gestellte Fragen Dokumentation.
Wenn Sie alle unbekannten Benutzer gleich behandeln möchten, können Sie die Standardzustimmung auf pending
oder out
. Dadurch werden Erlebnisereignisse in die Warteschlange gestellt oder verworfen, bis Zustimmungseinstellungen empfangen wurden.
Weitere Informationen zur Standardzustimmung finden Sie im Abschnitt Standardzustimmungsabschnitt in der Dokumentation zur Platform Web SDK-Konfiguration.
gdprApplies
Einige CMPs bieten die Möglichkeit festzustellen, ob die Datenschutz-Grundverordnung (DSGVO) für den Kunden gilt. Wenn Sie die Zustimmung für Kunden übernehmen möchten, für die die DSGVO nicht gilt, können Sie die gdprApplies
-Markierung im TCF-API-Aufruf.
Das folgende Beispiel zeigt eine Möglichkeit, dies zu tun:
var alloyConfiguration = { ... };
window.__tcfapi('getTCData', 2, function (tcData, success) {
if (success) {
alloyConfiguration.defaultConsent = tcData.gdprApplies ? "pending" : "in";
window.alloy("configure", alloyConfiguration);
}
});
In diesem Beispiel wird die configure
aufgerufen wird, nachdem tcData
wird von der TCF-API abgerufen. Wenn gdprApplies
auf "true"gesetzt ist, wird die Standardzustimmung auf pending
. Wenn gdprApplies
ist "false", ist die standardmäßige Zustimmung auf in
. Vergewissern Sie sich, dass Sie die alloyConfiguration
mit Ihrer Konfiguration.
Wenn die standardmäßige Zustimmung auf in
, die setConsent
kann weiterhin verwendet werden, um die Zustimmungsvoreinstellungen Ihrer Kunden aufzuzeichnen.
Die IAB TCF 2.0-API stellt ein Ereignis für den Zeitpunkt bereit, zu dem die Zustimmung vom Kunden aktualisiert wird. Dies geschieht, wenn der Kunde seine Voreinstellungen anfänglich festlegt und wenn der Kunde seine Voreinstellungen aktualisiert.
Das folgende Beispiel zeigt eine Möglichkeit, dies zu tun:
const identityMap = { ... };
window.__tcfapi('addEventListener', 2, function (tcData, success) {
if (success && tcData.eventStatus === 'useractioncomplete') {
window.alloy("setConsent", {
identityMap,
consent: [
{
standard: "IAB TCF",
version: "2.0",
value: tcData.tcString,
gdprApplies: tcData.gdprApplies
}
]
});
}
});
Dieser Codeblock überwacht die useractioncomplete
-Ereignis und legt dann die Zustimmung fest, wobei die Zustimmungszeichenfolge und die gdprApplies
Markierung. Wenn Sie benutzerdefinierte Identitäten für Ihre Kunden haben, füllen Sie identityMap
-Variable. Weitere Informationen finden Sie im Handbuch Zustimmung für weitere Informationen zum Aufruf von setConsent
.
In XDM-Schemas können Sie Informationen zu Zustimmungsvoreinstellungen aus Experience Events speichern. Es gibt zwei Möglichkeiten, diese Informationen zu jedem Ereignis hinzuzufügen.
Zuerst können Sie das relevante XDM-Schema für jede sendEvent
aufrufen. Das folgende Beispiel zeigt eine Möglichkeit, dies zu tun:
var sendEventOptions = { ... };
window.__tcfapi('getTCData', 2, function (tcData, success) {
if (success) {
sendEventOptions.xdm.consentStrings = [{
consentStandard: "IAB TCF"
consentStandardVersion: "2.0"
consentStringValue: tcData.tcString,
gdprApplies: tcData.gdprApplies
}];
window.alloy("sendEvent", sendEventOptions);
}
});
Dieses Beispiel ruft die Zustimmungsinformationen für die TCF-API ab und sendet dann ein Ereignis mit den Zustimmungsinformationen, die zum XDM-Schema hinzugefügt wurden. Siehe Tracking-Ereignisse Anleitung, um zu verstehen, was im sendEvent
Befehlsoptionen.
Die andere Möglichkeit, die Zustimmungsinformationen zu jeder Anfrage hinzuzufügen, ist mit der onBeforeEventSend
Callback. Lesen Sie den Abschnitt unter Globale Änderung von Ereignissen Weitere Informationen dazu finden Sie in der Dokumentation zu Tracking-Ereignissen .
Nachdem Sie nun gelernt haben, wie Sie IAB TCF 2.0 mit der Platform Web SDK-Erweiterung verwenden, können Sie auch mit anderen Adobe-Lösungen wie Adobe Analytics oder Adobe Real-time Customer Data Platform integrieren. Siehe Übersicht über das IAB Transparency & Consent Framework 2.0 für weitere Informationen.