Voraussetzungen

Die Voraussetzungen für die Verwendung der Web-SDK sind hier aufgeführt.

Auf dieser Seite gibt es eine Anforderung für einen „Ereignis-Datensatz“, und genau wie es sich anhört, ist dies ein Datensatz zum Speichern Ihrer Erlebnisereignisdaten. Um Einverständnisinformationen mit Ereignissen zu senden, muss Feldergruppe „IAB TCF 20 Einverständnisdetails“ zu Ihrem Erlebnisereignis-Schema hinzugefügt werden:

Für den Platform Consent Standard v2.0 benötigen wir auch Zugriff auf Adobe Experience Platform, um ein Schema und einen Datensatz mit XDM Individual Profile zu erstellen. Ein Tutorial zur Schemaerstellung finden Sie unter Erstellen eines Schemas mit dem Schema-Editor und für die erforderliche Feldergruppe „Einverständnis und Präferenzdetails“ finden Sie unter Konfigurieren eines Datensatzes zur Erfassung von Einverständnis- und Präferenzdaten.

In diesem Tutorial wird davon ausgegangen, dass Sie Zugriff auf die Datenerfassung haben und eine Client-seitige Tags-Eigenschaft mit installierter Web SDK-Erweiterung und einer für die Entwicklung erstellten Arbeitsbibliothek erstellt haben. Diese Themen werden in diesen Dokumenten detailliert beschrieben:

Außerdem verwenden wir die Chrome-Erweiterung Platform Debugger um unsere Implementierung zu überprüfen und zu validieren.

Um das IAB TCF-Beispiel mit einer CMP auf Ihrer eigenen Site zu implementieren, benötigen Sie Zugriff auf eine CMP wie OneTrust oder SourcePoint, um die von ihnen bereitgestellten Daten zu generieren. Alternativ können Sie einfach hier folgen und die Ergebnisse unten sehen.

Verwenden des Web SDK mit dem Adobe-Einverständnisstandard (v1.0 oder v2.0)

NOTE
Der 1.0-Standard wird schrittweise zugunsten von v2.0 abgeschafft. Mit dem 2.0-Standard können Sie zusätzliche Einverständnisdaten hinzufügen, die zur manuellen Durchsetzung von Einverständnisvoreinstellungen verwendet werden können. Die folgenden Screenshots der Platform Web SDK-Erweiterung stammen aus Version 2.4.0 der Erweiterung, die entweder mit v1.0 oder v2.0 des Adobe-Einverständnisstandards kompatibel ist.

Weitere Informationen zu diesen Standards finden Sie unter Unterstützen von Voreinstellungen für das Kundeneinverständnis.

Schritt 1: Konfigurieren des Einverständnisses in der Web SDK-Erweiterung

Nachdem wir die Platform Web SDK-Erweiterung in einer Tags-Eigenschaft installiert haben, können wir die Optionen für die Adressierung von Einverständnisdaten auf dem Erweiterungskonfigurationsbildschirm konfigurieren:

Im Abschnitt „Datenschutz“ wird die Einverständnisebene für die SDK festgelegt, wenn der Benutzer noch keine Einverständnisvoreinstellungen angegeben hat. Dadurch wird der Standardstatus für die Einverständnis- und Ereignisdatenerfassung in der SDK festgelegt. Die ausgewählte Einstellung beantwortet die Frage: „Was sollte die SDK tun, wenn die Benutzerin bzw. der Benutzer noch keine expliziten Einverständnisvoreinstellungen angegeben hat?“

  • In : Erfassen Sie Ereignisse, die auftreten, bevor die Benutzerin bzw. der Benutzer die Einverständnisvoreinstellungen bereitstellt.
  • Ablegen - Ereignisse, die auftreten, bevor die Benutzerin bzw. der Benutzer Einverständnisvoreinstellungen gibt.
  • Ausstehend : Warteschlangenereignisse, die auftreten, bevor der Benutzer Einverständnisvoreinstellungen bereitstellt.
  • Von Datenelement bereitgestellt

Wenn die standardmäßige Einverständniseinstellung „In“ lautet, weist dies den SDK an, nicht auf ein explizites Einverständnis warten zu sollen, sondern die Ereignisse zu erfassen, die auftreten, bevor der Benutzer Einverständnisvoreinstellungen bereitstellt. Diese Voreinstellungen werden normalerweise in einer CMP verarbeitet und gespeichert.

Wenn die standardmäßige Einverständniseinstellung „Out“ lautet, teilt dies dem SDK mit, dass keine Ereignisse erfasst werden sollten, die auftreten, bevor die Opt-in-Voreinstellungen für Benutzende festgelegt werden. Besucheraktivitäten, die vor dem Festlegen der Einverständnisvoreinstellung stattfinden, werden in keine Daten aufgenommen, die von SDK nach dem Festlegen des Einverständnisses gesendet werden. Wenn Sie beispielsweise scrollen und eine Web-Seite anzeigen, bevor Sie das Einverständnisbanner auswählen, und diese Einstellung „Out“ verwendet wird, werden diese Scroll-Aktivität und die Anzeigezeit nicht gesendet, wenn der Benutzer der Datenerfassung später ausdrücklich zustimmt.

