Konfigurieren der Web SDK-Tag-Erweiterung

Die Web SDK Tag-Erweiterung sendet Daten von Web-Eigenschaften über das Experience Platform-Edge Network an Adobe Experience Cloud.

Die Erweiterung ermöglicht es Ihnen, Daten in Platform zu streamen, Identitäten zu synchronisieren, Einverständnissignale von Kunden zu verarbeiten und automatisch Kontextdaten zu erfassen.

In diesem Dokument wird erläutert, wie Sie die Tag-Erweiterung in der Tags-Benutzeroberfläche konfigurieren.

Installieren der Tag-Erweiterung „Web SDK" install

Die Tag-Erweiterung „Web SDK" benötigt eine -Eigenschaft, auf der installiert werden muss. Wenn Sie dies noch nicht getan haben, lesen Sie die Dokumentation unter Erstellen einer Tag-Eigenschaft.

Nachdem Sie eine Eigenschaft erstellt haben, öffnen Sie die Eigenschaft und wählen Sie in der linken Seitenleiste Erweiterungen aus.

Wählen Sie die Katalog aus. Suchen Sie in der Liste der verfügbaren Erweiterungen nach der Web SDK Erweiterung und wählen Sie Installieren aus.

Bild, das die Benutzeroberfläche für Tags mit ausgewählter Web SDK-Erweiterung zeigt

Nach Auswahl von Installieren müssen Sie die Tag-Erweiterung für Web SDK konfigurieren und die Konfiguration speichern.

NOTE
Die Tag-Erweiterung wird erst nach dem Speichern der Konfiguration installiert. In den nächsten Abschnitten erfahren Sie, wie Sie die Tag-Erweiterung konfigurieren.

Instanzeinstellungen konfigurieren general

Die Konfigurationsoptionen oben auf der Seite geben Adobe Experience Platform an, wohin die Daten weitergeleitet werden sollen und welche Konfigurationen auf dem Server verwendet werden sollen.

Abbildung mit den allgemeinen Einstellungen der Tag-Erweiterung „Web SDK in der Tags-Benutzeroberfläche

  • Name: Die Adobe Experience Platform Web SDK-Erweiterung unterstützt mehrere Instanzen auf der Seite. Der Name wird verwendet, um Daten an mehrere Organisationen mit einer Tag-Konfiguration zu senden. Der Instanzname ist standardmäßig auf alloy festgelegt. Sie können jedoch den Instanznamen in einen beliebigen gültigen JavaScript-Objektnamen ändern.
  • IMS-Organisations-ID: Die ID der Organisation, an die die Daten auf Adobe gesendet werden sollen. Meistens verwenden Sie den Standardwert, der automatisch ausgefüllt wird. Wenn sich auf der Seite mehrere Instanzen befinden, füllen Sie dieses Feld mit dem Wert der zweiten Organisation, an die Sie Daten senden möchten.
  • Edge-Domain: Die Domain, von der die Erweiterung Daten sendet und empfängt. Adobe empfiehlt die Verwendung einer Erstanbieter-Domain (CNAME) für diese Erweiterung. Die standardmäßige Drittanbieterdomäne funktioniert in Entwicklungsumgebungen, ist jedoch nicht für Produktionsumgebungen geeignet. Anweisungen zum Einrichten eines Erstanbieter-CNAME finden Sie hier.

Konfigurieren von Datenstromeinstellungen datastreams

In diesem Abschnitt können Sie die Datenströme auswählen, die für jede der drei verfügbaren Umgebungen (Produktion, Staging und Entwicklung) verwendet werden sollen.

Wenn eine Anfrage an das -Edge Network gesendet wird, wird eine Datenstrom-ID verwendet, um auf die Server-seitige Konfiguration zu verweisen. Sie können die Konfiguration aktualisieren, ohne Code-Änderungen auf Ihrer Website vornehmen zu müssen.

Informationen zum Konfigurieren eines findenim Handbuch zu Datenströmen .

Sie können entweder einen Datenstrom aus den verfügbaren Dropdown-Menüs auswählen oder Werte eingeben auswählen und für jede Umgebung eine benutzerdefinierte Datenstrom-ID eingeben.

