Documentation Experience Platform Guide du SDK web

Création d’une version de Web SDK personnalisée

Dernière mise à jour : 5 mars 2025

Rubriques :

Créé pour :

Développeur

La bibliothèque Experience Platform Web SDK comprend plusieurs modules pour différentes fonctionnalités telles que la personnalisation, l’identité, le suivi des liens, etc. Selon vos cas d’utilisation, il se peut que vous n’ayez besoin que de fonctionnalités spécifiques au lieu de l’ensemble de la bibliothèque. La création d’une version Web SDK personnalisée vous permet de sélectionner uniquement les modules dont vous avez besoin, ce qui réduit la taille de la bibliothèque et améliore les performances.

Cas d’utilisation

La création d’une version Web SDK personnalisée permet de réduire la taille de la bibliothèque et d’améliorer les performances. Voici quelques exemples :

Suppression de Media Analytics

Si votre site web ne comporte pas de contenu multimédia, vous pouvez exclure les modules Media Analytics et Streaming Media de la version. Cela peut réduire la taille de la version de Web SDK de jusqu’à 50 % et améliorer la vitesse de chargement.

Suppression de Personalization

Si vous devez uniquement collecter des mesures d’utilisateur et ne prévoyez pas d’utiliser Adobe Target ou Journey Optimizer pour la personnalisation, vous pouvez exclure le module Personalization. Cela réduit la taille de la bibliothèque tout en vous permettant de collecter les mesures nécessaires.

Conditions préalables

Pour créer une version personnalisée de Web SDK, vous avez besoin du package NPM de Web SDK. Vérifiez que Node.js est installé sur votre ordinateur. Pour plus d’informations, consultez la documentation sur la installation du SDK Web à l’aide du package NPM.

Composants et dépendances

Avant de créer une version Web SDK personnalisée, définissez les composants et commandes Web SDK que vous prévoyez d’utiliser. Certaines commandes dépendent de modules spécifiques inclus dans la version.

Le tableau ci-dessous montre la relation entre les modules Web SDK et les commandes qu’ils incluent :

Dépendance du module	Paramètres de configuration	Commands	Catégorie de taille
Collecteur d’activités	`clickCollectionEnabled`	S/O	Méthode
Audiences	S.O.	S.O.	Petit
Contexte	`context`	S/O	Petit
Moteur de règles	`personalizationStorageEnabled`		`evaluateRulesets` `subscribeRulesetItems`
Fusion des événements	S/O	`createEventMergeId`	Petit
Bridge Media Analytics	S/O	`getMediaAnalyticsTracker`	Grand
Personnalisation	`prehidingStyle` `targetMigrationEnabled` `autoCollectPropositionInteractions`	S/O	Grand
Consentement	`defaultConsent`	`setConsent`	Petit
Streaming Media	`streamingMedia`	`createMediaSession` `sendMediaEvent`	Grand

Créer une version SDK Web personnalisée à l’aide du package NPM

Ouvrez votre terminal et exécutez npx @adobe/alloy. Vous êtes invité à sélectionner les composants Web SDK que vous souhaitez que votre version personnalisée inclue.

Utilisez les touches fléchées pour vous déplacer vers le haut et vers le bas dans la liste des modules.
- Appuyez sur Espace pour activer ou désactiver le module sélectionné.
- Appuyez sur A pour activer ou désactiver tous les modules.
- Appuyez sur I pour inverser votre sélection.
- Appuyez sur Enter pour confirmer votre sélection et passez à l’étape suivante.
Après avoir sélectionné les modules à inclure dans votre version personnalisée, vous pouvez choisir d’enregistrer une version miniaturisée ou non miniaturisée de votre version personnalisée de bibliothèque Web SDK. Sélectionnez l’option souhaitée et appuyez sur Enter.
Ensuite, vous êtes invité à indiquer l’emplacement où vous souhaitez enregistrer la version sur votre ordinateur local. Appuyez sur Enter pour confirmer l’emplacement présélectionné ou saisissez un nouvel emplacement.
Une fois l’emplacement confirmé, votre version personnalisée est générée et enregistrée.