DocumentationJourney OptimizerGuide de Journey Optimizer

Résoudre les problèmes d’exécution de votre parcours actif troubleshooting-execution

Last update: Thu Dec 11 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • S'applique à :
  • Journey Orchestration
  • Rubriques :

Créé pour :

  • Intermédiaire
  • Utilisateur ou utilisatrice

Dans cette section, découvrez comment résoudre les problèmes liés aux événements de parcours, vérifier si des profils ont rejoint le parcours ainsi que leur progression, et si des messages sont envoyés.

Vous pouvez également résoudre les erreurs avant de tester ou de publier un parcours. Découvrez comment procéder sur cette page.

Si vous utilisez des actions entrantes, découvrez comment résoudre les problèmes liés à ces dernières sur cette page.

Vérifier l’envoi correct des événements checking-that-events-are-properly-sent

Le point de départ d'un parcours est toujours un événement. Il est possible d'effectuer des tests à l'aide d'outils tels que Postman.

Vous pouvez ainsi vérifier si l'appel d'API émis via ces outils est correctement envoyé ou non. Si vous obtenez une erreur en retour, cela signifie que votre appel a rencontré un problème. Vérifiez à nouveau la payload, l'en-tête (et en particulier l'identifiant d'organisation) et l'URL de destination. Vous pouvez demander à votre administrateur l'URL appropriée pour l'accès.

Les événements ne sont pas directement transmis de la source aux parcours. En effet, les parcours s’appuient sur les API d’ingestion en flux continu d’Adobe Experience Platform. En cas de problèmes relatifs aux événements, vous pouvez consulter la documentation d’Adobe Experience Platform pour la résolution des problèmes liés aux API d’ingestion en flux continu.

Si votre parcours ne parvient pas à activer le mode test avec l’erreur ERR_MODEL_RULES_16, assurez-vous que l’événement utilisé inclut un espace de noms d’identité lors de l’utilisation d’une action de canal.

L’espace de noms d’identité est utilisé pour identifier de manière unique les profils de test. Par exemple, si l'e-mail est utilisé pour identifier les profils de test, l’espace de noms d’identité E-mail doit être sélectionné. Si l’identifiant unique est le numéro de téléphone, l’espace de noms d’identité Téléphone doit être sélectionné.

Vérifier si les personnes rejoignent le parcours checking-if-people-enter-the-journey

Les rapports produits par Journey donnent des mesures en temps réel des entrées des visiteurs dans un parcours.

Si l’événement a été envoyé avec succès, mais que vous ne voyez aucune entrée dans le parcours, cela signifie qu’une erreur s’est produite entre l’envoi de l’événement et la réception de l’événement dans le parcours.

Pour résoudre votre problème, commencez par répondre aux questions suivantes :

  • Êtes-vous certain que le parcours où vous attendez l'événement entrant est en mode test ou actif ?

  • Avez-vous enregistré l'événement avant de copier la payload depuis l'aperçu de la payload ?

  • La payload d'événement contient-elle un identifiant d'événement ?

  • Avez-vous atteint la bonne URL ?

  • Avez-vous appliqué la structure de payload des API d'ingestion en flux continu en utilisant l'aperçu de la structure de payload dans le volet de configuration des événements ? Voir cette page.

  • Avez-vous utilisé les paires clé-valeur appropriées dans l’en-tête de l’événement ?

    code language-none 
    X-gw-ims-org-id - your organization's ID
Content-type - application/json

​>>
Pour les parcours de qualification d’audience avec audiences en streaming : si vous utilisez une activité de qualification d’audience comme point d’entrée d’un parcours, gardez à l’esprit que tous les profils correspondant aux critères de cette audience ne rejoindront pas nécessairement le parcours, en raison de facteurs de délai, de sorties rapides de l’audience ou du fait qu’ils se trouvaient déjà dans l’audience avant la publication. En savoir plus sur les considérations relatives au délai de qualification des audiences en streaming.

Résolution des problèmes liés aux transitions en mode test troubleshooting-test-transitions

Si les profils de test ne progressent pas dans votre parcours en mode test ou si le flux visuel n’affiche pas de flèches vertes indiquant la progression de l’étape, le problème peut être lié à la validation de la transition. Cette section fournit des conseils sur le diagnostic et la résolution des problèmes courants du mode test.

Profils de test sans progression

