Documentazione Experience Platform Raccolta dati

[Alpha]{class="badge informative"}

Differenze rispetto a Web SDK

Ultimo aggiornamento: 6 novembre 2026

Argomenti:
API server
Web SDK

Creato per:

Intermedio
Sviluppatore

Il server SDK e il Web SDK condividono lo stesso core, quindi inviano dati nello stesso formato, agli stessi flussi di dati e utilizzano gli stessi cookie. Poiché uno viene eseguito su un server e l’altro in un browser, le differenze sono molteplici. Utilizzare questa pagina per pianificare una migrazione o per condividere il codice tra un browser e un’implementazione del server.

Confronto comparison

Area

SDK per web

Server SDK

Dove viene eseguito

Browser del visitatore

Il server, in Node.js o in un altro runtime JavaScript lato server. Consulta Supporto runtime.

Installazione

Estensione tag, libreria JavaScript o pacchetto @adobe/alloy npm

Pacchetto npm @adobe/alloy-node. Vedi Installa.

Come lo chiami

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

alloy.sendEvent({ ... }). Vedi Panoramica dei metodi.

Istanze

Uno per caricamento di pagina, per un visitatore

Uno per processo, più un handle forRequest per ogni richiesta visitatore

Autenticazione

Nessuna

Obbligatorio. Gli eventi passano all’API server di Edge Network autenticata. Vedi Autenticazione.

Identità

Leggi e scrivi automaticamente nei cookie del browser

Leggi e scrivi in un servizio cookie fornito dall’utente. Ogni evento richiede una identità primaria.

Consenso

defaultConsent accetta "in", "out" e "pending"

defaultConsent accetta solo "in" e "out"

Personalizzazione

Richiede, esegue il rendering e tiene traccia della visualizzazione delle proposte

Richiede proposte e le restituisce. Non esegue il rendering né tiene traccia della visualizzazione.

Dati contestuali

Dettagli di pagina, dispositivo, ambiente, posizione e suggerimento client dal browser

Dettagli di implementazione, intestazioni di richiesta inoltrata del visitatore e URL della pagina dall’intestazione Referer. Vedi Intestazioni contestuali e inoltrate.

sendEvent risultato

propositions, inferences e destinations

propositions

Eseguire il debug

debugEnabled, setDebug, il parametro della stringa di query alloy_debug e Adobe Experience Platform Debugger

debugEnabled e setDebug, con messaggi scritti nella console

Hook di monitoraggio

Opzione monitors e variabile globale __alloyMonitors

Opzione monitors di createInstance

Metodi methods

Server SDK aggiunge il metodo forRequest, che non esiste nel Web SDK.

Supporta i seguenti comandi di Web SDK come metodi: appendIdentityToUrl, applyResponse, configure, getIdentity, getLibraryInfo, sendEvent, setConsent e setDebug.

I seguenti comandi di Web SDK non sono disponibili perché dipendono da un browser o da componenti non inclusi in Server SDK:

applyPropositions
createMediaSession
getMediaAnalyticsTracker
sendMediaEvent
sendPushSubscription
subscribeRulesetItems

Opzioni di configurazione configuration

Nuovo e obbligatorio: edgeCredentials.
Supportato: datastreamId, orgId, debugEnabled, defaultConsent, edgeBasePath, edgeConfigOverrides, edgeDomain, idMigrationEnabled, onBeforeEventSend e thirdPartyCookiesEnabled. Alcuni si comportano in modo diverso su un server. Consulta la pagina di ciascuna opzione.
Non supportato: ogni altra opzione di Web SDK. Se ne includi uno, configure rifiuta. Vedere Opzioni non supportate dal Server SDK.

opzioni sendEvent sendevent

Supportati: xdm, data, type, personalization.decisionScopes e personalization.surfaces, l’array decisionScopes di primo livello e edgeConfigOverrides.
Accettato, ma nessun effetto: renderDecisions, advertising e le altre proprietà personalization. Vedere Opzioni che non hanno alcun effetto su un server.
Evita: documentUnloading.

Domande frequenti faq

È possibile utilizzare Server SDK e Web SDK sullo stesso sito Web? same-site

Sì. Un modello comune consiste nel richiedere la personalizzazione sul server e nel renderizzarla nel browser. Consulta Personalizzazione ibrida. Entrambe le librerie possono inviare dati allo stesso flusso di dati se il relativo tipo di accesso è autenticazione mista. Entrambi utilizzano gli stessi nomi di cookie per l’identità e il consenso.

Perché ogni evento ha bisogno di un’identità primaria? primary-identity

Server SDK invia gli eventi all’API server Edge Network autenticata. Poiché la richiesta proviene dal server, Edge Network non può utilizzare i cookie del browser del visitatore per identificarli. Richiede invece un’identità primaria nell’evento. Vedere xdm.

È possibile utilizzare Server SDK nelle funzioni senza server? serverless

Sì, se il runtime della funzione soddisfa i requisiti. Crea e configura l’istanza al livello superiore del modulo, all’esterno del gestore funzioni. In questo modo, le chiamate a caldo riutilizzano l’istanza configurata e il relativo token di accesso memorizzato nella cache. Chiamare forRequest all’interno del gestore per ogni chiamata.

Posso utilizzare Adobe Experience Platform Debugger? debugger

No. Adobe Experience Platform Debugger è un’estensione del browser che controlla le pagine. Per eseguire il debug del Server SDK, impostare debugEnabled su true o chiamare setDebug e controllare l’output della console del server.

recommendation-more-help

experience-platform-help-collection