context

Die context -Eigenschaft ist ein Array von Zeichenfolgen, die bestimmen, was das Web SDK automatisch erfassen kann. Diese Daten können zwar einen großen Wert bieten, es kann jedoch von Vorteil sein, einige dieser Daten wegzulassen, damit Sie die Datenschutzrichtlinien Ihres Unternehmens einhalten können.

Kontextbegriffe und XDM-Elemente

Wenn Sie einen bestimmten Kontextschlüsselwort angeben, füllt das Web SDK automatisch alle zugehörigen XDM-Elemente. Wenn Sie ein bestimmtes XDM-Element weglassen und andere zulassen möchten, können Sie Werte mithilfe von onBeforeEventSend. Wenn Sie mehrere Ereignisse auf einer Seite senden, enthält das Web SDK diese Felder auf jeder SendEvent aufrufen.

Web

Die "web" erfasst Informationen über die aktuelle Seite.

Dimension
Beschreibung
XDM-Pfad
Beispielwert
„Seiten-URL“
Die URL der aktuellen Seite.
xdm.web.webPageDetails.URL
https://example.com/index.html
Referrer-URL
Die URL der zuvor besuchten Seite.
xdm.web.webReferrer.URL
http://example.org/linkedpage.html

Gerät

Die "device" erfasst Informationen über das Gerät des Benutzers.

Dimension
Beschreibung
XDM-Pfad
Beispielwert
Bildschirmhöhe
Die Bildschirmhöhe in Pixel.
xdm.device.screenHeight
900
Bildschirmbreite
Die Bildschirmbreite in Pixel.
xdm.device.screenWidth
1440
Bildschirmausrichtung
Die Ausrichtung des Bildschirms.
xdm.device.screenOrientation
landscape oder portrait

Umgebung

Die "environment" erfasst Informationen zum Browser des Benutzers.

Dimension
Beschreibung
XDM-Pfad
Beispielwert
Umgebungstyp
Die Art der Umgebung, in der das Erlebnis auftauchte. Das Web SDK setzt dieses Feld immer auf browser.
xdm.environment.type
browser
Viewport-Höhe
Die Höhe des Inhaltsbereichs des Browsers in Pixel.
xdm.environment.browserDetails.viewportHeight
679
Viewport-Breite
Die Breite des Inhaltsbereichs des Browsers in Pixel.
xdm.environment.browserDetails.viewportWidth
642

Ortskontext

Die "placeContext" erfasst Informationen zum Standort des Benutzers.

Dimension
Beschreibung
XDM-Pfad
Beispielwert
Ortszeit
Lokaler Zeitstempel für den Endbenutzer in vereinfachtem erweiterten ISO 8601 Format.
xdm.placeContext.localTime
YYYY-08-07T15:47:17.129-07:00
Lokaler Zeitzonenversatz
Die Anzahl der Minuten, die der Benutzer von GMT versetzt wird.
xdm.placeContext.localTimezoneOffset
360
Ländercode
Der Ländercode des Endbenutzers.
xdm.placeContext.geo.countryCode
US
Bundesland
Der Bundesstaat-Code des Endbenutzers.
xdm.placeContext.geo.stateProvince
CA
Breitengrad
Der Breitengrad des Endbenutzerstandorts.
xdm.placeContext.geo._schema.latitude
37.3307447
Längengrad
Der Längengrad des Endbenutzerstandorts.
xdm.placeContext.geo._schema.longitude
-121.8945965

Zeitstempel

Die timestamp erfasst Informationen zum Zeitstempel des Ereignisses. Diese Kontextinformation kann nicht entfernt werden.

Dimension
Beschreibung
XDM-Pfad
Beispielwert
Zeitstempel des Ereignisses
UTC-Zeitstempel für Endbenutzer in vereinfachtem erweiterten ISO 8601 Format.
xdm.timestamp
2019-08-07T22:47:17.129Z

Implementierungsdetails

Die implementationDetails erfasst Informationen zur SDK-Version, die zur Erfassung des Ereignisses verwendet wird.

Dimension
Beschreibung
XDM-Pfad
Beispielwert
Name
Die Kennung des Software Development Kits (SDK). Dieses Feld verwendet einen URI, um die Eindeutigkeit der Kennungen zu verbessern, die von verschiedenen Software-Bibliotheken bereitgestellt werden.
xdm.implementationDetails.name
Bei Verwendung der eigenständigen Bibliothek lautet der Wert https://ns.adobe.com/experience/alloy. Wenn die Bibliothek als Teil der Tag-Erweiterung verwendet wird, lautet der Wert https://ns.adobe.com/experience/alloy+reactor.
Version
Die Version des Software Development Kits (SDK).
xdm.implementationDetails.version
Wenn die eigenständige Bibliothek verwendet wird, ist der Wert die Bibliotheksversion. Wenn die Bibliothek als Teil der Tag-Erweiterung verwendet wird, ist der Wert die Bibliotheksversion und die Tag-Erweiterungsversion wurde mit einer +. Wenn die Bibliotheksversion beispielsweise 2.1.0 und die Tag-Erweiterungsversion 2.1.3, würde der Wert 2.1.0+2.1.3.
Umgebung
Die Umgebung, in der die Daten erfasst wurden. Dies ist immer auf browser.
xdm.implementationDetails.environment
browser

