événements personnalisés at.js

Dernière mise à jour : 5 mai 2025
  • Rubriques :

Créé pour :

  • Développeur

Informations sur at.js custom events, qui permet de savoir quand une requête ou une offre mbox échoue ou réussit.

Historiquement, mbox.js (désormais obsolète) ne laissait aucun autre code JavaScript s’exécutant sur la page savoir ce qui se passait en arrière-plan. Avec l’évolution d’at.js, nous avions une opportunité unique de résoudre ce problème.

Nos clients nous ont ainsi indiqué qu’ils souhaiteraient être informés dans différentes situations, notamment lorsque :

  • Une requête mbox a échoué en raison du délai d’attente, d’un code d’état erroné, d’une erreur d’analyse JSON, etc.
  • Une requête mbox a réussi.
  • Le rendu d’une offre a échoué en raison d’un élément mbox d’encapsulage manquant, d’un sélecteur introuvable, etc.
  • Le rendu d’une offre a réussi. Des modifications ont été appliquées au modèle DOM.

Les événements prédéfinis ont une structure qui vous permet d’extraire les données requises en fonction du type d’événement.

Pour s’assurer que des événements peuvent être utilisés dans différents scénarios, les événements personnalisés ont un objet de charge utile affecté à la propriété Détail de l’objet d’événement (transféré au gestionnaire). De plus, pour éviter de transférer des chaînes comme noms d’événements, les événements sont exposés sous la forme de constantes par le biais de l’espace de noms adobe.target.event.

Structure

CléTypeDescription
typeChaîne

Il existe plusieurs scénarios dans lesquels vous pouvez souhaiter être notifié afin de faciliter les activités de traçage, de débogage et de personnalisation de l’interaction avec at.js.

Chacun des événements personnalisés ci-dessous comporte deux formats : une « constante » et une « valeur de chaîne ».

  • Constantes  : précédées de adobe.target.event., présentées en majuscules et contenant des traits de soulignement. Pour vous abonner à des événements personnalisés après le chargement d’at.js, mais avant que la réponse mbox n’ait été reçue, utilisez le format de la constante.
  • Valeurs de chaîne  : en minuscules avec des tirets. Pour vous abonner à des événements personnalisés avant le chargement d’at.js, utilisez la valeur de chaîne.

Échec de la demande

Constante : adobe.target.event.REQUEST_FAILED

Valeur de chaîne : at-request-failed

Description : une requête mbox a échoué en raison du délai d’attente, d’un code d’état erroné, d’une erreur d’analyse JSON, etc.

Succès de la demande

Constante : adobe.target.event.REQUEST_SUCCEEDED

Valeur de chaîne : at-request-succeeded

Description : une requête mbox a réussi.

Échec de rendu du contenu

Constante : adobe.target.event.CONTENT_RENDERING_FAILED

Valeur de chaîne : at-content-rendering-failed

Description : le rendu d’une offre a échoué en raison d’un élément mbox d’encapsulage manquant, d’un sélecteur introuvable, etc.

Succès du rendu du contenu

Constante : adobe.target.event.CONTENT_RENDERING_SUCCEEDED

Valeur de chaîne : at-content-rendering-succeeded

Description : le rendu d’une offre a réussi. Des modifications ont été appliquées au modèle DOM.

Bibliothèque chargée

Constante : adobe.target.event.LIBRARY_LOADED

Valeur de chaîne : at-library-loaded

Description : cet événement est idéal pour suivre le moment où at.js a été entièrement chargé. Vous pouvez utiliser cet événement pour personnaliser l’exécution globale de mbox. Vous pouvez également l’utiliser pour désactiver la mbox globale, puis écouter cet événement de manière à en différer le déclenchement.

Début de la requête

Constante : adobe.target.event.REQUEST_START

Valeur de chaîne : at-request-start

Description : cet événement est déclenché avant l’exécution d’une requête HTTP. Vous pouvez utiliser cet événement pour effectuer des mesures de performances à l’aide de l’API de temporisation de ressources.

Début du rendu du contenu

Constante : adobe.target.event.CONTENT_RENDERING_START

Valeur de chaîne : at-content-rendering-start

Description : cet événement est déclenché avant le début de l’interrogation du sélecteur et le rendu du contenu sur la page. Vous pouvez utiliser cet événement pour effectuer le suivi de la progression du rendu du contenu.

Aucune offre rendue par le contenu

Constante : adobe.target.event.CONTENT_RENDERING_NO_OFFERS

Valeur de chaîne : at-content-rendering-no-offers

Description : cet événement est déclenché lorsqu’aucune offre n’est renvoyée.

Redirection du rendu du contenu

Constante : adobe.target.event.CONTENT_RENDERING_REDIRECT

Valeur de chaîne : at-content-rendering-redirect

Description : Cet événement est déclenché lorsqu’une offre est une redirection et que Target redirige vers une autre URL.

mboxChaînenom de mbox
messageChaîneContient une description explicite indiquant ce qui s’est passé, le message d’erreur, etc.
SuiviObjetContient sessionId et deviceId. Dans certains cas, deviceId peut être absent si Target n’est pas parvenu à le récupérer dans le serveur Edge.
typeChaîne

Artefact de prise de décision sur l’appareil réussi

Constante :

adobe.target.event.ARTIFACT_DOWNLOAD_SUCCEEDED

Valeur de chaîne : artifactDownloadSucceeded

Description : appelé lorsque l’artefact de prise de décision sur l’appareil est correctement téléchargé.

Échec de l’artefact de prise de décision sur l’appareil

Constante : adobe.target.event.ARTIFACT_DOWNLOAD_FAILED

Valeur de chaîne : artifactDownloadFailed

Description : appelé lorsque l’artefact de prise de décision sur l’appareil n’a pas pu être téléchargé.

Utilisation

document.addEventListener(adobe.target.event.REQUEST_SUCCEEDED, function(event) {
  console.log('Event', event);
});

Vidéo de formation : Jetons de réponse et événements personnalisés at.js Badge du tutoriel

Regardez la vidéo suivante pour savoir comment utiliser les jetons de réponse et les événements personnalisés at.js pour partager les informations de profil de Target avec des systèmes tiers.

Page précédentesendNotifications() - at.js 2.1
Page suivanteDéboguer at.js à l’aide du débogueur Adobe Experience Cloud

Target