Konfigurieren des Platform Web SDK

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

WICHTIG

configure ist immer ** der erste Befehl mit dem Namen .

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

HINWEIS

Edge-Konfigurationen wurden in Datastreams umbenannt. Eine Datastream-ID entspricht einer Konfigurations-ID.

Typ Erforderlich Standardwert
Zeichenfolge Ja Keine

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

Typ Erforderlich Standardwert
Array von Zeichenfolgen Nein ["web", "device", "environment", "placeContext"]

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.

debugEnabled

Typ Erforderlich Standardwert
Boolesch Nein false

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

Funktion Funktion
Konsolen-Logging Aktiviert die Anzeige von Debugging-Meldungen in der JavaScript-Konsole des Browsers

edgeDomain

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

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

orgId

Typ Erforderlich Standardwert
Zeichenfolge Ja Keine

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

Datenerfassung

clickCollectionEnabled

Typ Erforderlich Standardwert
Boolesch Nein true

Gibt an, ob mit Link-Klicks verknüpfte Daten automatisch erfasst werden. Weitere Informationen finden Sie unter Automatische Linktracking . 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

Typ Erforderlich Standardwert
Funktion Nein () => nicht definiert

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 zu ändern, was gesendet wird, ändern Sie das xdm -Objekt. Innerhalb des Rückrufs werden die Daten bereits im Ereignisbefehl an das xdm-Objekt und die automatisch erfassten Informationen übergeben. Weitere Informationen zum Timing dieses Rückrufs und ein Beispiel finden Sie unter Globale Änderung von Ereignissen.

Datenschutzoptionen

Typ Erforderlich Standardwert
Objekt Nein "in"

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 Profil des Benutzers 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

Typ Erforderlich Standardwert
Zeichenfolge Nein Keine

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 Kennung container aufweist, dessen Standardinhalt Sie ausblenden möchten, während personalisierter Inhalt vom Server geladen wird, verwenden Sie den folgenden Vorab-Ausblendungsstil:

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

Optionen für Zielgruppen

cookieDestinationsEnabled

Typ Erforderlich Standardwert
Boolesch Nein true

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

urlDestinationsEnabled

Typ Erforderlich Standardwert
Boolesch Nein true

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

Identitätsoptionen

idMigrationEnabled

Typ Erforderlich Standardwert
Boolesch Nein true

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

Typ Erforderlich Standardwert
Boolesch Nein true

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.

Auf dieser Seite