Konfigurieren der Web SDK-Tag-Erweiterung

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

Mit der Erweiterung können Sie Daten in Platform streamen, Identitäten synchronisieren, Zustimmungssignale von Kunden verarbeiten und automatisch Kontextdaten erfassen.

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

Installieren der Web SDK-Tag-Erweiterung

Die Web SDK-Tag-Erweiterung benötigt eine Eigenschaft, auf der installiert werden soll. 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 die Erweiterungen auf der linken Seitenleiste.

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

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

Instanzeneinstellungen konfigurieren

Die Konfigurationsoptionen oben auf der Seite geben Adobe Experience Platform an, wo die Daten weitergeleitet werden 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 mit einer Tag-Konfiguration an mehrere Organisationen zu senden. Der Instanzname wird standardmäßig auf alloy. Sie können den Instanznamen jedoch in einen beliebigen gültigen JavaScript-Objektnamen ändern.
• Kennung der IMS-Organisation: Die ID der Organisation, an die die Daten bei der Adobe gesendet werden sollen. Meistens verwenden Sie den Standardwert, der automatisch ausgefüllt wird. Wenn sich auf der Seite mehrere Instanzen befinden, geben Sie in dieses Feld den Wert der zweiten Organisation ein, an die Sie Daten senden möchten.
• Edge-Domäne: Die Domäne, von der die Erweiterung Daten sendet und empfängt. Adobe empfiehlt die Verwendung einer Erstanbieterdomäne (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 Datenspeichereinstellungen

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

Wenn eine Anforderung an das Edge-Netzwerk gesendet wird, wird eine Datastream-ID verwendet, um auf die serverseitige Konfiguration zu verweisen. Sie können die Konfiguration aktualisieren, ohne Codeänderungen auf Ihrer Website vornehmen zu müssen.

Siehe Handbuch unter datastreams , um zu erfahren, wie Sie einen Datastream konfigurieren.

Sie können entweder einen Datenspeicher aus den verfügbaren Dropdownmenüs auswählen oder Werte eingeben und geben Sie eine benutzerdefinierte Datastream-ID für jede Umgebung ein.

Datenschutzeinstellungen konfigurieren

In diesem Abschnitt können Sie konfigurieren, wie das Web SDK Zustimmungssignale von Benutzern von Ihrer Website verarbeitet. Insbesondere können Sie damit das standardmäßige Zustimmungsniveau auswählen, das von einem Benutzer angenommen wird, wenn keine andere explizite Zustimmungsvoreinstellung angegeben wurde.

Die standardmäßige Zustimmungsstufe wird nicht im Benutzerprofil gespeichert.

Identitätseinstellungen konfigurieren

In diesem Abschnitt können Sie das Verhalten des Web SDK bezüglich der Handhabung der Benutzeridentifizierung definieren.

• Migrieren der ECID aus der VisitorAPI: Diese Option ist standardmäßig aktiviert. Wenn diese Funktion aktiviert ist, kann das SDK die AMCV und s_ecid Cookies und legen Sie die AMCV von Visitor.js. Diese Funktion ist bei der Migration zum Web SDK wichtig, da einige Seiten möglicherweise weiterhin verwenden. Visitor.js. Mit dieser Option kann das SDK weiterhin dieselbe ECID sodass Benutzer nicht als zwei getrennte Benutzer identifiziert werden.
• Verwenden von Drittanbieter-Cookies: Wenn diese Option aktiviert ist, versucht das Web SDK, eine Benutzer-ID in einem Drittanbieter-Cookie zu speichern. Bei erfolgreicher Ausführung wird der Benutzer als einzelner Benutzer identifiziert, der über mehrere Domänen navigiert, anstatt für jede Domäne als separater Benutzer identifiziert zu werden. Wenn diese Option aktiviert ist, kann das SDK die Benutzer-ID möglicherweise weiterhin 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 das SDK die Kennung nur in der Erstanbieterdomäne.

Personalisierungseinstellungen konfigurieren

In diesem Abschnitt können Sie konfigurieren, wie Sie bestimmte Teile einer Seite ausblenden möchten, während personalisierter Inhalt geladen wird. Dadurch wird sichergestellt, dass Ihre Besucher nur die personalisierte Seite sehen.

• Migrieren von Target von at.js zum Web SDK: Verwenden Sie diese Option, um Web SDK zum Lesen und Schreiben der alten mbox und mboxEdgeCluster von at.js verwendete Cookies 1.x oder 2.x -Bibliotheken. Auf diese Weise können Sie das Besucherprofil beim Wechsel von einer Seite, die das Web SDK verwendet, zu einer Seite, die at.js verwendet, beibehalten 1.x oder 2.x und umgekehrt.

Stil vorab ausblenden

Mit dem Stil-Editor für die Vorab-Ausblendung können Sie benutzerdefinierte CSS-Regeln definieren, um bestimmte Bereiche einer Seite auszublenden. Wenn die Seite geladen wird, verwendet das Web SDK diesen Stil, um die zu personalisierenden Abschnitte auszublenden, die Personalisierung abzurufen und dann die personalisierten Seitenabschnitte wieder einzublenden. Auf diese Weise werden Ihren Besuchern die bereits personalisierten Seiten angezeigt, ohne dass der Personalisierungs-Abrufprozess angezeigt wird.

Vorabausblenden eines Snippets

Das Vorabausblendungs-Snippet ist nützlich, wenn die Web SDK-Bibliothek asynchron geladen wird. In diesem Fall wird empfohlen, den Inhalt vor dem Laden der Web SDK-Bibliothek zu verbergen, um Flackern zu vermeiden.

Um den Codeausschnitt zur Vorab-Ausblendung zu verwenden, kopieren Sie ihn und fügen Sie ihn in das <head> -Element Ihrer Seite.

Datenerfassungseinstellungen konfigurieren

• Callback-Funktion: Die in der Erweiterung bereitgestellte Rückruffunktion wird auch als onBeforeEventSend function in der Bibliothek. Mit dieser Funktion können Sie Ereignisse global ändern, bevor sie an das Edge-Netzwerk gesendet werden. Ausführlichere Informationen zur Verwendung dieser Funktion finden Sie unter here.
• Aktivieren der Klickdatenerfassung: Das Web SDK kann automatisch Link-Klickinformationen für Sie erfassen. Standardmäßig ist diese Funktion aktiviert, kann jedoch über diese Option deaktiviert werden. Links werden auch als Downloadlinks bezeichnet, wenn sie einen der in der Downloadlink-Qualifizierung Textfeld. Adobe bietet Ihnen einige standardmäßige Downloadlink-Qualifikatoren. Sie können sie nach Bedarf bearbeiten.
• Automatisch erfasste Kontextdaten: Standardmäßig erfasst das Web SDK bestimmte Kontextdaten in Bezug auf Gerät, Web, Umgebung und Ortskontext. Wenn Sie eine Liste der von Adobe erfassten Informationen sehen möchten, können Sie sie finden here. Wenn diese Daten nicht erfasst werden sollen oder Sie nur bestimmte Datenkategorien erfassen möchten, wählen Sie Spezifische Kontextdaten und wählen Sie die Daten aus, die Sie erfassen möchten.

Konfigurieren von Datenstromüberschreibungen

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 Web SDK-Tag-Erweiterung an das Edge-Netzwerk senden.

Anzeigen des Datenspeichers Dokumentation zu Konfigurationsüberschreibungen für detaillierte Anweisungen zum Überschreiben von Datenspeicherkonfigurationen.

Als Alternative zum Übergeben der Überschreibungen über einen Web SDK-Befehl können Sie die Überschreibungen im Bildschirm für die Tag-Erweiterung konfigurieren, der unten dargestellt wird.

Erweiterte Einstellungen konfigurieren

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