DocumentazioneJourney OptimizerGuida di Journey Optimizer

Risoluzione dei problemi relativi alle azioni in entrata nei percorsi troubleshooting-inbound-actions

Ultimo aggiornamento: 28 aprile 2026
  • Si applica a:
  • Journey Orchestration

Creato per:

  • Intermediate
  • User

Inbound actions, such as In-app, web, and code-based experiences, are critical components of Journey Optimizer as they enable personalized engagement with users during their journey. However, unexpected behavior, such as missing inbound content, or continued delivery after a profile exits the journey, can occur.

This guide provides a step-by-step process to debug issues related to inbound actions in a journey, in order to help you identify and resolve them independently before reaching out to support.

Prerequisiti prerequisites

Before you can start troubleshooting, ensure the following:

  1. Set up an Assurance session. Learn how in the Adobe Experience Platform Assurance documentation.

  2. Navigate to the journey containing the inbound action to retrieve the journey name and version ID.

    note
    NOTE
    The journey version ID can be found in the URL after 'journey/' (for example: 86232fb1-2932-4036-8198-55dfec606fd7).

    Journey ID location in journey URL or properties panel

  3. Click the inbound action to view its details. Retrieve the inbound action label and ID.

    Action ID in activity configuration panel code view

  4. Get the profile namespace and ID to identify the profile encountering issues. Based on your configuration, the namespace can be ECID, email, or customer ID for example. Learn how to look up a profile in the Experience Platform documentation.

Scenario 1: The user hasn’t received the inbound content scenario-1

In this scenario, a profile has entered the inbound action in the journey, but even after 30 minutes, the corresponding inbound content is not showing up in the device/client at the setup trigger step.

Pre-checks pre-checks

  1. Journey Inbound dataset is enabled for profile ingestion

    The inbound action uses the Journey Inbound dataset for the profile updates during execution. Ensure that the dataset is enabled for Profiles in the current sandbox. Ulteriori informazioni sui set di dati

  2. ‘joai’ identity defined in platform identities

    The inbound action uses the joai namespace in the profile segmentMembership for activating the profile for the inbound step. Ensure it has been defined in Platform Identities for the sandbox. Learn more on Experience Platform Identity Service

Debugging Steps debugging-steps

The chart below shows the sequence of debugging steps you can follow:

Troubleshooting workflow for inbound message not displaying: check journey, edge delivery, and profile {align="center" width="70%"}

Step 1: check if the device/client is receiving the content from the edge network step-1

Start by checking if the device/client is getting the expected content.

Canale in-app

  1. Go to the Assurance session and select the In-App Messaging section from the left panel.

  2. In the Messages on Device tab, click the Messages drop-down list.

    Adobe Assurance view showing in-app message delivery events and data {width="80%"}

  3. Look for a message with the journey name followed by ‘- In-app message’. If present, it means the In-app message is present on the device/client and the issue might be related to the In-app trigger.

  4. If the message is not found, the In-app message was not received by the device/client.

Canale web
Visit the page and inspect the networking tab, or check the Edge response payload in the Edge Delivery section of the Assurance session.
Code-based experience channel
Perform a curl request using Adobe’s API and check the Edge response payload in the Edge Delivery section of the Assurance session.

Step 2: check if the edge network is returning the content step-2

This step is to make sure the Edge Network is returning the expected inbound content to be rendered on the device/client.

When a profile enters an inbound action in a journey, it is automatically qualified into a special audience segment (in the joai namespace) corresponding to the inbound journey action.

When a client makes a request to the Edge Network for a given profile and surface, the profile qualifies to receive content for the inbound journey actions targeting that surface - only if the profile is currently a member of the corresponding joai segment.

To debug the Edge Network behavior, follow the steps below.

  1. Open the Edge Delivery view in the Assurance session. This view provides information about the execution of the inbound action on the Edge Network server. Per ulteriori informazioni, consulta la documentazione di Experience Platform.

  2. Verify if the Edge activity corresponding to the inbound action is listed in the Qualified Activities or Unqualified Activities sections.

    Edge delivery logs showing message propositions sent to profile

    • If in the Qualified Activities section, the profile qualified for the inbound journey action, and the content should be returned.
    • If in the Unqualified Activities section, the profile did not qualify for the inbound journey action. See the exclusion reasons for more details.
    • If in neither section, either there was a problem with publishing the inbound journey action to the Edge Network, or the requested surface URI did not match the channel configuration settings for the inbound action.
    note
    NOTE
    To find your Edge activity in the Assurance session, look for the activity where the audienceNamespace is joai and the audienceSegmentId is <JourneyVersionID>_<JourneyActionID> (for example: 86232fb1-2932-4036-8198-55dfec606fd7_708f718d-8503-4427-ad8d-8e28979b554c).

    Edge delivery error showing profile did not qualify for message {width="70%"}

  3. If your activity is in the Unqualified Activities section and the exclusion reason is ‘Segment is not active’, it means the Edge Network delivery server does not think the profile is part of the relevant joai audience segment.

    You can double check whether the joai segment is present in the Edge Network delivery server’s view of the profile by opening the segmentsMap element of the Profile section and looking for the presence of the joai segment ID.

  4. If the Edge Network delivery server does not view the profile as being in the relevant joai segment, go to the next step.

