Show Menu
THEMEN×

(Beta) SDK konfigurieren

Das Adobe Experience Platform Web SDK befindet sich derzeit in der Betaphase und steht nicht allen Benutzern zur Verfügung. Dokumentation und Funktionalität können sich ändern.
Die Konfiguration für das SDK erfolgt mit dem configure Befehl.
alloy("configure", {
  "configId": "ebebf826-a01f-4458-8cec-ef61de241c93",
  "orgId":"ADB3LETTERSANDNUMBERS@AdobeOrg"
});

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

Allgemeine Optionen

configId

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 configId konfigurieren.

context

Typ
Erforderlich
Standardwert
Array von Zeichenfolgen
Nein
["web", "device", "environment", "placeContext"]
Gibt an, welche Kontext-Kategorien 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 werden soll. Durch das Festlegen dieser Konfiguration true werden die folgenden Funktionen aktiviert:
| Funktion | | | | ---------------------- | ------------------ | | Synchrone Überprüfung | Prüft die für das Schema erfassten Daten und gibt in der Antwort unter der folgenden Beschriftung einen Fehler zurück: collect:error OR success | | Konsolenprotokollierung | Aktiviert die Anzeige von Debugging-Meldungen in der JavaScript-Konsole des Browsers |

edgeDomain

Typ
Erforderlich
Standardwert
Zeichenfolge
Nein
beta.adobedc.net
Die Domäne, die für die Interaktion mit Adobe Services verwendet wird. Dies wird nur verwendet, wenn Sie über eine Erstanbieter-Domäne (CNAME) verfügen, die Anforderungen an die Adobe Edge-Infrastruktur weiterleitet.

errorsEnabled

Typ
Erforderlich
Standardwert
Boolesch
Nein
true
Gibt an, ob Fehler unterdrückt werden sollen. Wie unter Befehle ausführen beschrieben, werden nicht abgefangene Fehler bei der Entwicklerkonsole protokolliert, unabhängig davon, ob das Debugging in Adobe Experience Platform Web SDK aktiviert ist. Durch Einstellung errorsEnabled auf false werden von Adobe Experience Platform Web SDK zurückgegebene Versprechen nie zurückgewiesen, obwohl Fehler weiterhin bei der Konsole protokolliert werden, wenn die Protokollierung in Adobe Experience Platform Web SDK aktiviert ist.

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 Linkklicks verbundene Daten automatisch erfasst werden sollen. Für Klicks, die als Link-Klicks gelten, werden die folgenden Webinteraktionsdaten erfasst:
Eigenschaft
Link-Name
Durch den Linkkontext bestimmter Name
Link-URL
Normalisierte URL
Link-Typ
Auf Herunterladen, Beenden oder andere festlegen

onBeforeEventSend

Typ
Erforderlich
Standardwert
Funktion
Nein
() => nicht definiert
Legen Sie dies fest, um einen Rückruf zu konfigurieren, der für jedes Ereignis kurz vor dem Senden aufgerufen wird. Ein Objekt mit dem Feld xdm wird an den Rückruf gesendet. Ändern Sie das xdm-Objekt, um die gesendeten Daten zu ändern. Innerhalb des Rückrufs werden dem xdm Objekt bereits die Daten im Ereignis-Befehl und die automatisch erfassten Informationen übergeben. Weitere Informationen zum Timing dieses Rückrufs und ein Beispiel finden Sie unter Globales Ändern von Ereignissen .

Datenschutzoptionen

defaultConsent

Typ
Erforderlich
Standardwert
Objekt
Nein
{"general": "in"}
Legt die Standardgenehmigung des Benutzers fest. Dies wird verwendet, wenn für den Benutzer noch keine Voreinstellung für die Zustimmung gespeichert wurde. Der andere gültige Wert ist {"general": "pending"} . Wenn dies festgelegt ist, wird die Arbeit in die Warteschlange gestellt, bis der Benutzer die Voreinstellungen für die Zustimmung eingibt. Nachdem die Voreinstellungen des Benutzers bereitgestellt wurden, wird die Arbeit entweder fortgesetzt oder basierend auf den Voreinstellungen des Benutzers abgebrochen. Weitere Informationen finden Sie unter Unterstützende Zustimmung .

Personalisierungsoptionen

prehidingStyle

Typ
Erforderlich
Standardwert
Zeichenfolge
Nein
Keine
Wird verwendet, um eine CSS-Stildefinition zu erstellen, die Inhaltsbereiche Ihrer Webseite ausblendet, während personalisierter Inhalt vom Server geladen wird. Wenn diese Option nicht bereitgestellt wird, versucht das SDK nicht, Inhaltsbereiche auszublenden, während personalisierte Inhalte geladen werden, was möglicherweise zu einem Flackern führt.
Wenn Sie z. B. ein Element auf Ihrer Webseite mit einer ID haben, container deren Standardinhalt Sie ausblenden möchten, während personalisierter Inhalt vom Server geladen wird, wäre ein Beispiel für einen Prähidierungsstil wie folgt:
  prehidingStyle: "#container { opacity: 0 !important }"

Optionen für Audiencen

cookieDestinationsEnabled

Typ
Erforderlich
Standardwert
Boolesch
Nein
true
Aktiviert Cookie-Ziele, wodurch Cookies basierend auf der Segmentqualifizierung gesetzt werden können.

urlDestinationsEnabled

Typ
Erforderlich
Standardwert
Boolesch
Nein
true
Aktiviert URL-Ziele, die das Auslösen von URLs auf der Grundlage der Segmentqualifikation ermöglichen.

Identitätsoptionen

idSyncContainerId

Typ
Erforderlich
Standardwert
Zahl
Nein
Keine
Die Container-ID, die angibt, welche ID-Synchronisierungen ausgelöst werden. Dies ist eine nicht negative Ganzzahl, die Sie von Ihrem Berater erhalten können.

idSyncEnabled

Typ
Erforderlich
Standardwert
Boolesch
Nein
true
Aktiviert die ID-Synchronisierungsfunktion, mit der URLs ausgelöst werden können, um die Adobe-Unique User-ID mit der Unique User-ID einer Drittanbieter-Datenquelle zu synchronisieren.

thirdPartyCookiesEnabled

Typ
Erforderlich
Standardwert
Boolesch
Nein
wahr
Aktiviert die Einstellung von Adobe-Drittanbieter-Cookies. Das SDK kann die Besucher-ID in einem Drittanbieterkontext beibehalten, um die Verwendung derselben Besucher-ID auf der gesamten Site zu ermöglichen. Dies ist nützlich, wenn Sie mehrere Sites haben oder Daten mit Partnern teilen möchten. Dies ist jedoch manchmal aus Datenschutzgründen nicht wünschenswert.