Web SDK konfigurieren

Die Konfiguration für das SDK erfolgt mit dem configure-Befehl.

alloy("configure", {
  "edgeConfigId": "ebebf826-a01f-4458-8cec-ef61de241c93",
  "orgId":"ADB3LETTERSANDNUMBERS@AdobeOrg"
});

Es gibt viele Optionen, die während der Konfiguration festgelegt werden können. Alle Optionen sind nachstehend nach Kategorie gruppiert aufgeführt.

Allgemeine Optionen

edgeConfigId

Ihre zugewiesene Konfigurations-ID, die das SDK mit den entsprechenden Konten und Konfigurationen verknüpft. Beim Konfigurieren mehrerer Instanzen innerhalb einer einzelnen Seite müssen Sie für jede Instanz eine andere edgeConfigId konfigurieren.

context context

Gibt an, welche Kontextkategorien automatisch erfasst werden sollen, wie unter Automatische Informationen. Wenn diese Konfiguration nicht angegeben ist, werden standardmäßig alle Kategorien verwendet.

Aktivieren Clienthinweise mit hoher Entropie in Ihrer Web SDK-Bereitstellung müssen Sie die zusätzlichen highEntropyUserAgentHints -Kontextoption neben Ihrer vorhandenen Konfiguration.

Um beispielsweise Hinweise zu hochgradigen Entropy-Clients aus Web-Eigenschaften abzurufen, würde Ihre Konfiguration wie folgt aussehen:

context: ["highEntropyUserAgentHints", "web"]

debugEnabled

Gibt an, ob das Debugging aktiviert ist. Durch das Festlegen dieser Konfiguration auf true werden die folgenden Funktionen aktiviert:

edgeDomain edge-domain

Füllen Sie dieses Feld mit Ihrer Erstanbieterdomäne aus. Weitere Informationen finden Sie unter Dokumentation.

Die Domäne ähnelt dem data.{customerdomain.com} für eine Website unter www.{customerdomain.com}.

edgeBasePath edge-base-path

Pfad nach der edgeDomain, die zur Kommunikation und Interaktion mit Adobe-Diensten verwendet wird. Häufig würde sich dies nur ändern, wenn nicht die standardmäßige Produktionsumgebung verwendet wird.

orgId

Ihr zugewiesener Experience Cloud Organisations-ID. Beim Konfigurieren mehrerer Instanzen innerhalb einer Seite müssen Sie für jede Instanz eine andere orgId konfigurieren.

Datenerfassung

clickCollectionEnabled clickCollectionEnabled

Gibt an, ob mit Link-Klicks verknüpfte Daten automatisch erfasst werden. Siehe Automatische Linktracking für weitere Informationen. Links werden auch als Downloadlinks bezeichnet, wenn sie ein Download-Attribut enthalten oder wenn der Link mit einer Dateierweiterung endet. Downloadlink-Qualifikatoren können mit einem regulären Ausdruck konfiguriert werden. Der Standardwert ist "\\.(exe|zip|wav|mp3|mov|mpg|avi|wmv|pdf|doc|docx|xls|xlsx|ppt|pptx)$"

onBeforeEventSend

Konfigurieren Sie einen Callback, der für jedes Ereignis kurz vor dem Senden aufgerufen wird. Ein Objekt mit dem Feld xdm an den Callback gesendet. Um die gesendeten Nachrichten zu ändern, ändern Sie die xdm -Objekt. Innerhalb des Rückrufs wird die xdm -Objekt enthält bereits die Daten, die im Ereignisbefehl übergeben werden, und die automatisch erfassten Informationen. Weitere Informationen zum Timing dieses Rückrufs und ein Beispiel finden Sie unter Globale Änderung von Ereignissen.

onBeforeLinkClickSend onBeforeLinkClickSend