Si les profils de test rejoignent le parcours mais ne progressent pas au-delà de l’étape initiale, vérifiez les points suivants :

  • Date de début du Parcours - La cause la plus courante est lorsque la date de début du parcours est définie dans le futur. Les profils de test sont immédiatement ignorés si l’heure actuelle se situe en dehors de la fenêtre dates/heure de début et de fin configurée du parcours. Pour résoudre :

    • Vérifiez que la date de début du parcours n'est pas définie dans le futur
    • Assurez-vous que l’heure actuelle se situe dans la fenêtre de date active du parcours
    • Si nécessaire, mettez à jour les propriétés du parcours pour ajuster la date de début

  • Configuration du profil de test - Vérifiez que le profil est correctement marqué comme profil de test dans Adobe Experience Platform. Pour plus d’informations​ voir ​ Création de profils de test .

  • Espace de noms d’identité - Assurez-vous que l’espace de noms d’identité utilisé dans la configuration d’événement correspond à l’espace de noms de votre profil de test.

Indicateurs de transition nuls

Lors du dépannage technique, vous pouvez rencontrer une propriété isValidTransition définie sur null dans les détails techniques du parcours. Cette propriété réservée à l’interface utilisateur n’a aucune incidence sur le traitement principal ou les performances du parcours. Cependant, une valeur nulle peut indiquer :

  • Mauvaise configuration du Parcours - La date de début du parcours est définie dans le futur, ce qui entraîne l’abandon silencieux des événements de test
  • Transition corrompue - Dans de rares cas, les nœuds de parcours doivent être reconnectés

Si vous rencontrez des problèmes de transition persistants :

  1. Vérifier que la date de début du parcours est actuelle
  2. Désactiver et réactiver le mode test
  3. Si le problème persiste, pensez à dupliquer les nœuds de parcours concernés et à les reconnecter
  4. Pour les cas non résolus, contactez l’assistance avec les journaux de parcours, les identifiants de profil concernés et des détails sur la transition nulle
NOTE
N’oubliez pas que les événements envoyés en dehors de la fenêtre de date active du parcours sont ignorés silencieusement, sans message d’erreur. Commencez toujours par vérifier votre configuration de minutage de parcours lors du dépannage de la progression du profil de test.

Vérifier comment les gens naviguent dans le parcours checking-how-people-navigate-through-the-journey

Les rapports produits par Journey mesurent la progression des individus dans un parcours. Il est très facile d'identifier où et pourquoi une personne s'est arrêtée.

Les éléments à vérifier sont les suivants :

  • La situation est-elle due à une condition excluant la personne concernée ? Par exemple, la condition est « genre = masculin » et la personne est une femme. Si la condition n'est pas trop complexe, un utilisateur chargé de la conception de parcours peut effectuer cette vérification.
  • La situation est-elle due à une source de données qui ne répond pas ? Lorsque le parcours est en test, ces informations apparaissent dans les journaux du mode test. Lorsque le parcours est actif, un administrateur peut tester les appels directs à la source de données et vérifier la réponse reçue. Il peut également dupliquer le parcours et le tester.

Vérifier que les messages sont bien envoyés checking-that-messages-are-sent-successfully

Si les personnes progressent correctement dans le parcours sans recevoir les messages qu’ils devraient recevoir, vous pouvez vérifier les points suivants :

  • Journey Optimizer a correctement pris en compte la demande d'envoi. Les utilisateurs professionnels peuvent accéder au message censé être envoyé et vérifier si l’heure de la dernière exécution correspond à l’heure d’exécution de votre parcours. Ils peuvent également vérifier les derniers appels/événements d’API reçus.
  • Journey Optimizer a envoyé le message avec succès. Vérifiez les rapports sur les parcours pour vous assurer qu’il n’y a aucune erreur.

Dans le cas d’un message envoyé par le biais d’une action personnalisée, le seul élément vérifiable pendant le test du parcours est l’apparition ou non d’une erreur suite à l’appel du système à l’aide d’une action personnalisée. Si l’appel au système externe associé à l’action personnalisée n’entraîne pas d’erreur, mais ne déclenche pas l’envoi d’un message, certaines vérifications doivent être effectuées du côté du système externe.

Explication des entrées en double dans les événements d’étape de parcours duplicate-step-events

Pourquoi est-ce que je vois plusieurs entrées avec les mêmes ID d’instance de parcours, de profil, de nœud et de requête ?

Lors de l’interrogation des données d’événements d’étape de parcours, vous pouvez parfois détecter des entrées de journal en double pour la même exécution de parcours. Ces entrées partagent des valeurs identiques pour les éléments suivants :

  • profileID - Identité du profil
  • instanceID - Identifiant de l’instance de parcours
  • nodeID - Nœud de parcours spécifique
  • requestID - Identifiant de la requête

