DocumentazioneExperience PlatformRaccolta dati

[Alpha]{class="badge informative"}

Panoramica di Server SDK per JavaScript

Ultimo aggiornamento: 6 novembre 2026

Creato per:

  • Principiante
  • Sviluppatore

Adobe Experience Platform Server SDK per JavaScript, o Server SDK, è una libreria che viene eseguita sul server e invia dati a Adobe Experience Platform Edge Network. Viene eseguito in Node.js e in altri runtime JavaScript lato server che soddisfano i relativi requisiti. È pubblicato in npm come @adobe/alloy-node. Questa guida descrive i concetti di base, l’installazione, la configurazione e i metodi.

Il server SDK condivide la propria base con Web SDK. Utilizza gli stessi flussi di dati, lo stesso modello di dati XDM e gli stessi cookie di identità e consenso. Poiché viene eseguito su un server invece che in un browser, differisce nel modo in cui vengono create le istanze, autenticate e gestite le richieste di ogni visitatore.

IMPORTANT
Il server SDK è in modalità alfa. I metodi, le opzioni e il comportamento possono cambiare tra le versioni e sono disponibili solo le funzionalità elencate in Funzionalità supportate. Rivedi le note sulla versione prima di eseguire l'aggiornamento.

Quando utilizzare Server SDK when-to-use

Adobe offre diversi modi per inviare dati ad Edge Network. Scegli quello che corrisponde alla posizione di esecuzione del codice:

Approccio
Utilizzala quando
Web SDK
Il codice viene eseguito nel browser del visitatore. Il SDK web può eseguire il rendering di contenuti personalizzati, raccogliere i clic sui collegamenti e leggere automaticamente il contesto della pagina.
Server SDK
Il codice viene eseguito su un server JavaScript che gestisce la richiesta del visitatore. Ad esempio, un server che esegue il rendering delle pagine, un back-end API o un middleware che recupera la personalizzazione prima che la pagina raggiunga il browser.
API Edge Network
Desideri chiamare l’Edge Network direttamente, da qualsiasi lingua, senza una libreria. Il Server SDK chiama questa API per te.

È possibile utilizzare insieme Server SDK e Web SDK. Ad esempio, il server può richiedere contenuti personalizzati e il browser può eseguirne il rendering. Consulta Personalizzazione ibrida.

Come funziona how-it-works

  1. All’avvio del server, crea un’istanza e chiama configure una volta con lo stream di dati, l’organizzazione e le credenziali API.
  2. Per ogni richiesta in ingresso, chiama forRequest per ottenere un handle con ambito per quel visitatore. L’handle legge e scrive l’identità e il consenso del visitatore tramite il servizio cookie fornito e inoltra le intestazioni di richiesta del visitatore (ad esempio User-Agent) all’Edge Network.
  3. Chiamare i metodi sull’handle, ad esempio sendEvent. SDK invia eventi all’API server Edge Network autenticata utilizzando un token di accesso ottenuto e memorizzato nella cache.
  4. SDK restituisce i risultati al codice. Ad esempio, sendEvent restituisce proposte di personalizzazione come dati. Il SDK non li esegue. L’applicazione decide cosa farne, ad esempio includerli nella pagina del SDK Web per il rendering.

Per ulteriori dettagli, consulta Istanze e richieste.

Funzioni supportate features

Nella tabella seguente sono elencati i supporti del rilascio alfa. Vedi Differenze rispetto a Web SDK per un confronto dettagliato.

Funzione
Stato
Invia eventi con sendEvent
Supportato
Recupera identità con getIdentity e appendIdentityToUrl
Supportato
Consenso con setConsent e defaultConsent
Supportato. defaultConsent accetta solo "in" e "out".
Richiedi personalizzazione con personalization
Supportato. Le proposte vengono restituite come dati e non vengono sottoposte a rendering.
Dati contestuali
Parzialmente supportato. Vedi Intestazioni contestuali e inoltrate.
Debug con debugEnabled e setDebug
Supportato. I registri vengono scritti nella console.
Rendering di contenuti personalizzati, raccolta di clic, analisi dei contenuti multimediali, notifiche push, Brand Concierge, tipi di pubblico e schede di contenuti basate su regole
Non supportato

Requisiti requirements

Prima di utilizzare Server SDK, verificare di disporre dei seguenti elementi:

  • Un runtime JavaScript lato server, ad esempio Node.js 22 o versione successiva. Il runtime deve supportare i moduli ECMAScript perché il pacchetto viene caricato con import. Deve inoltre fornire i seguenti valori globali dello standard Web: fetch, Headers, URLSearchParams, crypto.getRandomValues, setTimeout, clearTimeout, atob, btoa, TextEncoder, TextDecoder e console. Consulta Supporto runtime.
  • Uno stream di dati. Vedere Configurare uno stream di dati. Se si utilizza getIdentity, appendIdentityToUrl o setConsent, impostare il tipo di accesso dello stream di dati su autenticazione mista, perché questi metodi inviano richieste non autenticate. Vedi Autenticazione.
  • Credenziali server-to-server OAuth da Adobe Developer Console. SDK lo richiede e lo utilizza per autenticare gli eventi inviati. Vedi Autenticazione.
  • Schema XDM e set di dati, se invii dati a Adobe Experience Platform.

Supporto runtime runtime-support

Server SDK è supportato in qualsiasi runtime JavaScript lato server che soddisfi i requisiti. Non dipende dai moduli specifici di Node.js. I relativi servizi Platform predefiniti utilizzano solo API standard Web, ad esempio fetch.

Queste guide utilizzano Node.js come runtime principale di esempio. Gli esempi di codice utilizzano le convenzioni di Node.js, ad esempio la lettura delle credenziali da process.env e la gestione delle richieste con il modulo node:http. Se si utilizza un runtime diverso, sostituire queste parti con gli equivalenti del runtime. I metodi di SDK funzionano allo stesso modo in ogni runtime supportato.

Codice Source e feedback source

Server SDK è open source. Il codice sorgente si trova nella cartella packages/node dell’archivio adobe/alloy su GitHub. Segnala i problemi e richiede le funzioni in tale archivio.

Passaggi successivi next-steps

recommendation-more-help
experience-platform-help-collection