Résolution des problèmes liés aux actions entrantes dans les parcours troubleshooting-inbound-actions
Sur cette page : découvrez comment déboguer et résoudre les problèmes courants liés aux actions entrantes, tels que les expériences in-app, web et basées sur du code, dans un parcours avant de demander de l’aide.
Les actions entrantes, telles que les expériences in-app, web et basées sur du code, sont des composants essentiels de Journey Optimizer, car elles permettent un engagement personnalisé avec les utilisateurs et utilisatrices pendant leur parcours. Cependant, un comportement inattendu, tel qu’un contenu entrant manquant ou une diffusion continue après la sortie d’un profil du parcours, peut se produire.
Ce guide fournit une procédure détaillée pour déboguer les problèmes liés aux actions entrantes dans un parcours, afin que vous puissiez les identifier et les résoudre indépendamment avant de contacter l’assistance.
Conditions préalables prerequisites
Avant de commencer le dépannage :
-
Configurez une session Assurance. Découvrez comment le faire dans la documentation d’Adobe Experience Platform .
-
Accédez au parcours contenant l’action entrante pour récupérer le nom du parcours et l’ID de version.
note NOTE L’ID de version du parcours se trouve dans l’URL après « journey/ » (par exemple, 86232fb1-2932-4036-8198-55dfec606fd7). 
-
Cliquez sur l’action entrante pour en afficher les détails. Récupérez le libellé et l’identifiant de l’action entrante.
-
Obtenez l’espace de noms et l’identifiant du profil pour identifier celui qui rencontre des problèmes. Selon votre configuration, l’espace de noms peut être ECID, e-mail ou ID client, par exemple. Découvrez comment rechercher un profil dans la documentation Experience Platform.
Scénario 1 : la personne n’a pas reçu le contenu entrant. scenario-1
Dans ce scénario, un profil a rejoint l’action entrante dans le parcours, mais même après 30 minutes, le contenu entrant correspondant ne s’affiche pas dans l’appareil/le client à l’étape de déclenchement de la configuration.
Contrôles préalables pre-checks
-
Le jeu de données entrant du parcours est activé pour l’ingestion de profil.
L’action entrante utilise le jeu de données Parcours entrant pour les mises à jour de profil pendant l’exécution. Assurez-vous que le jeu de données est activé pour les profils dans le sandbox actuel. En savoir plus sur les jeux de données
-
Identité joai définie dans les identités de la plateforme
L’action entrante utilise l’espace de noms joai dans le
segmentMembershipde profil pour activer le profil de l’étape entrante. Vérifiez qu’elle a été définie dans les identités de plateforme pour le sandbox. En savoir plus sur le Service d’identités Experience Platform
Étapes de débogage debugging-steps
Le graphique ci-dessous montre la séquence des étapes de débogage que vous pouvez suivre :
Étape 1 : vérifier si l’appareil/client reçoit le contenu du réseau Edge step-1
Commencez par vérifier si l’appareil ou le client obtient le contenu attendu.
-
Accédez à la session Assurance et sélectionnez la section Messagerie In-App dans le panneau de gauche.
-
Dans l’onglet Messages sur l’appareil, cliquez sur la liste déroulante Messages.
-
Recherchez un message avec le nom de parcours suivi de « - Message in-app ». S’il est présent, cela signifie que le message in-app est présent sur l’appareil/le client et que le problème peut être lié au déclencheur in-app.
-
Si le message est introuvable, le message in-app n’a pas été reçu par l’appareil/le client.
Étape 2 : vérifier si le réseau Edge renvoie le contenu step-2
Cette étape permet de s’assurer qu’Edge Network renvoie le contenu entrant attendu pour le rendu sur l’appareil ou le client.
Lorsqu’un profil rejoint une action entrante dans un parcours, il est automatiquement qualifié en segment d’audience spécial (dans l’espace de noms joai) correspondant à l’action de parcours entrante.
Lorsqu’un client ou une cliente effectue une requête à Edge Network pour un profil et une surface donnés, le profil est qualifié pour recevoir du contenu pour les actions de parcours entrantes ciblant cette surface, uniquement si le profil est actuellement membre du segment joai correspondant.
Pour déboguer le comportement d’Edge Network, procédez comme suit.
-
Ouvrez la vue Edge Delivery dans la session Assurance. Cette vue fournit des informations sur l’exécution de l’action entrante sur le serveur Edge Network. Pour en savoir plus, consultez la documentation Experience Platform.
-
Vérifiez si l’activité Edge correspondant à l’action entrante est répertoriée dans les sections Activités qualifiées ou Activités non qualifiées.
- Si elle se trouve dans la section Activités qualifiées, le profil est qualifié pour l’action de parcours entrante et le contenu doit être renvoyé.
- Si elle se trouve dans la section Activités non qualifiées, le profil n’était pas qualifié pour l’action de parcours entrante. Pour plus d’informations, consultez les raisons d’exclusion ci-dessous.
- Si elle se trouve dans aucune section, soit un problème est survenu lors de la publication de l’action de parcours entrante dans Edge Network, soit l’URI de surface demandé ne correspondait pas aux paramètres de configuration du canal pour l’action entrante.
note NOTE Pour rechercher votre activité Edge dans la session Assurance, recherchez l’activité où audienceNamespace est joai et audienceSegmentId est <JourneyVersionID>_<JourneyActionID> (par exemple, 86232fb1-2932-4036-8198-55dfec606fd7_708f718d-8503-4427-ad8d-8e28979b554c). 
-
Si votre activité se trouve dans la section Activités non qualifiées et que la raison de l’exclusion est Le segment n’est pas actif, cela signifie que le serveur de diffusion Edge Network ne pense pas que le profil fait partie du segment d’audience joai approprié.
Vous pouvez vérifier si le segment joai est présent dans la vue du profil du serveur de diffusion Edge Network en ouvrant l’élément segmentsMap de la section Profil et en recherchant la présence de l’identifiant de segment joai.
-
Si le serveur de diffusion Edge Network ne voit pas le profil comme se trouvant dans le segment joai approprié, passez à l’étape suivante.
Étape 3 : vérifier si l’appartenance à l’audience « joai » s’est propagée à Edge Network step-3
Cette étape permet de vérifier que le profil Edge a été correctement mis à jour lorsque le profil a rejoint l’action de parcours entrante et qu’il a été qualifié dans le segment joai correspondant.
Lorsqu’un profil est qualifié dans un segment joai, il est d’abord mis à jour sur le Hub, puis l’appartenance au segment est projetée vers le profil Edge afin qu’il soit utilisé par le serveur de diffusion Edge Network.
Pour vérifier la présence du segment joai dans l’attribut segmentMembership du profil Edge, procédez comme suit.
-
Accédez au menu Client ou cliente > Profils dans le volet de navigation de gauche de Journey Optimizer et accédez au profil à l’aide de l’espace de noms et de l’identifiant. En savoir plus sur les Profils clients en temps réel
-
Sélectionnez l’onglet Attributs et choisissez la vue Edge.
-
Cliquez sur Vue JSON pour ouvrir la vue JSON du profil.
-
Accédez à l’attribut
segmentMembershipet vérifiez si l’identifiant de segment <JourneyVersionID>_<JourneyActionID> est présent dans l’espace de noms joai et si son statut est réalisé .
-
S’il est présent, le segment joai correspondant à l’action de parcours entrante a été correctement propagé dans le profil Edge.
-
S’il n’est pas affiché dans la vue du profil du serveur de diffusion Edge Network, il y a peut-être un problème lié à la manière dont le serveur de diffusion charge le profil Edge.
-
-
Si l’identifiant de segment joai n’est pas présent ou si son statut est sorti, cela signifie qu’il n’a pas (encore) été propagé vers Edge.
Patientez 15 à 30 minutes pour que les valeurs
segmentMembershipsoient propagées du Hub vers Edge. S’il n’est toujours pas présent, passez à l’étape suivante.
Étape 4 : vérifiez si l’appartenance à l’audience « joai » est présente dans le profil sur le hub step-4
Cette étape permet de vérifier que le profil Hub a été correctement mis à jour lorsque le profil a rejoint l’action de parcours entrante et qu’il a été qualifié dans le segment joai correspondant.
Pour vérifier la présence du segment joai dans l’attribut segmentMembership du profil Hub, procédez comme suit.
-
Accédez au menu Client ou cliente > Profils dans le volet de navigation de gauche de Journey Optimizer et accédez au profil à l’aide de l’espace de noms et de l’identifiant. En savoir plus sur les Profils clients en temps réel
-
Sélectionnez l’onglet Attributs et choisissez la vue Hub.
-
Cliquez sur Vue JSON pour ouvrir la vue JSON du profil.
-
Accédez à l’attribut segmentMembership et vérifiez si l’identifiant du segment <JourneyVersionID>_<JourneyActionID> est présent dans l’espace de noms joai et si son statut est réalisé .
-
S’il est présent, le segment joai correspondant à l’action de parcours entrante a été correctement ingéré dans le profil Hub.
-
S’il est introuvable dans le profil Edge après 30 minutes, il y a peut-être un problème lié au système de projection Edge.
-
-
Si l’identifiant de segment joai n’est pas présent ou a le statut sorti, cela signifie que le profil n’était pas (encore) correctement qualifié dans le segment d’audience joai spécial lors de l’entrée dans l’action de parcours entrante correspondante.
Patientez 15 à 30 minutes pour que les valeurs
segmentMembershipsoient ingérées dans le profil du Hub. S’il n’est toujours pas présent, passez à l’étape suivante.
Étape 5 : si le client/appareil n’obtient toujours pas le contenu attendu step-5
Si vous avez suivi toutes les étapes ci-dessus et que vous n’obtenez pas le comportement attendu après avoir attendu 30 à 60 minutes que l’appartenance au segment se propage vers Edge Network, contactez l’assistance clientèle d’Adobe ou votre représentant ou représentante Adobe.
Incluez autant de détails que possible à propos des étapes de débogage, tels que :
- l’étape où vous constatez le comportement inattendu ;
- l’identifiant de version du parcours ;
- l’identifiant d’action du parcours ;
- la trace complète d’Assurance ;
- la vue JSON du profil Edge ;
- la vue JSON du profil Hub ;
- etc.
Scénario 2 : l’utilisateur ou l’utilisatrice reçoit toujours le contenu entrant scenario-2
Ce scénario est l’inverse du Scénario 1 : le profil a quitté le parcours, mais l’utilisateur ou l’utilisatrice reçoit toujours le contenu entrant.
Cependant, lorsqu’un profil quitte un parcours, il ne devrait plus être qualifié pour les segments d’audience joai correspondant aux actions entrantes du parcours.
Suivez les mêmes étapes de débogage que pour le Scénario 1 afin de vérifier si le profil Hub, le profil Edge et le serveur de diffusion Edge Network reflètent correctement le statut d’appartenance au segment joai concerné, et si le client ou la cliente ne reçoit plus le contenu entrant.
Cette section contient des connaissances structurées destinées à soutenir l’interprétation, la récupération et la réponse aux questions liées à ce sujet.
Pour une compréhension totale, ces informations doivent être combinées avec la documentation de cette page. Aucune des sources n’est conçue pour être autonome. La page décrit la fonctionnalité, tandis que cette section fournit un contexte supplémentaire qui permet de clarifier la terminologie, l’intention, l’applicabilité et les contraintes.
- TL;DR: Cette page fournit un guide de débogage en libre-service détaillé pour deux scénarios d’action entrante dans les parcours Adobe Journey Optimizer : un profil qui entre dans une étape entrante mais ne reçoit pas le contenu, et un profil qui continue à recevoir du contenu après avoir quitté le parcours.
Intentions:
- Configurez une session Assurance comme condition préalable au débogage des problèmes d’action entrante
- Vérifiez si l’appareil ou le client reçoit du contenu entrant d’Edge Network à l’aide d’Assurance
- Vérifiez les activités qualifiées et non qualifiées d’Edge Network pour déterminer si un profil est éligible pour une action de parcours entrante
- Vérifiez que l’appartenance au segment d’audience Joai s’est propagée du profil Hub au profil Edge
- Diagnostiquer les retards dans l’ingestion de segments entrants sur le profil Hub après qu’un profil entre dans une action entrante
- Envoyez le problème à l’assistance clientèle d’Adobe avec les informations de diagnostic correctes lorsque les étapes en libre-service ne les résolvent pas
Glossaire:
- Actions entrantes : activités de Parcours qui diffusent du contenu personnalisé sur l’appareil ou le navigateur d’un utilisateur, y compris les canaux d’expérience in-app, web et basés sur du code (spécifiques au produit)
- espace de noms joai : espace de noms d’identité spécial utilisé dans les
segmentMembershipde profil pour activer un profil pour une étape d’action de parcours entrante (spécifique au produit) - segment joai : segment d’audience créé automatiquement dans l’espace de noms joai et correspondant à une action de parcours entrant spécifique. le profil doit être réalisé dans ce segment pour recevoir le de contenu (spécifique au produit)
- Jeu de données entrant de Parcours : jeu de données AEP utilisé pour stocker les mises à jour de profil effectuées lorsqu’un profil entre dans une action de parcours entrant (spécifique au produit)
- Profil Hub : banque de profils centrale dans Adobe Experience Platform utilisée comme source de vérité pour les attributs de profil et l’appartenance à un segment
- Profil Edge : copie projetée du profil Hub utilisé par le serveur de diffusion Edge Network pour évaluer l’éligibilité du contenu en temps réel
- : outil Adobe Experience Platform permettant le débogage en temps réel du comportement de SDK côté client et des réponses d’Edge Network
Mécanismes de sécurisation :
- Le jeu de données entrant par Parcours doit être activé pour l’ingestion de profil dans le sandbox actuel avant que les actions entrantes ne fonctionnent correctement
- L’espace de noms de jointure doit être défini dans les identités Platform pour le sandbox
- La propagation de l’appartenance au segment Joai du Hub vers Edge peut prendre jusqu’à 15 à 30 minutes
- L’ingestion de l’appartenance au segment Joai dans le profil Hub peut prendre jusqu’à 15 à 30 minutes après que le profil entre dans l’action entrante
- Si le contenu est toujours manquant au bout de 30 à 60 minutes, contactez l’assistance clientèle d’Adobe avec l’ID de version par parcours, l’ID d’action, Assurance trace et les vues JSON de profil Edge et Hub
Terminologie:
- Nom canonique : joai namespace — Acronyme : joai — variantes : joai identity, joai segment namespace
- Nom canonique : Actions entrantes — Acronyme : none — variantes : canaux entrants, contenu entrant
- Synonymes : « Profil Hub » = « profil central » (AEP) ; « Profil Edge » = « profil prévisionnel » (utilisé par Edge Network)
- Ne confondez pas : « Activités qualifiées » ≠ « Activités non qualifiées » dans la vue Edge Delivery — qualifiées signifie que le profil a reçu du contenu ; non qualifiées signifie que ce n’est pas le cas, avec une raison d’exclusion affichée
FAQ:
- Q : Quels sont les deux principaux scénarios d’échec d’action entrante couverts par ce guide ? — Scénario 1 : un profil est entré dans l’étape entrante mais l’utilisateur ne voit jamais le contenu. Scénario 2 : un profil a quitté le parcours, mais l’utilisateur reçoit toujours le contenu entrant.
- Q : Quel outil dois-je utiliser pour déboguer la diffusion d’action entrante ? — Adobe Experience Platform Assurance. Configurez d’abord une session Assurance, puis utilisez la messagerie In-App et les vues Edge Delivery pour inspecter la diffusion de contenu et les réponses Edge Network.
- Q : Qu’est-ce que le segment joai et pourquoi est-il important ? — Lorsqu’un profil entre dans une action entrante, il est automatiquement qualifié en un segment d’audience mixte défini pour cette action spécifique. Edge Network ne diffuse le contenu entrant que si le profil est dans un état réalisé dans ce segment de jointure.
- Q : Combien de temps faut-il pour que l’appartenance au segment joai apparaisse sur le profil Edge ? — Jusqu’à 15 à 30 minutes pour la propagation de Hub vers Edge après la mise à jour du profil Hub.
- Q : Que dois-je faire si l’identifiant de segment joai est à l’état sorti sur le profil Edge ? — Le profil a quitté le segment joai, ce qui signifie qu’il a quitté l’action de parcours entrant. Si cela est inattendu, remontez jusqu’à l’ingestion du profil Hub et vérifiez si le profil a correctement rejoint l’étape d’action entrante.
- Q : Quelles informations dois-je fournir lors de la transmission à l’assistance clientèle d’Adobe ? — ID de version du parcours, ID d’action de parcours, l’étape dans laquelle un comportement inattendu se produit, la trace Assurance complète et les vues JSON des profils Edge et Hub.