Konfigurieren Sie einen Callback, der für jedes Linkklick-Tracking-Ereignis kurz vor dem Senden aufgerufen wird. Der Rückruf sendet ein Objekt mit der xdm, clickedElement, und data -Felder.

Beim Filtern der Linktracking mithilfe der DOM-Elementstruktur können Sie die clickElement Befehl. clickedElement ist der DOM-Elementknoten, auf den geklickt wurde und der die Struktur der übergeordneten Knoten enthielt.

Um zu ändern, welche Daten gesendet werden, ändern Sie die xdm und/oder data Objekte. Innerhalb des Rückrufs wird die xdm -Objekt enthält bereits die Daten, die im Ereignisbefehl übergeben werden, und die automatisch erfassten Informationen.

Datenschutzoptionen

defaultConsent default-consent

Legt die Standardzustimmung des Nutzers fest. Verwenden Sie diese Einstellung, wenn für den Benutzer keine Zustimmungsvoreinstellung gespeichert wurde. Die anderen gültigen Werte sind "pending" und "out". Dieser Standardwert wird nicht im Profil des Benutzers beibehalten. Das Benutzerprofil wird nur aktualisiert, wenn setConsent aufgerufen wird.

Personalisierungsoptionen personalization

prehidingStyle prehidingStyle

Wird verwendet, um eine CSS-Stildefinition zu erstellen, die Inhaltsbereiche Ihrer Web-Seite ausblendet, während personalisierter Inhalt vom Server geladen wird. Wenn diese Option nicht bereitgestellt wird, versucht das SDK nicht, Inhaltsbereiche beim Laden personalisierter Inhalte auszublenden, was möglicherweise zu einem "Flackern"führt.

Wenn beispielsweise ein Element auf Ihrer Web-Seite die ID container, deren Standardinhalt Sie ausblenden möchten, während personalisierter Inhalt vom Server geladen wird, verwenden Sie den folgenden Stil für die Vorab-Ausblendung:

  prehidingStyle: "#container { opacity: 0 !important }"

targetMigrationEnabled targetMigrationEnabled

Diese Option sollte bei der Migration einzelner Seiten von at.js zum Web SDK.

Verwenden Sie diese Option, um das Web SDK zum Lesen und Schreiben der Legacy zu aktivieren. mbox und mboxEdgeCluster von at.js. Auf diese Weise können Sie das Besucherprofil beibehalten, während Sie von einer Seite, die das Web SDK verwendet, zu einer Seite wechseln, die die Variable at.js Bibliothek und umgekehrt.

Optionen für Zielgruppen

cookieDestinationsEnabled

Aktiviert Audience Manager Cookie-Ziele, die das Setzen von Cookies basierend auf der Segmentqualifizierung ermöglichen.

urlDestinationsEnabled

Aktiviert Audience Manager URL-Ziele, die das Auslösen von URLs basierend auf der Segmentqualifizierung ermöglichen.

Identitätsoptionen

idMigrationEnabled id-migration-enabled

Wenn "true", liest und setzt das SDK alte AMCV-Cookies. Diese Option hilft beim Übergang zur Verwendung des Adobe Experience Platform Web SDK, während einige Teile der Site möglicherweise noch Visitor.js verwenden.

Wenn die Besucher-API auf der Seite definiert ist, fragt das SDK die Besucher-API für die ECID ab. Mit dieser Option können Sie Seiten mit dem Adobe Experience Platform Web SDK doppelt taggen, die immer noch dieselbe ECID aufweisen.

thirdPartyCookiesEnabled

Aktiviert die Einstellung von Adobe-Drittanbieter-Cookies. Das SDK kann die Besucher-ID in einem Drittanbieterkontext beibehalten, damit dieselbe Besucher-ID siteübergreifend verwendet werden kann. Verwenden Sie diese Option, wenn Sie mehrere Sites haben oder Daten mit Partnern teilen möchten. Manchmal ist diese Option jedoch aus Datenschutzgründen nicht erwünscht.