Bild mit den Datenstromeinstellungen der Tag-Erweiterung „Web SDK in der Tags-Benutzeroberfläche

Datenschutzeinstellungen konfigurieren privacy

In diesem Abschnitt können Sie konfigurieren, wie Web SDK Benutzereinverständnissignale von Ihrer Website verarbeitet. Insbesondere können Sie die Standardebene für das Einverständnis auswählen, von der ein Benutzer ausgeht, wenn keine andere explizite Einverständnisvoreinstellung angegeben wurde.

Die standardmäßige Einverständnisebene wird nicht im Benutzerprofil gespeichert.

Bild mit den Datenschutzeinstellungen der Tag-Erweiterung „Web SDK in der Tags-Benutzeroberfläche

Standard-Einverständnisstufe
Beschreibung
IN
Erfassen Sie Ereignisse, die auftreten, bevor der Benutzer Einverständnisvoreinstellungen bereitstellt.
out
Verwerfen Sie Ereignisse, die auftreten, bevor der Benutzer Einverständnisvoreinstellungen gibt.
Ausstehend
Ereignisse in die Warteschlange stellen, die eintreten, bevor der Benutzer Einverständnisvoreinstellungen bereitstellt. Wenn Einverständnisvoreinstellungen bereitgestellt werden, werden die Ereignisse je nach den angegebenen Voreinstellungen erfasst oder verworfen.
Wird durch das Datenelement bereitgestellt
Die standardmäßige Einverständnisebene wird durch ein separates Datenelement bestimmt, das Sie definieren. Bei Verwendung dieser Option müssen Sie das Datenelement mithilfe des bereitgestellten Dropdown-Menüs angeben.
TIP
Verwenden Out oder Pending, wenn Sie für Ihre Geschäftsvorgänge eine explizite Benutzerzustimmung benötigen.

Konfigurieren von Identitätseinstellungen identity

In diesem Abschnitt können Sie das Verhalten der Web-SDK bei der Handhabung der Benutzeridentifizierung definieren.

Bild mit den Identitätseinstellungen der Web SDK-Tag-Erweiterung in der Tags-Benutzeroberfläche

  • ECID von VisitorAPI migrieren: Diese Option ist standardmäßig aktiviert. Wenn diese Funktion aktiviert ist, kann der SDK die AMCV und s_ecid Cookies lesen und das von Visitor.js verwendete AMCV-Cookie festlegen. Diese Funktion ist bei der Migration auf Web SDK wichtig, da einige Seiten möglicherweise noch Visitor.js verwenden. Diese Option ermöglicht es SDK, dieselbe ECID weiterhin zu verwenden, sodass Benutzende nicht als zwei separate Benutzende identifiziert werden.

  • Verwendung von Drittanbieter-Cookies: Wenn diese Option aktiviert ist, versucht Web SDK, eine Benutzerkennung in einem Drittanbieter-Cookie zu speichern. Bei erfolgreicher Ausführung wird der Benutzer bei der Navigation durch mehrere Domains als ein einzelner Benutzer identifiziert, anstatt in jeder Domain als separater Benutzer identifiziert zu werden. Wenn diese Option aktiviert ist, kann die SDK die Benutzerkennung möglicherweise immer noch nicht in einem Drittanbieter-Cookie speichern, wenn der Browser keine Drittanbieter-Cookies unterstützt oder vom Benutzer so konfiguriert wurde, dass keine Drittanbieter-Cookies zugelassen werden. In diesem Fall speichert die SDK die Kennung nur in der Erstanbieter-Domain.

    note important
    IMPORTANT
    ​>Drittanbieter-Cookies sind nicht mit der Funktion Erstanbieter-Geräte-ID in Web SDK kompatibel.

Sie können entweder Erstanbieter-Geräte-IDs verwenden oder Drittanbieter-Cookies verwenden. Sie können jedoch nicht beide Funktionen gleichzeitig verwenden.

Personalisierungseinstellungen konfigurieren personalization

