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.
Nach Auswahl von Installieren müssen Sie die Tag-Erweiterung für Web SDK konfigurieren und die Konfiguration speichern.
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.
- 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.
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.
Konfigurieren von Identitätseinstellungen identity
In diesem Abschnitt können Sie das Verhalten der Web-SDK bei der Handhabung der Benutzeridentifizierung definieren.
-
ECID von VisitorAPI migrieren: Diese Option ist standardmäßig aktiviert. Wenn diese Funktion aktiviert ist, kann der SDK die
AMCV
unds_ecid
Cookies lesen und das von Visitor.js verwendeteAMCV
-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.
- Migrieren von Target aus at.js in die Web-SDK: Verwenden Sie diese Option, um Web SDK das Lesen und Schreiben veralteter
mbox
undmboxEdgeCluster
Cookies zu ermöglichen, die von at.js-1.x
oder2.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
oder2.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.
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.
-
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 deronBeforeEventSend
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.
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.
- 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 zwischen10
und50
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 zwischen1
und10
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:
- Zunächst müssen Sie Ihre Überschreibungen der Datenstromkonfiguration auf der Seite Datenstromkonfiguration definieren.
- 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.
Standardmäßig ist die Überschreibung der Datenstromkonfiguration deaktiviert. Die Konfiguration des Datenstroms abgleichen ist standardmäßig ausgewählt.
Um Datenstrom-Überschreibungen in der Tag-Erweiterung zu aktivieren, wählen Sie Aktiviert aus dem Dropdown-Menü aus.
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.
- 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.
- 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.
- 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.
- 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.
- 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.