Documentazione Experience Platform Guida di SDK Web

Creazione di una build Web SDK personalizzata

Ultimo aggiornamento: 5 marzo 2025

Argomenti:

Creato per:

Sviluppatore

La libreria Experience Platform Web SDK include più moduli per varie funzioni come personalizzazione, identità, tracciamento dei collegamenti e altro ancora. A seconda dei casi di utilizzo, potresti aver bisogno solo di funzionalità specifiche invece che dell’intera libreria. La creazione di una build Web SDK personalizzata consente di selezionare solo i moduli necessari, riducendo le dimensioni della libreria e migliorando le prestazioni.

Casi d’uso

La creazione di una build Web SDK personalizzata consente di ridurre le dimensioni della libreria e di migliorare le prestazioni. Di seguito sono riportati alcuni esempi:

Rimozione di Media Analytics

Se il sito Web non dispone di contenuti multimediali, è possibile escludere i moduli Media Analytics e Streaming Media dalla build. Questo può ridurre le dimensioni della build del Web SDK fino al 50% e migliorare la velocità di caricamento.

Rimozione Personalization

Se devi solo raccogliere le metriche utente e non prevedi di utilizzare Adobe Target o Journey Optimizer per la personalizzazione, puoi escludere il modulo Personalization. Questo riduce le dimensioni della libreria, consentendo al tempo stesso di raccogliere le metriche necessarie.

Prerequisiti

Per creare una build Web SDK personalizzata, è necessario il pacchetto NPM di Web SDK. Verifica che Node.js sia installato nel computer. Per ulteriori informazioni, vedere la documentazione su come installare Web SDK utilizzando il pacchetto NPM.

Componenti e dipendenze

Prima di creare una build di Web SDK personalizzata, definire i componenti e i comandi di Web SDK che si intende utilizzare. Alcuni comandi dipendono da moduli specifici inclusi nella build.

Nella tabella seguente viene illustrata la relazione tra i moduli di Web SDK e i comandi inclusi:

Dipendenza modulo	Parametri di configurazione	Comandi	Categoria dimensioni
Agente di raccolta attività	`clickCollectionEnabled`	N/D	Canale
Tipi di pubblico	N/D	N/D	Piccolo
Contesto	`context`	N/D	Piccolo
Motore di regole	`personalizationStorageEnabled`		`evaluateRulesets` `subscribeRulesetItems`
Unione eventi	N/D	`createEventMergeId`	Piccolo
Bridge di Media Analytics	N/D	`getMediaAnalyticsTracker`	Grande
Personalizzazione	`prehidingStyle` `targetMigrationEnabled` `autoCollectPropositionInteractions`	N/D	Grande
Consenso	`defaultConsent`	`setConsent`	Piccolo
Contenuti multimediali in streaming	`streamingMedia`	`createMediaSession` `sendMediaEvent`	Grande

Creare una build Web SDK personalizzata utilizzando il pacchetto NPM

Apri il terminale ed esegui npx @adobe/alloy. Viene chiesto di selezionare i componenti di Web SDK che si desidera includere nella build personalizzata.

Utilizzare i tasti freccia per spostarsi verso l'alto o verso il basso nell'elenco dei moduli.
- Premi Spazio per abilitare o disabilitare il modulo selezionato.
- Premere A per abilitare o disabilitare tutti i moduli.
- Premi I per invertire la selezione.
- Premi Enter per confermare la selezione e passare al passaggio successivo.
Dopo aver selezionato i moduli da includere nella build personalizzata, puoi scegliere se salvare una versione minimizzata o non minimizzata della build della libreria di Web SDK personalizzata. Selezionare l'opzione desiderata e premere Enter.
Successivamente, viene chiesto dove si desidera salvare la build nel computer locale. Premere Enter per confermare la posizione preselezionata o immettere una nuova posizione.
Una volta confermata la posizione, la build personalizzata viene generata e salvata.