In diesem Abschnitt können Sie festlegen, wie bestimmte Teile einer Seite beim Laden personalisierter Inhalte ausgeblendet werden sollen. Dadurch wird sichergestellt, dass Ihren Besuchern nur die personalisierte Seite angezeigt wird.

Bild mit den Personalisierungseinstellungen der Tag-Erweiterung „Web SDK in der Tags-Benutzeroberfläche

  • Migrieren von Target aus at.js in die Web-SDK: Verwenden Sie diese Option, um Web SDK das Lesen und Schreiben veralteter mbox und mboxEdgeCluster Cookies zu ermöglichen, die von at.js-1.x oder 2.x-Bibliotheken verwendet werden. So bleibt das Besucherprofil erhalten, wenn Sie von einer Seite, die Web SDK verwendet, zu einer Seite wechseln, die at.js-1.x oder 2.x-Bibliotheken verwendet, und umgekehrt.

Vorab-Ausblendstil prehiding-style

Mit dem Stil-Editor zum Vorab-Ausblenden können Sie benutzerdefinierte CSS-Regeln definieren, um bestimmte Abschnitte einer Seite auszublenden. Wenn die Seite geladen wird, verwendet Web SDK diesen Stil, um die Abschnitte auszublenden, die personalisiert werden müssen, die Personalisierung abzurufen und dann die personalisierten Seitenabschnitte wieder aufzuheben. Auf diese Weise können Ihre Besucherinnen und Besucher die bereits personalisierten Seiten sehen, ohne den Personalisierungs-Abrufprozess zu sehen.

Ausschnitt vorab ausblenden prehiding-snippet

Das Code-Ausschnitt zum Vorab-Ausblenden ist nützlich, wenn die Web SDK-Bibliothek asynchron geladen wird. Um Flimmern zu vermeiden, empfehlen wir in diesem Fall, den Inhalt vor dem Laden der Web SDK-Bibliothek auszublenden.

Um den Code-Ausschnitt zum Vorab-Ausblenden zu verwenden, kopieren Sie ihn und fügen Sie ihn in das <head>-Element Ihrer Seite ein.

IMPORTANT
Bei Verwendung des Ausschnitts zum Vorab-Ausblenden empfiehlt Adobe, dieselbe CSS-Regel zu verwenden wie die vom Stil zum Vorab-Ausblenden verwendete.

Einstellungen für die Datenerfassung konfigurieren data-collection

Konfigurationseinstellungen für die Datenerfassung verwalten Ähnliche Einstellungen in der JavaScript-Bibliothek sind mit dem Befehl configure verfügbar.

