Integrieren der IAB TCF 2.0-Unterstützung mithilfe von Tags und der Platform Web SDK-Erweiterung

Adobe Experience Platform Web SDK unterstützt das Interactive Advertising Bureau Transparency & Consent Framework, Version 2.0 (IAB TCF 2.0). In diesem Handbuch erfahren Sie, wie Sie eine Tag-Eigenschaft zum Senden von IAB TCF 2.0-Zustimmungsinformationen an Adobe mithilfe der Adobe Experience Platform Web SDK-Tag-Erweiterung einrichten.

Wenn Sie keine Tags verwenden möchten, lesen Sie bitte das Handbuch unter Verwendung von IAB TCF 2.0 ohne Tags.

Erste Schritte

Um das IAB TCF 2.0 mit Tags und der Platform Web SDK-Erweiterung verwenden zu können, müssen Sie über ein XDM-Schema und einen Datensatz verfügen.

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.

Festlegen der Standardzustimmung

In der Erweiterungskonfiguration gibt es eine Einstellung für die Standardzustimmung. Dadurch wird das Verhalten von Kunden gesteuert, die kein Zustimmungs-Cookie haben. Wenn Sie Erlebnisereignisse für Kunden in die Warteschlange stellen möchten, die kein Zustimmungscookie haben, setzen Sie dies auf pending. Wenn Sie Erlebnisereignisse für Kunden verwerfen möchten, die kein Zustimmungs-Cookie haben, setzen Sie dies auf out. Sie können auch ein Datenelement verwenden, um den standardmäßigen Zustimmungswert dynamisch festzulegen. Siehe defaultConsent für weitere Informationen.

Profil mit Zustimmungsinformationen aktualisieren consent-code-1

So rufen Sie die setConsent Wenn sich die Zustimmungseinstellungen Ihrer Kunden geändert haben, erstellen Sie eine Tag-Regel. Fügen Sie zunächst ein neues Ereignis hinzu und wählen Sie den Ereignistyp "Benutzerspezifischer Code"der Haupterweiterung aus.

Verwenden Sie das folgende Code-Beispiel für Ihr neues Ereignis:

// Wait for window.__tcfapi to be defined, then trigger when the customer has completed their consent and preferences.
function addEventListener() {
  if (window.__tcfapi) {
    window.__tcfapi("addEventListener", 2, function (tcData, success) {
      if (success && tcData.eventStatus === "useractioncomplete") {
        // save the tcData.tcString in a data element
        _satellite.setVar("IAB TCF Consent String", tcData.tcString);
        _satellite.setVar("IAB TCF Consent GDPR", tcData.gdprApplies);
        trigger();
      }
    });
  } else {
    // window.__tcfapi wasn't defined. Check again in 100 milliseconds
    setTimeout(addEventListener, 100);
  }
}
addEventListener();

Dieser benutzerspezifische Code umfasst zwei Dinge:

Erstellen eines XDM-Datenelements für Erlebnisereignisse

Die Zustimmungszeichenfolge sollte im XDM-Erlebnisereignis enthalten sein. Verwenden Sie dazu das Datenelement "XDM-Objekt". Erstellen Sie zunächst ein neues XDM-Objekt-Datenelement oder verwenden Sie alternativ eines, das Sie bereits zum Senden von Ereignissen erstellt haben. Wenn Sie Ihrem Schema die Feldergruppe "Erlebnisereignis-Datenschutz"hinzugefügt haben, sollte Ihnen eine consentStrings -Schlüssel im XDM-Objekt.

Senden eines ersten Erlebnisereignisses mit IAB TCF 2.0-Einverständnisinformationen

Wenn das anfängliche Erlebnisereignis auf der Seite mit einem Seitenladeereignis ausgelöst wird, wurde die Zustimmungszeichenfolge möglicherweise noch nicht geladen. Diese Regel soll das aktuelle Seitenladeereignis ersetzen. Um sicherzustellen, dass die Zustimmungsinformationen zuerst geladen werden, erstellen Sie eine neue Regel und fügen Sie den folgenden Code als benutzerspezifisches Code-Ereignis hinzu:

// Wait for window.__tcfapi to be defined, then trigger when there is a consent string
function addEventListener() {
  if (window.__tcfapi) {
    window.__tcfapi("addEventListener", 2, function (tcData, success) {
      if (success && (tcData.eventStatus === "useractioncomplete" || tcData.eventStatus === "tcloaded")) {
        // save the tcData.tcString in a data element
        _satellite.setVar("IAB TCF Consent String", tcData.tcString);
        _satellite.setVar("IAB TCF GDPR Applies", tcData.gdprApplies);
        trigger();
      }
    });
  } else {
    // window.__tcfapi wasn"t defined. Check again in 100 milliseconds
    setTimeout(addEventListener, 100);
  }
}
addEventListener();

Dieser Code ist mit dem vorherigen benutzerspezifischen Code identisch, mit dem Unterschied, dass beide useractioncomplete und tcloaded -Ereignisse verarbeitet werden. Die vorheriger benutzerspezifischer Code nur Trigger, in denen der Kunde seine Voreinstellungen zum ersten Mal auswählt. Dieser Code Trigger auch dann, wenn der Kunde seine Voreinstellungen bereits ausgewählt hat. Beispielsweise beim zweiten Laden der Seite.

Fügen Sie die Aktion "Ereignis senden"aus der Platform Web SDK-Erweiterung hinzu. Wählen Sie im XDM-Feld das XDM-Datenelement aus, das Sie im vorherigen Abschnitt erstellt haben.

Senden anderer Ereignisse mit IAB TCF 2.0-Zustimmungsinformationen

Wenn Ereignisse nach dem ersten Erlebnisereignis ausgelöst werden, sind die beiden Datenelemente weiterhin definiert und können zum Senden der IAB-Zustimmungsinformationen verwendet werden. Verwenden Sie dasselbe XDM-Datenelement, um zukünftige Ereignisse zu senden. IAB TCF 2.0-Informationen sind enthalten.

Nächste Schritte

Nachdem Sie jetzt 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.