Integrieren der IAB TCF 2.0-Unterstützung in das Platform Web SDK

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.

Erste Schritte

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.

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.

Standardzustimmung aktivieren

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.

Festlegen der Standardzustimmung basierend auf 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.

Verwenden des Ereignisses setConsent

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.

Einschließen von Einwilligungsinformationen in sendEvent

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 .

Nächste Schritte

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.