Informations détaillées sur les modifications apportées à chaque version de la Bibliothèque JavaScript at.js Adobe Target.
L’équipe de Cible prend en charge at.js 1.x et at.js 2.x. Effectuez la mise à niveau vers la mise à jour la plus récente de l’une des versions majeures d’at.js pour vous assurer que vous exécutez une version prise en charge.
Adobe Experience Platform Launchest la méthode préférée pour mettre à niveau at.js. Les développeurs d’extensions ajoutent continuellement de nouvelles fonctionnalités à leurs extensions et corrigent fréquemment les bogues. Ces mises à jour sont incluses dans de nouvelles versions d'une extension et sont disponibles dans le catalogue Launch en tant que mises à niveau. Pour plus d’informations, voir Mise à niveau de l’extension dans le Guide de l’utilisateur Experience Platform Launch.
Cette version d’at.js est une version de maintenance et comprend les correctifs suivants :
Cette version d’at.js est une version de maintenance et comprend les correctifs suivants :
Cette version d’at.js est une version de maintenance et comprend les correctifs suivants :
Cette version d’at.js est une version de maintenance et comprend les correctifs suivants :
Cette version d’at.js est une version de maintenance qui comprend les améliorations et correctifs suivants :
deviceIdLifetime
a été remplacé par targetGlobalSettings. (TNT-36349)sendBeacon
. (TNT-36407, TNT-35990, TNT-36000)Cette version d’at.js est une version de maintenance qui comprend les améliorations et correctifs suivants :
targetGlobalSettings.cspScriptNonce
et targetGlobalSettings.cspStyleNonce
de sorte qu’at.js puisse définir le script et les balises de style correspondants sur les offres appliquées. Voir targetGlobalSettings pour plus d’informations.check
en at_check
afin d’éviter les collisions avec les implémentations des clients.Cette version d’at.js est une version de maintenance qui comprend les améliorations et correctifs suivants :
check
en at_check
afin d’éviter les collisions avec les implémentations des clients.Cette version d’at.js comprend les améliorations et correctifs suivants :
Correction d’un problème en raison duquel le suivi des clics ne signalait pas les conversions dans Analytics pour la Cible (A4T) lorsque le code Adobe Analytics n’était pas présent sur les éléments de page.
Amélioration des performances lors de l’utilisation du service d’identification des Experience Cloud (ECID) v4.4 et at.js 2.2 sur vos pages Web.
Auparavant, l’ECID effectuait deux appels de blocage avant qu’at.js puisse récupérer des expériences. Ceci a été réduit à un seul appel, ce qui améliore considérablement les performances.
Mettez à niveau votre extension de lancement ECID vers la version 4.4 pour tirer parti de cette amélioration des performances.
at.js version 2.2 fournit également un nouveau paramètre appelé serverState
. Ce paramètre peut être utilisé pour optimiser les performances des pages lorsqu’une intégration hybride de Cible est implémentée. L’intégration hybride signifie que vous utilisez at.js v2.2+ côté client et l’API de diffusion ou un SDK de Cible côté serveur pour diffuser des expériences. serverState
donne à at.js v2.2+ la possibilité d’appliquer des expériences directement à partir du contenu récupéré côté serveur et renvoyé au client dans le cadre de la page diffusée. Pour plus d’informations, voir "serverState" dans targetGlobalSettings.
Cette version d’at.js comprend les améliorations et correctifs suivants :
Mettez à niveau votre extension de lancement ECID vers la version 4.4 pour tirer parti de cette amélioration des performances.
Cette version d’at.js est une version de maintenance qui comprend les améliorations et correctifs suivants :
(Les numéros de problèmes entre parenthèses sont réservés à une utilisation interne par Adobe.)
triggerView()
d’effectuer plusieurs fois le rendu des offres. (TNT-32780)triggerView()
pour s’assurer que la demande contient les informations Experience Cloud ID (ECID). (TNT-32776)triggerView()
de se déclencher même si aucune vue n’était enregistrée. (TNT-32614)Navigator.sendBeacon()
. (TNT-32683)mboxThirdPartyId
à l’aide de la fonction targetPageParams
. La charge utile de la requête n’était pas présente dans les paramètres de requête ou dans la charge utile de requête. (TNT-32613)Cette version comprend les fonctionnalités et améliorations suivantes :
Prise en charge de la fonctionnalité Adobe Opt-in : Adobe Opt-in est un moyen de simplifier les intégrations des solutions Adobe avec les plateformes de gestion des autorisations. Pour plus d’informations sur la fonctionnalité Adobe Opt-in, voir Confidentialité et protection générale des données (RGPD).
Compatibilité avec la norme CSP du secteur : at.js n’utilise plus eval() pour exécuter JavaScript.
Journalisation des analyses côté client : Donne aux clients un contrôle total sur la manière d’envoyer des données d’analyse à Adobe Analytics, que ce soit côté client ou côté serveur.
Pour plus d’informations, voir Journalisation Analytics côté client dans Avant l’implémentation.
Envoi de notifications : Permet aux développeurs d’envoyer des notifications lorsqu’une expérience est générée par leur code au lieu d’utiliser applyOffer()
ou applyOffers()
.
Pour plus d’informations, voir adobe.target.sendNotifications(options).
Taille d’at.js réduite de ~24 % : La taille d’at.js est réduite de ~24 %. Un fichier plus petit permet d’améliorer les performances de chargement des pages et réduit le temps de téléchargement du fichier at.js sur la page.
Cette version de maintenance comprend les améliorations et correctifs suivants :
(Les numéros de problème entre parenthèses sont destinés à une utilisation interne par Adobe.)
Cette version est une version de maintenance et inclut les modifications suivantes :
(Les numéros de problème entre parenthèses sont destinés à une utilisation interne par Adobe.)
at.js 2 propose des ensembles de fonctionnalités enrichies qui permettent à votre entreprise d’exécuter la personnalisation sur les technologies côté client de génération suivante. Cette nouvelle version vise à mettre à niveau at.js afin d’établir des interactions harmonieuses avec les applications monopages (SPA).
Voici quelques avantages de l’utilisation d’at.js 2.x qui ne sont pas disponibles dans les versions précédentes :
at.js 2.x introduit les nouvelles fonctions suivantes :
Les fonctions suivantes ont été abandonnées à l’introduction de la version at.js 2.x :
Pour plus d’informations, voir Mise à niveau d’at.js 1.x vers at.js 2.x et Fonctions at.js.
Si vous avez besoin de la prise en charge de la fonction Adobe Opt-in pour le Règlement général sur la protection des données (RGPD), vous devez actuellement utiliser at.js 1.7.0 ou at.js 2.1.0.
at.js 1.7.0 prend en charge Adobe Opt-in. Adobe Opt-in est un moyen de simplifier les intégrations des solutions Adobe avec les plateformes de gestion des autorisations.
Pour plus d’informations sur Adobe Opt-in, voir Confidentialité et Règlement général sur la protection des données (RGPD).
Cette version corrige également le problème selon lequel Target remplace les paramètres d’URL de redirection par les paramètres provenant de l’URL de redirection.
Si vous avez besoin de la prise en charge de la fonction Adobe Opt-in pour le RGPD, vous devez utiliser at.js 1.7.0 ou 2.1.0.
Pour obtenir la liste de toutes les versions, voir Informations sur les versions d’at.js.
at.js 1.6.4 est une version de maintenance qui résout le problème suivant :
La version 1.6.3 d’at.js comprend les correctifs et améliorations suivants :
Il s’agit d’une version de maintenance qui résout le problème suivant :
En outre, l’ensemble des améliorations et correctifs présents dans les versions 1.6.1 et 1.6.0 d’at.js le sont également dans la version 1.6.2. Ces deux anciennes versions ne sont désormais plus disponibles au téléchargement. Nous vous recommandons de mettre at.js à niveau vers la version 1.6.2 si vous utilisez les versions 1.6.1 ou 1.6.0
Voici les améliorations et les correctifs apportés dans la version 1.6.1 d’at.js :
Voici les améliorations et les correctifs apportés dans la version 1.6.0 d’at.js :
at.js version 1.5.0 est désormais disponible.
Les détails de l’événement at-request-succeeded
contiennent l’indicateur de redirection. Cet indicateur peut être utilisé pour déterminer si la page sera redirigée vers une URL différente. Si vous souhaitez connaître l’URL, abonnez-vous à at-content-rendering-redirect
. (TNT-29834)
Résolution d’un problème qui faisait échouer window.targetGlobalSettings.enabled
avec une exception d’exécution s’il était défini sur false. (TNT-29829)
Résolution d’un problème qui faisait échouer la page lors du chargement dans le compositeur d’expérience visuelle (VEC) en cas d’utilisation de code personnalisé pour déclencher une demande mbox globale et à l’aide du masquage des corps. (TNT-29795)
Ajout de la prise en charge de screenOrientation
, devicePixelRatio
et webGLRenderer
. Ces nouveaux paramètres de demande de Target sont utilisés pour la détection de l’iPhone X et d’autres appareils modernes. Pour plus d’informations, voir Mobile. (TNT-29781)
Résolution du problème où le conseil d’emplacement d’Adobe Audience Manager (AAM) n’était pas toujours envoyé. (TNT-29695)
Pour les navigateurs qui le prennent en charge, at.js 1.5.0 passe à MutationObserver pour l’interrogation du sélecteur. Les versions antérieures à at.js 1.0.0 utilisaient un polyfill MutationObserver, qui s’avérait problématique. Pour éviter les problèmes de polyfill, la version 1.5.0 utilise le pseudo code suivant afin de choisir le mécanisme de planification à utiliser :
if MutationObserver is supported
scheduler = MutationObserver
else if document is visible
scheduler = requestAnimationFrame
else
scheduler = setTimeout
at.js version 1.3.0 est désormais disponible.
Les nouveaux événements suivants sont disponibles afin de faciliter les activités de traçage, de débogage et de personnalisation de l’interaction avec at.js :
Pour plus d’informations, voir Événements personnalisés de at.js.
Vous pouvez augmenter une requête at.js au moyen de paramètres complémentaires issus des fournisseurs de données. Les fournisseurs de données doivent être ajoutés à window.targetGlobalSettings
sous la dataProviders key
.
Pour plus d’informations, voir Fournisseurs de données.
Les requêtes at.js font désormais appel à GET, mais permutent sur le mode POST lorsque la taille de l’URL dépasse 2 048 caractères. Une nouvelle propriété nommée urlSizeLimit
vous permet d’augmenter la taille limite si nécessaire. Cette modification permet à Target d’aligner at.js avec AppMeasurement, qui utilise la même technique.
Target applique désormais la clé mbox
dans la fonction adobe.target.applyOffer(options)
. Cette clé était obligatoire par le passé, mais Target force désormais son application de manière à garantir sa validation et l’utilisation correcte de la fonction par les clients.
La fonctionnalité de suivi des événements et des clients a été améliorée dans at.js. at.js utilise navigator.sendBeacon()
pour envoyer les données de suivi d’événement et revient en mode XHR synchrone lorsque navigator.sendBeacon()
n’est pas pris en charge. Cette solution de secours concerne principalement Internet Explorer 10 et 11, ainsi que certaines versions de Safari. Safari comprendra une prise en charge supplémentaire de navigator.sendBeacon()
dans la prochaine version d’iOS 11.3.
at.js peut désormais assurer le rendu des offres même lorsqu’une page est ouverte dans les onglets d’arrière-plan. Certains clients Target ont signalé qu’en cas de désactivation de requestAnimationFrame()
, un problème de goulet d’étranglement se produisait dans le navigateur pour les onglets d’arrière-plan.
Cette version apporte de nombreuses améliorations de performances, y compris des piles d’appels plus courtes lors de l’inspection d’un profil CPU Chrome.
at.js 1.3.0 ne prend plus en charge la diffusion de contenu sur Microsoft Internet Explorer 9. Pour obtenir la liste des navigateurs pris en charge, voir Navigateurs pris en charge. Dorénavant, toutes les requêtes sont exécutées via XMLHttpRequest
avec prise en charge de CORS sans requêtes JSONP. Cette modification améliore considérablement la sécurité.
La version 1.2.3 de at.js est désormais disponible.
La version 1.2.2 de at.js est désormais disponible.
getOffer() params
lorsque targetPageParams()
renvoie une chaîne vide. (TNT-28359)La version 1.2.1 de at.js est désormais disponible.
at.js version 1.2 est désormais disponible sous la forme d’une version de maintenance contenant principalement des correctifs de bogues.
target="_blank"
empêchait Target d’ouvrir le lien dans un nouvel onglet. (TNT-28072)sdidParamExpiry
est correctement initialisé et transféré à l’API visiteur. Il s’agit d’une régression qui a été ajoutée à at.js 1.1.0
. Les versions précédentes d’at.js ne sont pas affectées. Cela affecte uniquement les clients utilisant les offres de redirection et A4T. (TNT-27791)SCRIPT
est exécuté quel que soit l’attribut type utilisé. (TNT-27865)Date : 2 août 2017
Les améliorations et correctifs suivants sont inclus dans la version 1.1 de at.js :
document.currentScript polyfill
n’interfère plus avec Angular 1.X.at-element-click-tracking
au lieu de at-element-marker
.Date : 7 juillet 2017
Les améliorations et correctifs suivants sont inclus dans la version 1.0 d’at.js :
getOffer()
() qui produisait une erreur sur certains sites web.Date : 22 mai 2017
Les améliorations et correctifs suivants sont inclus dans la version 0.9.7 de at.js :
insertAfter
et insertBefore
dans le compositeur d’expérience visuelle. Ces problèmes étaient liés à la migration d’offres visuelles vers des modèles d’offres.Date : 13 avril 2017
Les améliorations et correctifs suivants sont inclus dans la version 0.9.6 de at.js :
Prise en charge de l’offre de redirection pour A4T. Après avoir téléchargé et installé la version 0.9.6 d’at.js, vous pouvez utiliser les offres de redirection dans les activités qui utilisent Adobe Analytics comme source de création de rapports pour Target (A4T). Outre la version 0.9.6 d’at.js, d’autres exigences doivent être respectées pour pouvoir utiliser les offres de redirection et A4T dans la mise en œuvre. Pour en savoir plus et obtenir d’autres informations importantes, voir FAQ sur les offres de redirection (A4T).
Avant la version 0.9.6 d’at.js, lorsque l’API visiteur était présente sur la page et que le paramètre visitorApiTimeout
était trop agressif, ne pouvait pas s’exécuter quand aucune donnée MCID n’était envoyée dans la demande TargetTarget. Il pouvait en résulter certains problèmes, par exemple des accès désassemblés dans Analytics lors de l’utilisation d’A4T.
Ce comportement a été modifié dans at.js 0.9.6 : même si visitorApiTimeout
est défini à 1 ms, par exemple, Target tente de collecter le SDID, les données des serveurs de suivi et les identifiants client et les envoie dans la demande Target.
Ajout du paramètre selectorsPollingTimeout
. Pour plus d’informations, voir targetGlobalSettings().
Le format de la réponse de getOffer()
a été modifié. Pour plus d’informations, voir adobe.target.getOffer(options).
Ajout de la journalisation de la console pour les déclarations <!DOCTYPE>
non prises en charge.
Correction d’un problème en raison duquel les modules externes de Target Classic n’étaient pas correctement appliqués lorsque plusieurs offres par défaut étaient diffusées à une seule mbox. (TGT-22664)
Amélioration du paramètre de cookie pour les domaines de niveau supérieur à deux lettres afin de s’assurer que le cookie de mbox est correctement défini pour ces domaines (par exemple, test.no,autodrives.ca, etc.).
L’algorithme d’extraction du domaine de premier niveau devant être utilisé lors de l’enregistrement des cookies a été modifié dans la version 0.9.6 d’at.js. En raison de cette modification, les cookies ne peuvent pas être enregistrés dans des adresses utilisant le protocole IP. La plupart du temps, les adresses IP sont utilisées à des fins de test mais, comme solutions de contournement, vous pouvez utiliser les entrées DNS ou ajuster le fichier des hôtes sur une box locale.
Correction de la gestion des actions de déplacement et de réorganisation lorsque les propriétés sont des valeurs de chaîne au lieu d’entiers.
Date : 19 janvier 2017
Dans un souci de respect des exigences d’attribution de nom des mbox utilisant mbox.js, les noms de mbox peuvent maintenant contenir des caractères spéciaux, y compris des esperluettes ( & ).
Pour obtenir une liste des caractères spéciaux autorisés, voir Configurations at.js.
Ajout du paramètre secureOnly
, qui indique si at.js doit utiliser le protocole HTTPS seulement ou s’il peut permuter entre les protocoles HTTP et HTTPS en fonction du protocole de la page. Il s’agit d’un paramètre avancé défini par défaut sur false ; il peut être remplacé au moyen de targetGlobalSettings
.
L’option Prise en charge du navigateur hérité est proposée dans les versions 0.9.3 et antérieures d’at.js. Elle a été supprimée de la version 0.9.4 d’at.js.
Date : 10 octobre 2016.
Date : 21 septembre 2016.
optoutEnabled
pour activer ou désactiver le service d’exclusion du graphique de périphérique. Si ce paramètre est défini sur true
et que le visiteur a choisi de ne pas autoriser le suivi, son navigateur n’effectuera aucun appel de mbox. Le graphique de périphérique est actuellement en version bêta. Ce paramètre est défini sur false
par défaut, mais doit être défini sur true
si vous utilisez le graphique de périphérique. Une option similaire est incluse dans la version 61 de mbox.js.CustomEvent
pour le mécanisme de notification. Avant, le mécanisme de notification d’événement d’at.js ne pouvait pas être utilisé avec les API du modèle DOM standard telles que document.addEventListener()
. Désormais, vous pouvez utiliser document.addEventListener()
pour vous inscrire aux événements at.js, tels que les événements de requête et les événements de rendu de contenu.Date : 14 juillet 2016.
Version de Target : 16.6.1
Date : 23 juin 2016
Corrige un problème d’écran blanc lors de l’utilisation d’offres du compositeur d’expérience visuelle. Les utilisateurs qui utilisent la bibliothèque at.js doivent effectuer une mise à niveau vers cette nouvelle version.
Nouvelle API registerExtension
.
Cette nouvelle API permet aux développeurs d’avoir accès à certains modules jQuery utilisés dans at.js pour développer des extensions (ou modules externes) pour la bibliothèque. Ce changement a quelques répercussions. Il affecte uniquement les utilisateurs qui utilisent les fonctions suivantes :
L’API getSettings()
a été supprimée, mais la même fonctionnalité est disponible avec registerExtension()
.
L’API getTracking()
a été supprimée, mais la même fonctionnalité est disponible avec registerExtension()
.
Les extensions existantes (notamment les extensions AngularJS) doivent être mises à jour pour utiliser l’approche registerExtension()
.
Nouvelle API de notification at.js.
Ce système de notification a pour objectif de fournir davantage d’informations sur ce qu’at.js fait sur la page et quand il y a des problèmes. Un problème courant rencontré avec le compositeur d’expérience visuelle est qu’une version IT modifie la page, un sélecteur du compositeur d’expérience visuelle se brise et le test cesse de fournir le contenu correctement. L’un des objectifs de ce système de notification est de rendre ce problème visible sur la page de manière à ce que les développeurs puissent accéder à ces informations, les transmettre à un système, comme Adobe Analytics, et envoyer des alertes aux exploitants les informant que leur test est interrompu.
Nouvelle méthode d’API targetGlobalSettings()
.
Vous pouvez remplacer les paramètres de la bibliothèque at.js au lieu de configurer les paramètres dans l’interface utilisateur de Target Standard/Premium UI ou utiliser des API REST.
Date : 5 mai 2016.
Il s’agit de la première version officielle de la bibliothèque at.js.
at.js est une nouvelle bibliothèque d’implémentation pour Target qui a été conçue pour les implémentations web classiques et les applications d’une seule page.
at.js remplace mbox.js pour les implémentations Adobe Target.
Bien que at.js remplace mbox.js, mbox.js reste prise en charge. Pour la plupart des utilisateurs, at.js offre des avantages par rapport à mbox.js. Vous avez du temps pour tester la bibliothèque at.js et pour modifier l’implémentation sur vos pages.
Autres avantages : at.js réduit les délais de chargement des pages pour les implémentations web, renforce la sécurité et offre des options d’implémentation optimisées pour les applications d’une seule page.
at.js contient les composants qui étaient inclus dans target.js. Il n’y a donc plus d’appel à target.js.
Lors de l’implémentation de la bibliothèque at.js, souvenez-vous des points suivants :