Konfigurieren des Platform Web SDK

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

Gibt an, welche Kontextkategorien automatisch erfasst werden sollen, wie unter Automatische Informationen beschrieben. 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 hochentropy-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

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

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

edgeBasePath

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

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 lautet "\\.(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 wird an den Rückruf 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

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, clickedElementund data -Felder.

Beim Filtern des Linktrackings 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.

• Ein anderer Wert als false ermöglicht die Verarbeitung des Ereignisses und das Senden des Rückrufs.
• Wenn der Rückruf die false -Wert, wird die Ereignisverarbeitung angehalten, es wird kein Fehler ausgegeben und das Ereignis wird nicht gesendet. Dieser Mechanismus ermöglicht die Filterung bestimmter Ereignisse, indem die Ereignisdaten untersucht und false , wenn das Ereignis nicht gesendet werden soll.
• Wenn der Rückruf eine Ausnahme auslöst, wird die Verarbeitung für das Ereignis angehalten und das Ereignis wird nicht gesendet.

Datenschutzoptionen

defaultConsent

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.

• "in": Wenn diese Einstellung festgelegt ist oder kein Wert angegeben wird, wird die Arbeit ohne Voreinstellungen für die Benutzerzustimmung fortgesetzt.
• "pending": Wenn diese Einstellung festgelegt ist, wird die Arbeit in die Warteschlange gestellt, bis der Benutzer Zustimmungsvoreinstellungen bereitstellt.
• "out": Wenn diese Einstellung festgelegt ist, wird die Arbeit verworfen, bis der Benutzer Zustimmungsvoreinstellungen bereitstellt.
  Nachdem die Voreinstellungen des Nutzers bereitgestellt wurden, wird die Arbeit basierend auf den Voreinstellungen des Nutzers entweder fortgesetzt oder abgebrochen. Weitere Informationen finden Sie unter Unterstützen von Zustimmung.

Personalisierungsoptionen

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

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 Cookies, die 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

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 wünschenswert.

Ressourcen für Business.Adobe.com

Content Intelligence Third Party Data Data Ingestion Marketing Analytics Search Marketing Management Programmatic Advertising