Hohe Entropie-Client-Hinweise

Die "highEntropyUserAgentHints" erfasst detaillierte Informationen zum Gerät des Benutzers. Diese Daten sind im HTTP-Header der an Adobe gesendeten Anfrage enthalten. Nachdem die Daten im Edge-Netzwerk eintreffen, füllt das XDM-Objekt den entsprechenden XDM-Pfad. Wenn Sie den entsprechenden XDM-Pfad in der sendEvent aufrufen, hat er Vorrang vor dem HTTP-Header-Wert.

Wenn Sie die Gerätesuche verwenden, wenn Konfigurieren Ihres Datenspeichers, können Daten zugunsten von Gerätesuchwerten gelöscht werden. Einige Clienthinweisfelder und Geräte-Suchfelder können nicht im selben Treffer vorhanden sein.

Dimension
Beschreibung
HTTP-Header
XDM-Pfad
Beispielwert
Version des Betriebssystems
Die Betriebssystemversion.
Sec-CH-UA-Platform-Version
xdm.environment.browserDetails.
userAgentClientHints.platformVersion
Architektur
Die zugrunde liegende CPU-Architektur.
Sec-CH-UA-Arch
xdm.environment.browserDetails.
userAgentClientHints.architecture
Gerätemodell
Der Name des verwendeten Geräts.
Sec-CH-UA-Model
xdm.environment.browserDetails.
userAgentClientHints.model
Bitness
Die Anzahl der Bit, die die zugrunde liegende CPU-Architektur unterstützt.
Sec-CH-UA-Bitness
xdm.environment.browserDetails.
userAgentClientHints.bitness
Browser-Anbieter
Das Unternehmen, das den Browser erstellt hat. Der niedrige Entropiehinweis Sec-CH-UA erfasst auch dieses Element.
Sec-CH-UA-Full-Version-List
Browsername
Der verwendete Browser. Der niedrige Entropiehinweis Sec-CH-UA erfasst auch dieses Element.
Sec-UA-Full-Version-List
xdm.environment.browserDetails.
userAgentClientHints.brand
Browserversion
Die signifikante Version des Browsers. Der niedrige Entropiehinweis Sec-CH-UA erfasst auch dieses Element. Die genaue Browserversion wird nicht automatisch erfasst.
Sec-UA-Full-Version-List
xdm.environment.browserDetails.
userAgentClientHints.version

Erfassen von Kontextinformationen mithilfe der Web SDK-Tag-Erweiterung

Die Einstellung für Kontextinformationen ist eine Kombination aus Optionsfeldern und Kontrollkästchen, wenn Konfigurieren der Tag-Erweiterung. Jedes Kontrollkästchen wird einem Kontextschlüsselwort zugeordnet.

  1. Anmelden bei experience.adobe.com mit Ihren Adobe ID-Anmeldedaten.
  2. Navigieren Sie zu Datenerfassung > Tags.
  3. Wählen Sie die gewünschte Tag-Eigenschaft aus.
  4. Navigieren Sie zu Erweiterungen Klicken Sie auf Konfigurieren auf Adobe Experience Platform Web SDK Karte.
  5. Scrollen Sie nach unten zum Datenerfassung und wählen Sie entweder Alle standardmäßigen Kontextinformationen oder Spezifische Kontextdaten.
  6. Wenn Sie Spezifische Kontextdaten aktivieren Sie das Kontrollkästchen neben jedem gewünschten Kontextdatenelement.
  7. Klicks Speichern und veröffentlichen Sie dann Ihre Änderungen.

Kontextdaten mit der JavaScript-Bibliothek des Web SDK erfassen

Legen Sie die context Zeichenfolgen-Array beim Ausführen der configure Befehl. Wenn Sie diese Eigenschaft beim Konfigurieren des SDK weglassen, werden alle Kontextinformationen außer "highEntropyUserAgentHints" wird standardmäßig erfasst. Legen Sie diese Eigenschaft fest, wenn Sie Client-Hinweise mit hoher Entropie erfassen möchten oder wenn Sie andere Kontextinformationen aus der Datenerfassung auslassen möchten. Zeichenfolgen können in beliebiger Reihenfolge eingefügt werden.

NOTE
Wenn Sie alle Kontextinformationen, einschließlich Client-Hinweisen mit hoher Entropie, erfassen möchten, müssen Sie jeden Wert in die context Array-Zeichenfolge. Die Standardeinstellung context Wert omits highEntropyUserAgentHintsund wenn Sie die context -Eigenschaft, werden keine Daten von ausgesetzten Werten erfasst.
alloy("configure", {
  "edgeConfigId": "ebebf826-a01f-4458-8cec-ef61de241c93",
  "orgId": "ADB3LETTERSANDNUMBERS@AdobeOrg",
  "context": ["web", "device", "environment", "placeContext", "highEntropyUserAgentHints"]
});
recommendation-more-help
ad108910-6329-42f1-aa1d-5920a2b13636