Bild mit den Datenerfassungseinstellungen der Web-SDK-Tag-Erweiterung in der Tags-Benutzeroberfläche.

  • Rückruf vor Ereignisversand: Eine Rückruffunktion zum Auswerten und Ändern der an Adobe gesendeten Payload. Verwenden Sie die Variable content innerhalb der Rückruffunktion, um die Payload zu ändern. Dieser Callback ist das Tag, das der onBeforeEventSend in der JavaScript-Bibliothek entspricht.

  • Interne Link-Klicks erfassen: Ein Kontrollkästchen, das die Erfassung von Linktracking-Daten innerhalb Ihrer Site oder Eigenschaft ermöglicht. Wenn Sie dieses Kontrollkästchen aktivieren, werden Optionen für die Ereignisgruppierung angezeigt:

    • Keine Ereignisgruppierung: Linktracking-Daten werden in separaten Ereignissen an Adobe gesendet. Link-Klicks, die in separaten Ereignissen gesendet werden, können die vertragliche Nutzung der an Adobe Experience Platform gesendeten Daten erhöhen.
    • Ereignisgruppierung mit Sitzungsspeicher: Speichern von Linktracking-Daten im Sitzungsspeicher bis zum nächsten Seitenereignis. Auf der folgenden Seite werden die gespeicherten Linktracking-Daten und Seitenansichtsdaten gleichzeitig an Adobe gesendet. Adobe empfiehlt, diese Einstellung beim Tracking interner Links zu aktivieren.
    • Ereignisgruppierung mit lokalem Objekt: Speichern von Linktracking-Daten in einem lokalen Objekt bis zum nächsten Seitenereignis. Wenn ein Besucher zu einer neuen Seite navigiert, gehen Linktracking-Daten verloren. Diese Einstellung ist besonders im Kontext von Einzelseitenanwendungen von Vorteil.
  • Klicks auf externe Links erfassen: Ein Kontrollkästchen, das die Erfassung externer Links aktiviert.

  • Klicks auf Download-Links erfassen: Ein Kontrollkästchen, das die Erfassung von Download-Links aktiviert.

  • Downloadlink-Qualifizierer: Ein regulärer Ausdruck, der eine Link-URL als Download-Link qualifiziert.

  • Filter-Klickeigenschaften: Eine Rückruffunktion, um klickbezogene Eigenschaften vor der Sammlung zu bewerten und zu ändern. Diese Funktion wird vor dem Ein vor Rückruf senden ausgeführt.

  • Kontexteinstellungen: Erfassen Sie automatisch Besucherinformationen, die bestimmte XDM-Felder für Sie ausfüllen. Sie können zwischen Alle standardmäßigen Kontextinformationen oder Spezifische Kontextinformationen wählen. Es handelt sich dabei um das Tag-Äquivalent zu context in der JavaScript-Bibliothek.

    • Web: Sammelt Informationen über die aktuelle Seite.
    • Gerät: Sammelt Informationen zum Gerät des Benutzers.
    • Umgebung: Sammelt Informationen zum Browser des Benutzers.
    • Ortskontext: Sammelt Informationen zum Standort des Benutzers.
    • Benutzeragenten-Hinweise mit hoher Entropie: Erfasst detailliertere Informationen über das Gerät des Benutzers.
TIP
Das Feld Ein Link vor Klick auf Senden ist ein veralteter Callback, der nur für Eigenschaften sichtbar ist, für die er bereits konfiguriert wurde. Es handelt sich dabei um das Tag-Äquivalent zu onBeforeLinkClickSend in der JavaScript-Bibliothek. Verwenden Sie den Filter-Klick Eigenschaften-Callback, um Klickdaten zu filtern oder anzupassen, oder verwenden Sie das Ein vor Ereignis senden des Callbacks, um die gesamte an Adobe gesendete Payload zu filtern oder anzupassen. Wenn sowohl der Callback Eigenschaften filtern als auch der Callback Ein vor Link klicken senden“ festgelegt sind, wird nur der Callback Eigenschaften filtern klicken ausgeführt.

Einstellungen für Mediensammlung konfigurieren media-collection

Mit der Mediensammlungsfunktion können Sie Daten zu Mediensitzungen auf Ihrer Website erfassen.

Die erfassten Daten können Informationen zu Medienwiedergaben, Pausen, Beendigungen und anderen zugehörigen Ereignissen enthalten. Nach der Erfassung können Sie diese Daten an Adobe Experience Platform und/oder Adobe Analytics senden, um Berichte zu generieren. Diese Funktion bietet eine umfassende Lösung zum Tracking und zum Verständnis des Medienkonsumverhaltens auf Ihrer Website.

Bild mit den Mediensammlungseinstellungen der Web-SDK-Tag-Erweiterung in der Tags-Benutzeroberfläche

  • channel: Der Name des Kanals, in dem die Mediensammlung stattfindet. Beispiel: Video channel.
  • Player-: Der Name des Medien-Players.
  • Anwendungsversion: Die Version der Media Player-Anwendung.
  • Haupt-Ping-Intervall: Häufigkeit der Pings für den Hauptinhalt in Sekunden. Der Standardwert lautet 10. Die Werte können zwischen 10 und 50 Sekunden liegen. Wenn kein Wert angegeben ist, wird der Standardwert bei der Verwendung von automatisch verfolgten Sitzungen verwendet.
  • Ad-Ping-Intervall: Häufigkeit der Pings für den Anzeigeninhalt in Sekunden. Der Standardwert lautet 10. Die Werte können zwischen 1 und 10 Sekunden liegen. Wenn kein Wert angegeben ist, wird der Standardwert bei der Verwendung von automatisch verfolgten Sitzungen“

