Résolution des problèmes liés aux actions entrantes dans les parcours troubleshooting-inbound-actions

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 :

  1. Configurez une session Assurance. Découvrez comment procéder dans la documentation d’Adobe Experience Platform Assurance.

  2. Accédez au parcours contenant l’action entrante pour récupérer le nom du parcours et l’ID de version.

    note note
    NOTE
    L’ID de version du parcours se trouve dans l’URL après « journey/ » (par exemple, 86232fb1-2932-4036-8198-55dfec606fd7).

  3. Cliquez sur l’action entrante pour en afficher les détails. Récupérez le libellé et l’identifiant de l’action entrante.

  4. 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

  1. 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

  2. Identité joai définie dans les identités de la plateforme

    L’action entrante utilise l’espace de noms joai dans le segmentMembership de 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 :

{align="center" width="70%"}

Étape 1 : vérifier si l’appareil/le client reçoit le contenu d’Edge Network step-1

Commencez par vérifier si l’appareil ou le client obtient le contenu attendu.

Canal in-app
  1. Accédez à la session Assurance et sélectionnez la section Messagerie In-App dans le panneau de gauche.

  2. Dans l’onglet Messages sur l’appareil, cliquez sur la liste déroulante Messages.

    {width="80%"}

  3. 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.

  4. Si le message est introuvable, le message in-app n’a pas été reçu par l’appareil/le client.

Canal web
Rendez-vous sur la page et examinez l’onglet Mise en réseau, ou vérifiez la payload de réponse Edge dans la section Edge Delivery de la session Assurance.
Canal d’expérience basée sur du code
Exécutez une requête curl à l’aide de l’API d’Adobe et vérifiez la payload de réponse Edge dans la section Edge Delivery de la session Assurance.

Étape 2 : vérifier si Edge Network 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.

  1. 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.

  2. 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
    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).

    {width="70%"}

  3. 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.

  4. 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.

NOTE
La propagation du Hub vers Edge peut prendre de 15 à 30 minutes à partir du moment où le profil est mis à jour sur le Hub.

Pour vérifier la présence du segment joai dans l’attribut segmentMembership du profil Edge, procédez comme suit.

  1. 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

  2. Sélectionnez l’onglet Attributs et choisissez la vue Edge.

  3. Cliquez sur Vue JSON pour ouvrir la vue JSON du profil.

    {width="80%"}

  4. Accédez à l’attribut segmentMembership et 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é .

    {width="90%"}

    • 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.

  5. 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 segmentMembership soient propagées du Hub vers Edge. S’il n’est toujours pas présent, passez à l’étape suivante.

Étape 4 : vérifier 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.

NOTE
L’ingestion de l’appartenance au segment joai dans le profil Hub peut prendre de 15 à 30 minutes à partir du moment où le profil a rejoint l’action de parcours entrante.

Pour vérifier la présence du segment joai dans l’attribut segmentMembership du profil Hub, procédez comme suit.

  1. 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

  2. Sélectionnez l’onglet Attributs et choisissez la vue Hub.

  3. Cliquez sur Vue JSON pour ouvrir la vue JSON du profil.

  4. 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.

  5. 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 segmentMembership soient 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.

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