DocumentazioneJourney OptimizerGuida di Journey Optimizer

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

Ultimo aggiornamento: 19 ottobre 2026
  • Si applica a:
  • Journey Orchestration

Creato per:

  • Intermedio
  • Utente

In questa pagina: scopri come eseguire il debug e risolvere i problemi comuni relativi alle azioni in entrata, ad esempio esperienze in-app, web e basate su codice, in un percorso prima di contattare il supporto tecnico.

style
shade-box

Le azioni in entrata, ad esempio le esperienze in-app, web e basate su codice, sono componenti critici di Journey Optimizer in quanto consentono un coinvolgimento personalizzato con gli utenti durante il percorso. Tuttavia, possono verificarsi comportamenti imprevisti, ad esempio contenuto in entrata mancante o consegna continua dopo che un profilo esce dal percorso.

Questa guida fornisce una procedura dettagliata per eseguire il debug dei problemi relativi alle azioni in entrata in un percorso, per aiutarti a identificarli e risolverli in modo indipendente prima di contattare il supporto tecnico.

Prerequisiti prerequisites

Prima di iniziare la risoluzione dei problemi, verificare quanto segue:

  1. Configura una sessione Assurance. Scopri come fare nella Adobe Experience Platform documentazione di Assurance.

  2. Passa al percorso contenente l’azione in entrata per recuperare il nome del percorso e l’ID della versione.

    note
    NOTE
    L'ID versione percorso si trova nell'URL dopo 'percorso/' (ad esempio: 86232fb1-2932-4036-8198-55dfec606fd7).

    Posizione ID Percorso nell'URL percorso o nel pannello delle proprietà

  3. Fai clic sull’azione in entrata per visualizzarne i dettagli. Recupera l’etichetta e l’ID dell’azione in entrata.

    ID azione nella visualizzazione codice del pannello di configurazione attività

  4. Ottieni lo spazio dei nomi e l’ID del profilo per identificare il profilo che incontra problemi. In base alla configurazione, ad esempio, lo spazio dei nomi può essere ECID, e-mail o ID cliente. Scopri come cercare un profilo nella documentazione di Experience Platform.

Scenario 1: l’utente non ha ricevuto il contenuto in entrata scenario-1

In questo scenario, un profilo ha inserito l’azione in entrata nel percorso, ma anche dopo 30 minuti, il contenuto in entrata corrispondente non viene visualizzato nel dispositivo/client al passaggio dell’attivazione della configurazione.

Controlli preliminari pre-checks

  1. Il set di dati in entrata del Percorso è abilitato per l’acquisizione del profilo

    L’azione in entrata utilizza il set di dati Percorso in entrata per gli aggiornamenti del profilo durante l’esecuzione. Assicurati che il set di dati sia abilitato per i profili nella sandbox corrente. Ulteriori informazioni sui set di dati

  2. Identità ‘joai’ definita nelle identità della piattaforma

    L’azione in entrata utilizza lo spazio dei nomi joai nel profilo segmentMembership per attivare il profilo per il passaggio in entrata. Assicurati che sia stato definito in Platform Identities per la sandbox. Ulteriori informazioni su Servizio Experience Platform Identity

Passaggi di debug debugging-steps

Il grafico seguente mostra la sequenza dei passaggi di debug che puoi seguire:

Impossibile visualizzare il flusso di lavoro per la risoluzione dei problemi relativi al messaggio in entrata: verifica percorso, consegna Edge e profilo {align="center" width="70%"}

Passaggio 1: verifica se il dispositivo/client riceve il contenuto da Edge Network step-1

Per prima cosa, controlla se il dispositivo/client riceve il contenuto previsto.

Canale in-app

  1. Vai alla sessione Assurance e seleziona la sezione Messaggistica in-app dal pannello a sinistra.

  2. Nella scheda Messaggi sul dispositivo, fare clic sull’elenco a discesa Messaggi.

    Visualizzazione Assurance di Adobe con eventi e dati di consegna dei messaggi in-app {width="80%"}

  3. Cerca un messaggio con il nome del percorso seguito da “- Messaggio in-app”. Se presente, significa che il messaggio in-app è presente sul dispositivo/client e il problema potrebbe essere correlato al trigger in-app.

  4. Se il messaggio non viene trovato, significa che il dispositivo o il client non ha ricevuto il messaggio in-app.

Canale web
Visita la pagina e controlla la scheda di rete oppure controlla il payload di risposta di Edge nella sezione Edge Delivery della sessione Assurance.
Canale esperienza basato su codice
Esegui una richiesta curl utilizzando API di Adobe e controlla il payload di risposta di Edge nella sezione Edge Delivery della sessione Assurance.

