DocumentazioneJourney OptimizerGuida di Journey Optimizer

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

Last update: Thu Sep 04 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Si applica a:
  • Journey Orchestration

Creato per:

  • Intermedio
  • Utente

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 documentazione di Adobe Experience Platform Assurance.

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

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

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

  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 del debug debugging-steps

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

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

    {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 effettua 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 è attualmente membro del segmento joai corrispondente.

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.

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

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

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

    {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 sull’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.

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