Dokumentation Experience Platform Datenerfassung

[Alpha]{class="badge informative"}

Unterschiede zu Web SDK

Letzte Aktualisierung: 30. Oktober 2026

Themen:
Data Collection

Erstellt für:

Developer

Die Server-SDK und Web-SDK verwenden denselben Kern, sodass sie Daten im selben Format und in denselben Datenströmen senden und dieselben Cookies verwenden. Da die eine auf einem Server und die andere in einem Browser ausgeführt wird, unterscheiden sie sich in mehrfacher Hinsicht. Verwenden Sie diese Seite, um eine Migration zu planen oder Code zwischen einem Browser und einer Server-Implementierung freizugeben.

Vergleich comparison

Bereich

Web SDK

Server-SDK

Wo er läuft

Der Browser des Besuchers

auf Ihrem Server, in Node.js oder einer anderen serverseitigen JavaScript-Laufzeit. Siehe Laufzeitunterstützung.

Installation

Tag-Erweiterung, JavaScript-Bibliothek oder das @adobe/alloy npm-Paket

Das @adobe/alloy-node npm-Paket. Siehe Installieren.

So nennt man das

alloy("sendEvent", { ... })

alloy.sendEvent({ ... }). Siehe Methodenübersicht.

Instanzen

Ein Seitenladevorgang pro Seite, d. h. ein Besucher

Eine pro Prozess und ein forRequest für jede Besucheranfrage

Authentifizierung

Kein(e)

Erforderlich. Ereignisse werden an die authentifizierte Edge Network-Server-API gesendet. Siehe Authentifizierung.

Identität

Aus Browser-Cookies auslesen und automatisch in diese schreiben

Lesen Sie aus und schreiben Sie in einen von Ihnen bereitgestellten Cookie-Service. Jedes Ereignis benötigt eine primäre Identität.

Einverständnis

defaultConsent akzeptiert "in", "out" und "pending"

defaultConsent akzeptiert nur "in" und "out"

Personalisierung

Fordert die Anzeige von Vorschlägen an, rendert sie und verfolgt sie

Fordert Vorschläge an und gibt sie zurück. Rendert sie nicht und verfolgt nicht ihre Anzeige.

Kontextdaten

Details zu Seite, Gerät, Umgebung, Ort und Client-Hinweisen im Browser

Implementierungsdetails, die weitergeleiteten Anfragekopfzeilen des Besuchers und die Seiten-URL aus dem Referer. Siehe Kontext und weitergeleitete Kopfzeilen.

sendEvent

propositions, inferences und destinations

propositions

Debugging

debugEnabled, setDebug, der alloy_debug Abfragezeichenfolgenparameter und Adobe Experience Platform Debugger

debugEnabled und setDebug, mit Meldungen, die in die Konsole geschrieben werden

Überwachungshaken

Die Option monitors und die globale Variable __alloyMonitors

Die monitors Option von createInstance

Methoden methods

Die Server-SDK fügt die forRequest hinzu, die in der Web-SDK nicht vorhanden ist.

Sie unterstützt die folgenden Web SDK-Befehle als Methoden: appendIdentityToUrl, applyResponse, configure, getIdentity, getLibraryInfo, sendEvent, setConsent und setDebug.

Die folgenden Web SDK-Befehle sind nicht verfügbar, da sie von einem Browser oder von Komponenten abhängen, die der SDK-Server nicht enthält:

applyPropositions
createMediaSession
getMediaAnalyticsTracker
sendMediaEvent
sendPushSubscription
subscribeRulesetItems

Konfigurationsoptionen configuration

Neu und erforderlich: edgeCredentials.
Unterstützt: datastreamId, orgId, debugEnabled, defaultConsent, edgeBasePath, edgeConfigOverrides, edgeDomain, idMigrationEnabled, onBeforeEventSend und thirdPartyCookiesEnabled. Einige von ihnen verhalten sich auf einem Server anders. Sehen Sie sich die Seite jeder Option an.
Nicht unterstützt: Jede andere Option von Web SDK. Wenn Sie eine einbeziehen, lehnt configure ab. Siehe Optionen, die der SDK-Server nicht unterstützt.

sendEvent-Optionen sendevent

Unterstützt: xdm, data, type, personalization.decisionScopes und personalization.surfaces, das decisionScopes-Array der obersten Ebene und edgeConfigOverrides.
Akzeptiert, aber keine Auswirkung: renderDecisions, advertising und die anderen personalization. Siehe Optionen, die sich nicht auf einen Server auswirken.
Vermeiden: documentUnloading.

Häufig gestellte Fragen faq

Kann ich die Server-SDK und die Web-SDK auf derselben Website verwenden? same-site

Ja. Ein gängiges Muster besteht darin, eine Personalisierung auf dem Server anzufordern und sie im Browser zu rendern. Siehe Hybride Personalisierung. Beide Bibliotheken können Daten an denselben Datenstrom senden, wenn sein Zugriffstyp „Gemischte ". Beide verwenden dieselben Cookie-Namen für Identität und Einverständnis.

Warum benötigt jedes Ereignis eine primäre Identität? primary-identity

Der SDK-Server sendet Ereignisse an die authentifizierte Edge Network-Server-API. Da die Anfrage von Ihrem -Server stammt, kann die Edge Network die Browser-Cookies des Besuchers nicht verwenden, um ihn zu identifizieren. Stattdessen ist eine primäre Identität für das Ereignis erforderlich. Siehe xdm.

Kann ich die Server-SDK in Server-losen Funktionen verwenden? serverless

Ja, wenn die Laufzeit der Funktion die Anforderungen erfüllt. Erstellen und konfigurieren Sie die Instanz auf der obersten Ebene Ihres Moduls außerhalb des Funktions-Handlers. Auf diese Weise können Warm-Aufrufe die konfigurierte Instanz und ihr zwischengespeichertes Zugriffstoken wiederverwenden. Rufen Sie für jeden Aufruf forRequest innerhalb des Handlers auf.

Kann ich Adobe Experience Platform Debugger verwenden? debugger

Nein. Adobe Experience Platform Debugger ist eine Browser-Erweiterung, die Seiten überprüft. Um die Server-SDK zu debuggen, setzen Sie debugEnabled auf true oder rufen Sie setDebug auf, und überprüfen Sie die Konsolenausgabe Ihres Servers.

recommendation-more-help

experience-platform-help-collection