Cependant, ces entrées ont des valeurs _id différentes, ce qui indique qu’il ne s’agit pas d’une duplication réelle des données.

Qu’est-ce qui provoque ce comportement ?

Cela se produit en raison des opérations de mise à l’échelle automatique du système back-end (également appelées « rééquilibrage ») dans l’architecture des microservices d’Adobe Journey Optimizer. Pendant les périodes de forte charge ou d’optimisation du système :

  1. un événement d’étape de parcours commence à être traité et est enregistré dans le jeu de données Événements d’étape de parcours ;
  2. une opération de mise à l’échelle automatique redistribue la charge de travail entre les instances de service ;
  3. le même événement peut être retraité par une autre instance de service, créant ainsi une seconde entrée de journal avec une valeur _id différente.

Il s’agit d’un comportement système attendu qui fonctionne comme prévu.

Y a-t-il un impact sur l’exécution du parcours ou la diffusion des messages ?

Non. L’impact ne concerne que la journalisation. Adobe Journey Optimizer dispose de mécanismes de déduplication intégrés au niveau de la couche d’exécution des messages qui garantissent ce qui suit :

  • Un seul message (e-mail, SMS, notification push, etc.) est envoyé à chaque profil.
  • Les actions sont exécutées une seule fois.
  • L’exécution du parcours se déroule correctement.

Vous pouvez vérifier en interrogeant le ajo_message_feedback_event_dataset ou en consultant les journaux d’exécution d’action. Vous verrez qu’un seul message a été réellement envoyé, malgré les entrées d’événement d’étape de parcours en double.

Comment puis-je identifier ces cas dans mes requêtes ?

Lors de l’analyse des données d’événements d’étape de parcours :

  1. Vérifier le champ _id : les vrais doublons au niveau du système auraient la même valeur _id. Des valeurs _id différentes indiquent qu’il s’agit d’entrées de journal distinctes du scénario de rééquilibrage décrit ci-dessus.

  2. Vérifier la diffusion du message : comparez avec les données de feedback sur les messages pour confirmer qu’un seul message a été envoyé :

    code language-sql 
    SELECT
  timestamp,
  _experience.customerJourneyManagement.messageExecution.messageExecutionID,
  _experience.customerJourneyManagement.messageDeliveryfeedback.feedbackStatus
FROM ajo_message_feedback_event_dataset
WHERE
  _experience.customerJourneyManagement.messageExecution.journeyVersionID = '<journeyVersionID>'
  AND TO_JSON(identityMap) like '%<profileID>%'
ORDER BY timestamp DESC;

  3. Regrouper par identifiants uniques : lors du comptage des exécutions, utilisez _id pour obtenir des décomptes précis :

    code language-sql 
    SELECT
  COUNT(DISTINCT _id) as unique_executions
FROM journey_step_events
WHERE
  _experience.journeyOrchestration.stepEvents.journeyVersionID = '<journeyVersionID>'
  AND _experience.journeyOrchestration.stepEvents.profileID = '<profileID>'

Que dois-je faire si cela se produit ?

Il s’agit d’un comportement normal du système et aucune action n’est requise. La journalisation en double n’indique aucun problème au niveau de la configuration du parcours ou de la diffusion des messages.

Si vous créez des rapports ou des analyses en fonction d’événements d’étape de parcours :

  • Utilisez _id comme clé primaire pour compter les événements uniques.
  • Comparez avec les jeux de données de feedback sur les messages lors de l’analyse de la diffusion des messages.
  • Gardez à l’esprit que l’analyse temporelle peut afficher des entrées regroupées sur quelques secondes d’intervalle.

Pour plus d’informations sur l’interrogation des événements d’étape de parcours, voir Exemples de requêtes.

Résolution des problèmes liés aux incohérences des mesures du tableau de bord dashboard-metrics

Si les mesures affichées dans le tableau de bord Vue d’ensemble ne correspondent pas au nombre réel de parcours dans l’onglet Parcourir, vérifiez les points suivants :

  • Assurez-vous que les parcours en question ont eu du trafic au cours des dernières 24 heures, car les parcours sans activité récente sont exclus du tableau de bord.
  • Vérifiez que vous disposez des autorisations d’accès appropriées pour afficher tous les parcours de votre organisation.
  • Patientez jusqu’à 30 minutes pour que les mesures s’actualisent après avoir apporté des modifications à vos parcours.

Si les incohérences persistent, contactez l’assistance Adobe avec des copies d’écran des onglets Vue d’ensemble et Parcourir pour en savoir plus.

recommendation-more-help
b22c9c5d-9208-48f4-b874-1cefb8df4d76