Passaggio 2: verifica se Edge Network restituisce il contenuto step-2

Questo passaggio consente di assicurarsi che Edge Network restituisca il contenuto in entrata previsto da riprodurre sul dispositivo/client.

Quando un profilo entra in un’azione in entrata in un percorso, viene automaticamente qualificato in un segmento di pubblico speciale (nello spazio dei nomi joai) corrispondente all’azione del percorso in entrata.

Quando un client invia una richiesta all’Edge Network per un profilo e una superficie specifici, il profilo è idoneo a ricevere il contenuto per le azioni del percorso in entrata che hanno come destinazione tale superficie, solo se il profilo è membro del segmento joai corrispondente al momento della richiesta.

Per eseguire il debug del comportamento di Edge Network, segui i passaggi seguenti.

  1. Apri la visualizzazione Edge Delivery nella sessione di Assurance. Questa vista fornisce informazioni sull’esecuzione dell’azione in entrata sul server Edge Network. Per ulteriori informazioni, consulta la documentazione di Experience Platform.

  2. Verifica se l’attività Edge corrispondente all’azione in entrata è elencata nelle sezioni Attività qualificate o Attività non qualificate.

    Registri di consegna di Edge con proposte di messaggi inviate al profilo

    • Se nella sezione Attività qualificate, il profilo è qualificato per l’azione di percorso in entrata e il contenuto deve essere restituito.
    • Se nella sezione Attività non qualificate il profilo non è idoneo per l’azione di percorso in entrata. Per ulteriori dettagli, consulta i motivi di esclusione.
    • Se in nessuna sezione si è verificato un problema con la pubblicazione dell’azione di percorso in entrata in Edge Network oppure l’URI della superficie richiesta non corrisponde alle impostazioni di configurazione del canale per l’azione in entrata.
    note
    NOTE
    Per trovare l'attività Edge nella sessione Assurance, cerca l'attività in cui audienceNamespace è joai e audienceSegmentId è <JourneyVersionID>_<JourneyActionID> (ad esempio: 86232fb1-2932-4036-8198-55dfec606fd7_708f718d-8503-4427-ad8d-8e28979b554c).

    Errore di consegna Edge durante la visualizzazione del profilo non idoneo per il messaggio {width="70%"}

  3. Se l’attività si trova nella sezione Attività non qualificate e il motivo dell’esclusione è ‘Il segmento non è attivo’, significa che il server di consegna Edge Network non ritiene che il profilo faccia parte del segmento di pubblico joai rilevante.

    Puoi verificare se il segmento joai è presente nella vista del profilo del server di consegna Edge Network aprendo l’elemento segmentsMap della sezione Profile e cercando la presenza dell’ID del segmento joai.

  4. Se il server di consegna Edge Network non visualizza il profilo come nel segmento joai pertinente, passa al passaggio successivo.

Passaggio 3: verifica se l’iscrizione al pubblico “joai” è stata propagata ad Edge Network step-3

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

Quando un profilo viene qualificato per un segmento joai, viene prima aggiornato nell’hub e quindi l’appartenenza al segmento viene proiettata nel profilo Edge per l’utilizzo da parte del server di consegna Edge Network.

NOTE
La propagazione dall’hub ad Edge può richiedere fino a 15-30 minuti dal momento in cui il profilo viene aggiornato sull’hub.

Per verificare la presenza del segmento joai nell’attributo segmentMembership del profilo di Edge, 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. 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 è nello stato realized .

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

AI Knowledge Reference

This section contains structured knowledge intended to support interpretation, retrieval, and question answering related to this topic.

For complete understanding, this information should be combined with the documentation on this page. Neither source is intended to stand alone; the page describes the feature, while this section provides additional context that helps disambiguate terminology, intent, applicability, and constraints.

  • TL;DR: This page provides a step-by-step process to debug issues related to inbound actions in a journey, covering two scenarios: a profile entering an inbound action but the user not receiving the content, and a user still receiving the content after the profile exits the journey.

Intents:

  • Set up an Assurance session and gather the journey, action, and profile details before debugging inbound action issues
  • Verify whether the device or client is receiving inbound content for the In-app, Web, and Code-based experience channels
  • Check whether the Edge Network returns the content by reading the Qualified Activities and Unqualified Activities sections of the Edge Delivery view in Assurance
  • Confirm that the joai audience segment membership is present in the Edge profile and the Hub profile
  • Debug a user who still receives inbound content after the profile exits the journey
  • Escalate to Adobe Customer Care or an Adobe representative with the right diagnostic information when the steps do not resolve the issue

