Übersicht über Server SDK für JavaScript

Letzte Aktualisierung: 30. Oktober 2026

Themen:
Data Collection

Erstellt für:

Developer

Der Adobe Experience Platform-Server SDK für JavaScript oder Server SDK ist eine Bibliothek, die auf Ihrem Server ausgeführt wird und Daten an Adobe Experience Platform Edge Network sendet. Sie wird in Node.js und in anderen Server-seitigen JavaScript-Laufzeiten ausgeführt, die ihren entsprechen. Sie wird @adobe/alloy-node in npm veröffentlicht. In diesem Handbuch werden die grundlegenden Konzepte, die Installation, die Konfiguration und die Methoden behandelt.

Der SDK-Server teilt seinen Kern mit dem Web-SDK. Sie verwendet dieselben Datenströme dasselbe XDM)- und dieselben Identitäts- und Einverständnis-Cookies. Da sie auf einem Server und nicht in einem Browser ausgeführt wird, unterscheidet sie sich in der Erstellung, Authentifizierung und Verarbeitung der Anfragen der einzelnen Besucher.

IMPORTANT

Die Server-SDK befindet sich in der Alpha-Phase. Die Methoden, Optionen und das Verhalten können sich zwischen den Versionen ändern, und nur die unter Unterstützte Funktionen aufgeführten Funktionen sind verfügbar. Lesen Sie Versionshinweise bevor Sie ein Upgrade durchführen.

Verwendung des SDK-Servers when-to-use

Adobe bietet mehrere Möglichkeiten, Daten an Edge Network zu senden. Wählen Sie diejenige aus, die dem Ausführungsort des Codes entspricht:

Ansatz

Verwenden Sie sie, wenn

Web-SDK

Ihr Code wird im Browser des Besuchers ausgeführt. Web SDK kann personalisierte Inhalte rendern, Link-Klicks erfassen und den Seitenkontext automatisch lesen.

Server-SDK

Ihr Code wird auf einem JavaScript-Server ausgeführt, der die Anfrage des Besuchers verarbeitet. Beispiel: ein Server, der Seiten rendert, ein API-Backend oder Middleware, die Personalisierung abruft, bevor die Seite den Browser erreicht.

Edge Network-API

Sie möchten die Edge Network direkt, aus jeder Sprache, ohne Bibliothek aufrufen. Die Server-SDK ruft diese API für Sie auf.

Sie können die Server-SDK und die Web-SDK gemeinsam verwenden. Beispielsweise kann Ihr Server personalisierte Inhalte anfordern und der Browser kann sie rendern. Siehe Hybride Personalisierung.

Funktionsweise how-it-works

Wenn Ihr Server gestartet wird erstellen Sie eine Instanz und rufen configure einmal mit Ihrem Datenstrom, Ihrer Organisation und API-Anmeldeinformationen auf.
Für jede eingehende rufen Sie forRequest auf, um ein Handle zu erhalten, das für diesen Besucher gilt. Das -Handle liest und schreibt die Identität und das Einverständnis des Besuchers über den von Ihnen bereitgestellten Cookie-Service und leitet die Anforderungskopfzeilen des Besuchers (z. B. User-Agent) an die Edge Network weiter.
Sie rufen Methoden für das Handle auf z. B. sendEvent. Die SDK sendet Ereignisse an die authentifizierte Edge Network-Server-API unter Verwendung eines Zugriffstokens, das sie abruft und für Sie zwischenspeichert.
Die SDK gibt die Ergebnisse an Ihren Code zurück. Beispielsweise gibt sendEvent Personalisierungsvorschläge als Daten zurück. SDK rendert sie nicht. Ihre Anwendung entscheidet, was mit ihnen gemacht werden soll, z. B. ob sie in die Seite aufgenommen werden, damit die Web-SDK sie rendern kann.

Weitere finden Sie unter und Anfragen .

Unterstützte Funktionen features

In der folgenden Tabelle ist aufgeführt, was die Alpha-Version unterstützt. Siehe Unterschiede zu Web SDK für einen detaillierten Vergleich.

Funktion

Status

Senden von Ereignissen mit sendEvent

„Unterstützt“

Abrufen von Identitäten mit getIdentity und appendIdentityToUrl

„Unterstützt“

Einverständnis mit setConsent und defaultConsent

Unterstützt. defaultConsent akzeptiert nur "in" und "out".

Personalisierung mit personalization anfordern

Unterstützt. Vorschläge werden als Daten zurückgegeben und nicht gerendert.

Kontextdaten

Teilweise unterstützt. Siehe Kontext und weitergeleitete Kopfzeilen.

Debugging mit debugEnabled und setDebug

Unterstützt. Protokolle werden in die Konsole geschrieben.

Rendern von personalisierten Inhalten, Klick-Sammlung, Media Analytics, Push-Benachrichtigungen, Brand Concierge, Zielgruppen und regelbasierten Inhaltskarten

Nicht unterstützt

Anforderungen requirements

Bevor Sie den SDK-Server verwenden, stellen Sie Folgendes sicher:

Eine Server-seitige JavaScript-Laufzeit z. B. Node.js 22 oder höher. Die Laufzeit muss ECMAScript-Module unterstützen, da das Paket mit import geladen wird. Sie muss außerdem die folgenden Web-Standardglobals bereitstellen: fetch, Headers, URLSearchParams, crypto.getRandomValues, setTimeout, clearTimeout, atob, btoa, TextEncoder, TextDecoder und console. Siehe Laufzeitunterstützung.
Ein Datenstrom. Siehe Konfigurieren eines Datenstroms Wenn Sie getIdentity, appendIdentityToUrl oder setConsent verwenden, setzen Sie den Zugriffstyp des Datenstroms auf Gemischte Authentifizierung, da diese Methoden nicht authentifizierte Anfragen senden. Siehe Authentifizierung.
Eine OAuth-Server-zu-Server Anmeldedaten aus Adobe Developer Console. Die SDK erfordert dies und verwendet es zum Authentifizieren der von ihr gesendeten Ereignisse. Siehe Authentifizierung.
Ein XDM-Schema und -, wenn Sie Daten an Adobe Experience Platform senden.

Laufzeitunterstützung runtime-support

Die Server-SDK wird in jeder Server-seitigen JavaScript-Laufzeit unterstützt, die die Anforderungen erfüllt. Dies hängt nicht von Node.js-spezifischen Modulen ab. Seine standardmäßigen Plattform-Services verwenden nur Web-Standard-APIs wie fetch.

In diesen Handbüchern wird Node.js als primäres Beispiel für die Laufzeit verwendet. Code-Beispiele verwenden Node.js-Konventionen, z. B. das Lesen von Anmeldeinformationen aus process.env und die Verarbeitung von Anfragen mit dem node:http. Wenn Sie eine andere Laufzeit verwenden, ersetzen Sie diese Teile durch die Entsprechungen Ihrer Laufzeit. Die eigenen Methoden von SDK funktionieren in jeder unterstützten Laufzeit auf die gleiche Weise.

Source-Code und -Feedback source

Die Server-SDK ist Open Source. Der Quell-Code befindet sich im packages/node des adobe/alloy-Repositorys auf GitHub. Melden Sie Probleme und Anforderungsfunktionen in diesem Repository.

Nächste Schritte next-steps

recommendation-more-help

experience-platform-help-collection