Versions

Une version est l’ensemble de fichiers contenant tout le code qui s’exécute sur le périphérique du client.

Il s’agit d’un ensemble des modifications que vous avez spécifiées dans votre bibliothèque, ainsi que de tout ce qui a été envoyé, approuvé ou publié auparavant.

La version se compose de fichiers de code côté client qui se font référence les uns aux autres. Ces fichiers sont transférés vers votre emplacement d’hébergement à l’aide de l’environnement et de l’hôte que vous avez choisis pour la bibliothèque. Le code que vous déployez sur votre site désigne ce même emplacement afin que les fichiers puissent se charger lorsqu’un utilisateur accède à votre site ou à votre application.

Contenu du fichier

Une bibliothèque définit un ensemble distinct de ressources Adobe Experience Platform Launch (extensions, règles et éléments de données) qui doivent y être incluses.

Une version contient tout le code du module (fourni par les développeurs d’extensions) et la configuration (que vous avez entrée) nécessaire pour alimenter les ressources contenues dans la bibliothèque. Par exemple, si une extension fournit des actions qui ne sont pas utilisées dans vos règles, le code permettant d’effectuer ces actions n’est pas contenu dans la version.

Les versions se composent du fichier de bibliothèque principal et potentiellement de nombreux fichiers plus petits. Le fichier de bibliothèque principal est référencé dans votre code intégré et chargé sur la page au moment de l’exécution. Il contient les éléments suivants :

  • Le moteur de règles
  • L’intégralité de la configuration de l’extension
  • L’intégralité de la configuration et du code d’élément de données
  • L’intégralité de la configuration et du code d’événement de règle
  • L’intégralité de la configuration et du code de condition
  • Le code d’événement et la configuration pour toutes les règles qui ont pour événement Library Loaded (Bibliothèque chargée) ou Page Bottom (Bas de page) (puisque nous savons que nous en aurons besoin tout de suite).

Les plus petits fichiers contiennent du code et une configuration pour des actions individuelles chargées sur la page, le cas échéant. Lorsqu’une règle est déclenchée et que ses conditions sont évaluées de telle sorte que les actions doivent être exécutées, le code et la configuration nécessaires pour cette action spécifique sont récupérés depuis l’un des fichiers les plus petits. Cela signifie que seul le code nécessaire pour effectuer les actions nécessaires est chargé sur la page, rendant ainsi la bibliothèque principale aussi petite que possible.

Format du fichier

Le format du fichier par défaut des versions est un ensemble de fichiers contenant tout le code requis pour que vos extensions, vos éléments de données et vos règles s’exécutent comme vous le souhaitez.

Cependant, dans certains cas, vous préférez peut-être une archive .zip des fichiers plutôt que le fichier de code côté client exécutable. Par exemple, vous pouvez créer une archive si vous hébergez vous-même votre version et si souhaitez l’utiliser dans un autre déploiement. Si vous fournissez des données dans le chemin d’auto-hébergement du champ de la bibliothèque, vous pouvez enregistrer votre environnement. Avec votre nouveau code, un lien d’accès au téléchargement archivé est mis à disposition. Platform Launch crée toujours votre bibliothèque et la déploie. Cependant, au lieu de déployer un ensemble de fichiers de code, vous pouvez déployer un fichier zip sur Akamai et le télécharger à partir de assets.adobedtm.com/....

Remarque

Cet emplacement ne contient rien jusqu’à ce que vous ayez créé une version.

Quel que soit le format de fichier, la version est toujours fournie à l’emplacement spécifié par l’hôte.

Pour terminer une version, sélectionnez une bibliothèque et cliquez sur l’option Build (Version) disponible à ce niveau du processus de publication (Build for Development (Créer à des fins de développement), Build for Staging (Créer à des fins d’évaluation), etc.).

Minimisation

La minimisation réduit les coûts liés à la bande passante et améliore la vitesse en supprimant les données inutiles à l’exécution depuis un fichier.

Pour accroître les performances, Platform Launch minimise tout, notamment les éléments suivants :

  • La bibliothèque Platform Launch principale
  • Le code de module fourni par les développeurs d’extensions dans le cadre d’une extension
  • Le code personnalisé fourni par les utilisateurs de Platform Launch
Remarque

Si votre code de module et le code personnalisé sont déjà minimisés, Platform Launch les minimise à nouveau. Cette seconde minimisation ne procure pas d’avantages supplémentaires, mais elle n’entraîne aucun dommage, tout en rendant Platform Launch moins complexe et plus facile à gérer.

Tout code côté client fourni dans Platform Launch désigne la version minimisée du code, comme on peut le constater dans les noms de fichier, qui respectent la convention d’appellation standard pour les fichiers minimisés :

launch-%environment_id%.min.js

Si vous souhaitez afficher le code non minimisé, supprimez .min du nom de fichier :

launch-%environment_id%.js

Si un développeur d’extensions fournit du code minimisé avec son extension, Platform Launch ne fournit pas de code non minimisé dans la version non minimisée. Platform Launch ne fournit que ce que le développeur d’extensions communique à Adobe. De même, si un utilisateur de Platform Launch place un code minimisé dans une zone de code personnalisé, ce code est toujours minimisé dans des versions non minimisées. Platform Launch ne maximise rien.

Pour plus d’informations sur la minimisation, reportez-vous à https://blog.stackpath.com/glossary/minification/.

Lors de la génération d’une version, Platform Launch crée d’abord la bibliothèque non minimisée, puis la minimise entièrement en une fois.

Sur cette page