Wenn die Standardeinstellung für das Einverständnis „Ausstehend“ lautet, stellt die SDK alle Ereignisse in die Warteschlange, die auftreten, bevor die Benutzerin bzw. der Benutzer die Einverständnisvoreinstellungen festlegt, sodass die Ereignisse gesendet werden können, nachdem die Einverständnisvoreinstellungen festgelegt wurden und nachdem die SDK bei einem Besuch anfänglich konfiguriert wurde.

Bei dieser Einstellung „Ausstehend“ führt der Versuch, Befehle auszuführen, für die Benutzeranmeldevoreinstellungen erforderlich sind (z. B. den Ereignisbefehl), dazu, dass der Befehl in der SDK in die Warteschlange gestellt wird. Diese Befehle werden erst verarbeitet, nachdem Sie die Nutzeranmeldeeinstellungen an das SDK übermittelt haben.

Sobald eine CMP die Voreinstellungen der Benutzenden erfasst hat, können wir diese Voreinstellungen der SDK mitteilen. In einem späteren Abschnitt unten erfahren Sie, wie Sie diese Opt-in-Daten abrufen und mit der Web SDK-Erweiterung verwenden können.

Mit „Von Datenelement bereitgestellt“ können wir auf ein Datenelement zugreifen, das sämtliche Einverständnisvoreinstellungsdaten enthält, die von benutzerdefiniertem Code oder einer CMP auf Ihrer Site oder in Ihrer Datenschicht erfasst werden. Ein für diesen Zweck verwendetes Datenelement sollte in „ein“, „aus“ oder „ausstehend“ aufgelöst werden.

Hinweis: Diese Konfigurationseinstellung für die SDK wird nicht den Benutzerprofilen beibehalten. Sie dient dazu, das Verhalten der SDK festzulegen, bevor der Besucher seine ausdrückliche Einwilligung erteilt.

Weitere Informationen zum Konfigurieren der Web SDK-Erweiterung finden Sie unter Platform Web SDK-Erweiterung - Übersicht und Unterstützen von Voreinstellungen für die Kundenzustimmung.

Wählen Sie für dieses Beispiel die Option „Ausstehend“ und anschließend "", Ihre Konfigurationseinstellungen zu speichern.

Schritt 2: Kommunikation der Einverständnisvoreinstellungen

Nachdem wir nun das Standardverhalten der SDK festgelegt haben, können wir Tags verwenden, um die expliziten Einverständnisvoreinstellungen eines Besuchers an Platform zu senden. Das Senden von Einverständnisdaten mit dem Adobe 1.0- oder 2.0-Standard kann einfach mithilfe der setConsent-Aktion von Web SDK in Ihren Tag-Regeln implementiert werden.

Erstellen wir eine Regel, um dies zu demonstrieren. Wählen Sie in der Platform-Tag-Eigenschaft Regeln und dann auf der blauen Schaltfläche Regeln hinzufügen aus. Benennen wir die Regel „setAdobeConsent“ und wählen Sie aus, um ein Ereignis hinzuzufügen. Wählen Sie für den Ereignistyp „Window Loaded“, wodurch diese Regel immer dann Trigger wird, wenn eine Seite auf unserer Website geladen wird. Wählen Sie als Nächstes unter „Aktionen“ die Option „Hinzufügen“ aus, um den Aktionskonfigurationsbildschirm zu öffnen. Hier legen wir die Einverständnisdaten fest. Wählen Sie im Dropdown-Menü „Erweiterung“ die Option „Platform Web SDK", dann den Aktionstyp und anschließend „Einverständnis festlegen“ aus.

Wählen Sie unter „Einverständnisinformationen“ die Option „Formular ausfüllen“. In dieser Regelaktion verwenden wir die Web-SDK, um das Einverständnis für den Adobe 1.0-Einverständnisstandard festzulegen, indem wir das angezeigte Formular ausfüllen:

Mit dieser Aktion „Einverständnis festlegen“ können wir „In“, „Out“ oder „Von Datenelement bereitgestellt“ übergeben. Ein Datenelement hier sollte in „in“ oder „out“ aufgelöst werden.

In diesem Beispiel wählen wir „In“ aus, um anzugeben, dass der Besucher dem Senden von Daten an Platform durch die Web-SDK zugestimmt hat. Klicken Sie auf die blaue Schaltfläche „Änderungen beibehalten“, um diese Aktion zu speichern, und dann auf „Speichern“, um diese Regel zu speichern.

Hinweis: Nachdem sich ein Website-Besucher abgemeldet hat, können Sie in der SDK die Einwilligung des Benutzers nicht mehr für die Anmeldung festlegen.

Ihre Tag-Regeln können durch eine Vielzahl integrierter oder benutzerdefinierter Ereignisse“ ausgelöst, die verwendet werden können, um diese Einverständnisdaten zum richtigen Zeitpunkt während einer Besuchersitzung zu übergeben. Im obigen Beispiel haben wir das Fensterladeereignis verwendet, um die Regel in einen Trigger zu bringen. In einem späteren Abschnitt verwenden wir ein Einverständnispräferenzereignis von einer CMP, um eine Einverständnisaktion festzulegen und Trigger dazu auszuführen. Sie können die Aktion „Einverständnis festlegen“ in einer Regel verwenden, die von einem beliebigen von Ihnen bevorzugten Ereignis ausgelöst wird, das eine Opt-in-Voreinstellung angibt.