Konfigurieren von Datenstromüberschreibungen datastream-overrides

Mit Datenstromüberschreibungen können Sie zusätzliche Konfigurationen für Ihre Datenströme definieren, die über das Web SDK an das Edge-Netzwerk übergeben werden.

Dies hilft Ihnen beim Auslösen anderer Datenstromverhaltensweisen als der standardmäßigen, ohne einen neuen Datenstrom zu erstellen oder Ihre vorhandenen Einstellungen zu ändern.

Das Überschreiben der Datenstromkonfiguration besteht aus zwei Schritten:

  1. Zunächst müssen Sie Ihre Überschreibungen der Datenstromkonfiguration auf der Seite Datenstromkonfiguration definieren.
  2. Anschließend müssen Sie die Überschreibungen entweder über einen Web-SDK-Befehl oder mithilfe der Tag-Erweiterung „Web SDK" an das Edge Network senden.

Detaillierte Anweisungen Überschreiben von Datenstromkonfigurationen finden Sieder Dokumentation zu Datenstromkonfigurationen .

Als Alternative zur Übergabe der Überschreibungen über einen Web SDK-Befehl können Sie die Überschreibungen im Bildschirm „Tag-Erweiterung“ konfigurieren, der unten dargestellt ist.

IMPORTANT
Datenstrom-Überschreibungen müssen pro Umgebung konfiguriert werden. Die Entwicklungs-, Staging- und Produktionsumgebungen haben jeweils separate Überschreibungen. Sie können die Einstellungen mithilfe der entsprechenden Optionen, die im folgenden Bildschirm angezeigt werden, zwischen ihnen kopieren.

Bild, das die Überschreibungen der Datenstromkonfiguration mithilfe der Tag-Erweiterungs-Seite von Web SDK zeigt.

Standardmäßig ist die Überschreibung der Datenstromkonfiguration deaktiviert. Die Konfiguration des Datenstroms abgleichen ist standardmäßig ausgewählt.

Benutzeroberfläche der Tag-Erweiterung von Web SDK, auf der die Datenstromkonfiguration angezeigt wird, überschreibt die Standardeinstellung.

Um Datenstrom-Überschreibungen in der Tag-Erweiterung zu aktivieren, wählen Sie Aktiviert aus dem Dropdown-Menü aus.

Benutzeroberfläche der Tag-Erweiterung von Web SDK mit der Einstellung „Überschreibungen der Datenstromkonfiguration aktiviert“.

Nachdem Sie die Überschreibungen der Datenstromkonfiguration aktiviert haben, können Sie die Überschreibungen für jeden Service konfigurieren, der unten beschrieben wird.

Die folgenden Einstellungen für die Datenstromüberschreibungen setzen alle Server-seitigen Datenstromkonfigurationen und -regeln für die ausgewählte Umgebung außer Kraft.

Adobe Analytics analytics

Verwenden Sie die Einstellungen in diesem Abschnitt, um das Daten-Routing zum Adobe Analytics-Service zu überschreiben.

UI-Bild der Web SDK-Tag-Erweiterung mit den Einstellungen für die Überschreibung des Adobe Analytics-Datenstroms.

  • Aktiviert/Deaktiviert: Verwenden Sie dieses Dropdown-Menü, um das Daten-Routing zum Adobe Analytics-Service zu aktivieren oder zu deaktivieren.
  • Report Suites: Die IDs für die Ziel-Report Suites in Adobe Analytics. Der Wert muss eine vorkonfigurierte Report Suite (oder eine kommagetrennte Liste von Report Suites) aus Ihrer Datenstromkonfiguration sein. Diese Einstellung überschreibt die primären Report Suites.
  • Report Suite hinzufügen: Wählen Sie diese Option, um weitere Report Suites hinzuzufügen.

Adobe Audience Manager audience-manager

Verwenden Sie die Einstellungen in diesem Abschnitt, um das Daten-Routing zum Adobe Audience Manager-Service zu überschreiben.