Glossary:

  • Inbound actions: Journey actions such as In-app, web, and code-based experiences that enable personalized engagement with users (product-specific)
  • joai namespace: The namespace used in the profile segmentMembership for activating the profile for the inbound step; it must be defined in Platform Identities for the sandbox (product-specific)
  • joai segment: A special audience segment in the joai namespace into which a profile is automatically qualified when it enters an inbound action; its segment ID is <JourneyVersionID>_<JourneyActionID> (product-specific)
  • Journey Inbound dataset: The dataset the inbound action uses for the profile updates during execution (product-specific)
  • Hub profile: The profile that is first updated when a profile is qualified into a joai segment; the segment membership is then projected to the Edge profile
  • Edge profile: The profile to which the segment membership is projected from the Hub, for use by the Edge Network delivery server
  • Assurance: The Adobe Experience Platform tool whose session is used on this page to check the messages on the device and the Edge response payload

Guardrails:

  • The Journey Inbound dataset must be enabled for Profiles in the current sandbox (pre-check)
  • The joai namespace must be defined in Platform Identities for the sandbox (pre-check)
  • A client request qualifies a profile for inbound content on a surface only if the profile is a member of the corresponding joai segment at the time of the request
  • Propagation of the joai segment membership from the Hub to the Edge can take up to 15-30 minutes from the moment the profile is updated on the Hub
  • Ingestion of the joai segment membership into the Hub profile can take up to 15-30 minutes from the moment the profile entered the inbound journey action
  • If the expected behavior is still not seen after waiting 30 to 60 minutes for the segment membership to propagate to the Edge Network, contact Adobe Customer Care or your Adobe representative

Prerequisites and permissions:

  • An Assurance session set up
  • The journey name and journey version ID, retrieved from the journey containing the inbound action
  • The inbound action label and ID
  • The profile namespace and ID of the profile encountering issues

Terminology:

  • Canonical name: joai namespace — variants: joai identity
  • Canonical name: Inbound actions — variants: inbound journey action
  • Synonyms: “joai segment” = “joai audience segment”
  • Do not confuse: “Qualified Activities” ≠ “Unqualified Activities” in the Edge Delivery view — in Qualified Activities the profile qualified for the inbound journey action and the content should be returned; in Unqualified Activities the profile did not qualify, and the exclusion reasons give more details

FAQ:

  • Q: What are the two scenarios covered by this guide? — Scenario 1: a profile has entered the inbound action but, even after 30 minutes, the inbound content is not showing up in the device/client at the setup trigger step. Scenario 2: the profile has exited the journey, but the user is still receiving the inbound content.
  • Q: What tool do I use to debug inbound action delivery? — Assurance. Set up an Assurance session first, then use the In-App Messaging section for the In-app channel and the Edge Delivery section for the Edge response payload.
  • Q: What is the joai segment and why does it matter? — When a profile enters an inbound action, it is automatically qualified into a special audience segment (in the joai namespace) corresponding to the inbound journey action. The profile qualifies to receive content for the inbound journey actions targeting a surface only if it is a member of the corresponding joai segment at the time of the request.
  • Q: How do I find my Edge activity in Assurance? — Look for the activity where the audienceNamespace is joai and the audienceSegmentId is <JourneyVersionID>_<JourneyActionID>.
  • Q: How long does it take for the joai segment membership to appear on the Edge profile? — Up to 15-30 minutes from the moment the profile is updated on the Hub.
  • Q: What does it mean if the joai segment ID is not present or is in exited state on the Edge profile? — It was not (yet) propagated to the Edge. Wait 15 to 30 minutes for the segmentMembership values to be propagated from the Hub to the Edge; if the segment ID is still not present, check the Hub profile.
  • Q: What does it mean if the joai segment ID is not present or is in exited state on the Hub profile? — The profile was not (yet) correctly qualified into the joai segment upon entry into the inbound journey action. Wait 15 to 30 minutes for the values to be ingested into the Hub profile; if still not present, go to the next step, which is to contact Adobe Customer Care or your Adobe representative.
  • Q: What information should I provide when escalating? — The step where you see the unexpected behavior, the journey version ID, the journey action ID, the full Assurance trace, and the JSON views of the Edge profile and the Hub profile.

Related pages:

  • Troubleshooting errors before testing or publishing a journey: Troubleshoot errors before testing or publishing your journey (building-journeys/troubleshooting.md)
  • Troubleshooting a live journey execution: Troubleshoot your live journey execution (building-journeys/troubleshooting-execution.md)
  • Journey error codes: Error codes reference (building-journeys/error-codes-reference.md)
recommendation-more-help
journey-optimizer-help