Step 3: check if the ‘joai’ audience membership has propagated to the edge network step-3

This step is to verify that the Edge profile was correctly updated when the profile entered the inbound journey action and the profile was qualified into the corresponding joai segment.

When a profile is qualified into a joai segment, the profile is first updated on the Hub and then the segment membership is projected to the Edge Profile for use by the Edge Network delivery server.

NOTE
The propagation from Hub to Edge can take up to 15-30 minutes from the moment the profile is updated on the Hub.

To check for the presence of the joai segment in the Edge profile’s segmentMembership attribute, follow the steps below.

  1. Navigate to the Customer > Profiles menu in the Journey Optimizer left navigation pane and browse to the profile using namespace and ID. Learn more on Real-time Customer Profiles

  2. Selezionare la scheda Attributi e scegliere la visualizzazione Edge.

  3. Fare clic su Visualizza JSON per aprire la visualizzazione JSON per il profilo.

    Visualizzazione attributi profilo in formato JSON che mostra lo stato di appartenenza al pubblico {width="80%"}

  4. Vai all’attributo segmentMembership e controlla se l’ID segmento <JourneyVersionID>_<JourneyActionID> è presente nello spazio dei nomi joai e se in realized status.

    JSON profilo che mostra l'iscrizione al pubblico realizzata con timestamp {width="90%"}

    • Se presente, il segmento joai corrispondente all’azione del percorso in entrata è stato propagato correttamente al profilo Edge.

    • Se non viene visualizzata nella vista del profilo del server di consegna Edge Network, potrebbe essersi verificato un problema con il modo in cui il server di consegna carica il profilo Edge.

  5. Se l’ID segmento joai non è presente o è nello stato exited, significa che non è stato (ancora) propagato ad Edge.

    Attendere 15-30 minuti per la propagazione dei valori segmentMembership dall’hub ad Edge. Se non è ancora presente, andare al passaggio successivo.

Passaggio 4: verifica se l’iscrizione al pubblico “joai” è presente nel profilo nell’hub step-4

Questo passaggio consente di verificare che il profilo Hub sia stato aggiornato correttamente quando il profilo è entrato nell’azione del percorso in entrata e che sia stato qualificato nel segmento joai corrispondente.

NOTE
L'acquisizione dell'appartenenza al segmento joai nel profilo Hub può richiedere fino a 15-30 minuti dal momento in cui il profilo è entrato nell'azione di percorso in entrata.

Per verificare la presenza del segmento joai nell’attributo segmentMembership del profilo Hub, eseguire la procedura seguente.

  1. Passa al menu Cliente > Profili nel riquadro di navigazione sinistro di Journey Optimizer e individua il profilo utilizzando lo spazio dei nomi e l’ID. Ulteriori informazioni su Profili cliente in tempo reale

  2. Seleziona la scheda Attributi e scegli la visualizzazione Hub.

  3. Fare clic su Visualizza JSON per aprire la visualizzazione JSON per il profilo.

  4. Vai all’attributo segmentMembership e controlla se l’ID segmento <JourneyVersionID>_<JourneyActionID> è presente nello spazio dei nomi joai e se in realized status.

    • Se presente, il segmento joai corrispondente all’azione del percorso in entrata è stato correttamente acquisito nel profilo Hub.

    • Se non viene trovato nel profilo di Edge dopo almeno 30 minuti, potrebbe essersi verificato un problema con il sistema di proiezione di Edge.

  5. Se l’ID del segmento joai non è presente o è nello stato exited, significa che il profilo non è stato (ancora) qualificato correttamente nel segmento di pubblico joai speciale al momento dell’immissione nell’azione del percorso in entrata corrispondente.

    Attendere 15-30 minuti per l’acquisizione dei valori segmentMembership nel profilo sull’hub. Se non è ancora presente, andare al passaggio successivo.

Passaggio 5: se il client/dispositivo non riceve ancora il contenuto previsto step-5

Se hai eseguito tutti i passaggi precedenti e non vedi il comportamento previsto dopo 30-60 minuti di attesa che l’iscrizione al segmento si propaghi ad Edge Network, contatta l’Assistenza clienti di Adobe o il tuo rappresentante Adobe.

Includi tutti i dettagli possibili dai passaggi di debug, ad esempio:

  • il passaggio in cui si verifica il comportamento imprevisto;
  • l’ID versione del percorso;
  • l’ID dell’azione del percorso;
  • la traccia completa di Assurance;
  • la vista JSON del profilo Edge;
  • la vista JSON del profilo dell’hub;
  • ecc.

Scenario 2: l’utente sta ancora ricevendo il contenuto in entrata scenario-2

Questo scenario è inverso a Scenario 1: il profilo è uscito dal percorso, ma l’utente sta ancora ricevendo il contenuto in entrata.

Tuttavia, quando un profilo esce da un percorso, non dovrebbe più essere idoneo per i segmenti di pubblico joai corrispondenti alle azioni in entrata nel percorso.

Segui gli stessi passaggi di debug dello Scenario 1 per verificare se il profilo Hub, il profilo Edge e il server di consegna Edge Network riflettono correttamente lo stato di appartenenza al segmento del segmento joai pertinente e se il client non riceve più il contenuto in entrata.

recommendation-more-help
journey-optimizer-help