UI-Bild der Web SDK-Tag-Erweiterung mit den Einstellungen für die Überschreibung des Adobe Audience Manager-Datenstroms.

  • Aktiviert/Deaktiviert: Verwenden Sie dieses Dropdown-Menü, um das Daten-Routing zum Adobe Audience Manager-Service zu aktivieren oder zu deaktivieren.
  • Synchronisierungs-Container für Drittanbieter-ID: Die ID für den Ziel-Synchronisierungs-Container für Drittanbieter-IDs im Audience Manager. Der Wert muss ein vorkonfigurierter sekundärer Container aus Ihrer Datenstromkonfiguration sein und überschreibt den primären Container.

Adobe Experience Platform experience-platform

Verwenden Sie die Einstellungen in diesem Abschnitt, um das Daten-Routing zum Adobe Experience Platform-Service zu überschreiben.

UI-Bild der Web SDK-Tag-Erweiterung mit den Einstellungen für die Überschreibung des Adobe Experience Platform-Datenstroms.

  • Aktiviert/Deaktiviert: Verwenden Sie dieses Dropdown-Menü, um das Daten-Routing zum Adobe Experience Platform-Service zu aktivieren oder zu deaktivieren.
  • Ereignisdatensatz: Die ID für den Zielereignisdatensatz in der Adobe Experience Platform. Der Wert muss ein vorkonfigurierter sekundärer Datensatz aus Ihrer Datenstromkonfiguration sein.
  • Offer decisioning: Verwenden Sie dieses Dropdown-Menü, um das Datenrouting an den Offer Decisioning-Service zu aktivieren oder zu deaktivieren.
  • Edge-: Verwenden Sie dieses Dropdown-Menü, um das Daten-Routing zum Edge Segmentation-Service zu aktivieren oder zu deaktivieren.
  • Personalization-Ziele: Verwenden Sie dieses Dropdown-Menü, um das Daten-Routing zu Personalisierungszielen zu aktivieren oder zu deaktivieren.
  • Adobe Journey Optimizer: Verwenden Sie dieses Dropdown-Menü, um das Datenrouting an den Adobe Journey Optimizer-Service zu aktivieren oder zu deaktivieren.

Adobe-Server-seitige Ereignisweiterleitung ssf

Verwenden Sie die Einstellungen in diesem Abschnitt, um das Daten-Routing zum Server-seitigen Adobe-Ereignisweiterleitungs-Service zu überschreiben.

Bild der Tag-Erweiterung der Web SDK in der Benutzeroberfläche mit den Überschreibungseinstellungen für den Adobe-Server-seitigen Ereignisweiterleitungs-Datenstrom.

  • Aktiviert/Deaktiviert: Verwenden Sie dieses Dropdown-Menü, um das Daten-Routing zum Server-seitigen Adobe-Ereignisweiterleitungs-Service zu aktivieren oder zu deaktivieren.

Adobe Target target

Verwenden Sie die Einstellungen in diesem Abschnitt, um das Daten-Routing zum Adobe Target-Service zu überschreiben.

UI-Bild der Web SDK-Tag-Erweiterung mit den Einstellungen für die Überschreibung des Adobe Target-Datenstroms.

  • Aktiviert/Deaktiviert: Verwenden Sie dieses Dropdown-Menü, um das Daten-Routing zum Adobe Target-Service zu aktivieren oder zu deaktivieren.

Konfigurieren der erweiterten Einstellungen

Verwenden Sie das Feld Edge Basispfad, wenn Sie den Basispfad ändern müssen, der für die Interaktion mit dem Edge Network verwendet wird. Dies sollte keine Aktualisierung erfordern, aber für den Fall, dass Sie an einer Beta- oder Alpha-Version teilnehmen, kann Adobe Sie bitten, dieses Feld zu ändern.

Bild, das die erweiterten Einstellungen mithilfe der Tag-Erweiterungs-Seite von Web SDK zeigt.

recommendation-more-help
12b4e4a9-5028-4d88-8ce6-64a580811743