Show Menu
SUJETS×

Migration de mbox.js vers at.js

La bibliothèque at.js est une nouvelle bibliothèque d’implémentation pour Adobe Target qui a été conçue pour les implémentations web classiques et les applications d’une seule page.
Autres avantages : at.js réduit les délais de chargement des pages pour les implémentations web et offre des options d’implémentation optimisées pour les applications d’une seule page.
at.js remplace mbox.js les Target implémentations. La bibliothèque at.js contient les composants qui étaient inclus dans target.js. Il n’y a donc plus d’appel à target.js.
Adobe Experience Manager (AEM) 6.2 et FP-11577 (ou version ultérieure) prend en charge les implémentations d’at.js et son intégration des services de cloud d’Adobe Target. Pour plus d’informations, voir Feature Packs (Packs de fonctionnalités) et Integrating with Adobe Target (Intégration à Adobe Target) de la documentation d’ Adobe Experience Manager 6.2 .

Avantages d’at.js

Le tableau suivant explique les différences entre les deux bibliothèques : 4 | Référence de la bibliothèque | Description | |— |— | |at.js|at.js remplace mbox.js pour les Target implémentations.
Autres avantages : at.js optimise les délais de chargement des pages pour les mises en œuvre web, renforce la sécurité, bloque les avertissements document.write dans Google Chrome et fournit de meilleures options d’implémentation pour les applications d’une seule page.
Pour plus d’informations, consultez Implémentation de at.js .| |mbox.js|Prior to Target 16.3.1 (March 2016), Target required a call to mbox.js to create the global mbox required for Target to deliver activities, track clicks, and track most success metrics. Ce fichier contient les bibliothèques nécessaires pour toutes vos activités. Vous n’avez ainsi pas à conserver différentes versions spécifiques à une activité du fichier.
Si vos pages contiennent déjà des mbox d’encapsulation issues d’un ancien style de mise en œuvre de Target, vous pouvez continuer à les utiliser dans la nouvelle interface. Le fichier mbox.js mis à jour reste requis ; toutefois, il est possible de sélectionner ces mbox pour des activités et de les modifier à l’aide du compositeur d’expérience visuelle.
Target Standard et Target Premium mettent à jour et complètent mbox.js avec une référence à un fichier target.js. Ce fichier target.js est hébergé par Adobe. Il permet de modifier le contenu sur n’importe quelle page à l’aide du compositeur d’expérience visuelle, et ce même si la page ne contient pas de mbox prédéfinies. Vous devez référencer ce fichier sur chaque page de votre site.
Pour plus d’informations, consultez Implémentation de mbox.js .
Important  : la bibliothèque mbox.js est toujours prise en charge, mais ses fonctionnalités ne seront plus mises à jour. Tous les clients doivent migrer vers at.js. Pour plus d’informations, voir Migration vers at.js depuis mbox.js
|

Implémentation d’at.js

Pour utiliser at.js, remplacez la référence à mbox.js dans les pages où vous souhaitez implémenter la bibliothèque. Vous ne pouvez pas utiliser mbox.js et at.js dans une même page. Vous pouvez en revanche utiliser une des deux bibliothèques sur chaque page de votre site.
La bibliothèque at.js fonctionne pour les implémentations existantes qui utilisent les fonctions mboxCreate() , mboxDefine() et mboxUpdate() . Elle prend aussi en charge les nouvelles fonctionnalités axées sur les implémentations basées sur les applications d’une seule page.
Vous pouvez utiliser at.js aux emplacements où vous utilisez actuellement mbox.js.
La bibliothèque at.js propose plusieurs améliorations par rapport à la bibliothèque mbox.js, notamment :
  • Communications entièrement asynchrones via AJAX interdomaine
    Bien que la bibliothèque at.js communique avec les serveurs Target de manière asynchrone, le fichier at.js doit être chargé de manière synchrone dans la section <head> de la page. Dans l’idéal, il doit être l’un des premiers scripts chargés. Une fois chargé, le fichier at.js exécute les appels de mbox de manière asynchrone via XMLHttpRequest et ne bloque pas le rendu des pages.
  • Plus d’appels de blocage
  • Aucun document.write() utilisé
  • Pas d’exécution immédiate de JavaScript dans les réponses de Target
  • Amélioration du délai d’attente et de la gestion des erreurs
    • Une expiration personnalisable par appel
    • Pas de rechargements à l’expiration
  • Des fonctions conçues spécifiquement pour les applications d’une seule page/les infrastructures MVC

Vidéo de formation : at.js - Bonnes pratiques sur les privilèges et l’implémentation

Cette vidéo est un enregistrement de «  Heures de bureau  », initiative lancée par l’équipe d’assistance clientèle d’Adobe.
  • Fonctionnement de la bibliothèque at.js
  • Avantages d’at.js par rapport à mbox.js
  • Gestion du scintillement par at.js
  • Gestion des erreurs dans at.js
  • Méthodologies de débogage
  • Problèmes connus et feuille de route future