Fehlerbehebung bei der Live-Journey-Ausführung troubleshooting-execution

Auf dieser Seite Erfahren Sie, wie Sie die Ausführung einer Live-Journey beheben können, indem Sie beispielsweise überprüfen, ob Ereignisse gesendet werden, Profile bestätigen, die über die Journey eintreten und weiterlaufen, und überprüfen, ob Nachrichten zugestellt werden.

In diesem Abschnitt erfahren Sie, wie Sie Fehler bei Journey-Ereignissen beheben und wie Sie prüfen, ob Profile in Ihre Journey eingetreten sind, wie sie diese durchlaufen und ob Nachrichten gesendet werden.

Sie können auch Fehler beheben, bevor Sie eine Journey testen oder veröffentlichen. Auf dieser Seite erfahren Sie mehr dazu.

Auf dieser Seite erfahren Sie, wie Sie Fehler bei eingehenden Aktionen beheben.

Überprüfen, ob Ereignisse ordnungsgemäß gesendet werden checking-that-events-are-properly-sent

Der Ausgangspunkt einer Journey ist stets ein Ereignis. Sie können mithilfe von Tools wie Postman Tests durchführen.

Sie können prüfen, ob der API-Aufruf, den Sie über diese Tools versenden, richtig gesendet wurde oder nicht. Wenn Sie einen Fehler erhalten, bedeutet das, dass es bei Ihrem Aufruf zu einem Fehler kommt. Überprüfen Sie erneut die Payload, die Kopfzeile (insbesondere die Organisations-ID) sowie die Ziel-URL. Sie können Ihren Administrator nach der richtigen URL fragen.

Ereignisse werden von der Quelle nicht direkt an Journeys weitergeleitet. Tatsächlich verlassen sich Journey auf die Streaming-Aufnahme-APIs von Adobe Experience Platform. Darum können Sie bei Problemen mit Ereignissen die Fehlerbehebung für StreamingAdobe Experience Platform Aufnahme-APIs in der ​Dokumentation“ aufrufen.

Wenn Ihre Journey den Testmodus nicht aktivieren kann und dabei der Fehler ERR_MODEL_RULES_16 ausgegeben wird, stellen Sie im Falle von Kanalaktionen sicher, dass das verwendete Ereignis einen Identity-Namespace enthält.

Der Identity-Namespace dient dazu, die Testprofile eindeutig zu identifizieren. Wenn beispielsweise die E-Mail-Adresse zur Identifizierung der Testprofile verwendet wird, sollte der Identity-Namespace E-Mail ausgewählt werden. Wenn die eindeutige Kennung die Telefonnummer ist, sollte der Identity-Namespace Telefon ausgewählt werden.

Überprüfen, ob Personen in die Journey eintreten checking-if-people-enter-the-journey

Berichte zu Journey messen den Eintritt von Personen in eine Journey auf Echtzeitbasis.

Wenn Sie das Ereignis erfolgreich versenden, aber keinen Eintritt in die Journey sehen können, bedeutet das, dass es zwischen dem Senden und Empfangen des Ereignisses in der Journey zu Problemen kommt.

Sie können die Fehlerbehebung mit den folgenden Fragen beginnen:

  • Sind Sie sicher, dass sich die Journey, bei der Sie das eingehende Ereignis erwarten, im Testmodus befindet oder live ist?

  • Haben Sie das Ereignis gespeichert, bevor Sie die Payload aus der Payload-Vorschau kopiert haben?

  • Enthält die Payload des Ereignisses eine Ereignis-ID?

  • Haben Sie die richtige URL aufgerufen?

  • Haben Sie die Payload-Struktur der Streaming-Aufnahme-APIs mithilfe der Payload-Strukturvorschau im Ereigniskonfigurationsbereich beachtet? Weitere Informationen finden Sie auf dieser Seite.

  • Haben Sie im Header Ihres Ereignisses die richtigen Schlüssel-Wert-Paare verwendet?

    code language-none
    X-gw-ims-org-id - your organization's ID
    Content-type - application/json
    
  • Ereignisbedingung und Schemadatentypen - Stellen Sie sicher, dass die in Ihrer Ereignisbedingung (Regel) verwendeten Datentypen mit dem Ereignisschema übereinstimmen. Nicht übereinstimmende Typen (z. B. Zeichenfolge vs. Ganzzahl) führen dazu, dass die Regelauswertung fehlschlägt und Ereignisse gelöscht werden. Siehe Überprüfen der ​.

  • Ereignis verworfen - Qualifizierungsbedingung nicht erfüllt - Bei regelbasierten Ereignissen wird das Ereignis empfangen, aber verworfen und das Journey wird nicht ausgelöst, wenn die Qualifizierungsbedingung von der Ereignis-Payload nicht erfüllt wird (z. B. wenn ein erforderliches Feld leer ist oder fehlt oder eine Bedingung wie "isNotEmpty eines Felds fehlschlägt„). Protokolle und Splunk-Traces können zeigen, dass das Ereignis empfangen, aber verworfen wurde, weil es die Qualifizierungsbedingung nicht erfüllte, einschließlich Verwerfen-Codes wie notSuitableInitialEvent. Dies ist das erwartete Verhalten: Wenn die Qualifizierungsbedingung nicht erfüllt ist, wird das Ereignis verworfen und das Journey wird für dieses Profil nicht ausgelöst. Überprüfen Sie, ob die Ereignis-Payload die erwarteten Felder und Werte enthält und ob die Regel in der Ereigniskonfiguration mit den gesendeten Daten übereinstimmt. Wenn das Ereignis durch eine benutzerdefinierte Aktion einer anderen Journey ausgelöst wird, finden Sie weitere Informationen unter Umgang mit Verwerfungsereignissen und Leerlauf-Timeouts in Fehlerbehebung bei benutzerdefinierten Aktionen.

​>>
Für Journeys zur Zielgruppenqualifizierung mit Streaming-Zielgruppen: Wenn Sie eine Aktivität zur Zielgruppenqualifizierung als Eintrittspunkt für die Journey verwenden, beachten Sie, dass nicht unbedingt alle für die Zielgruppe qualifizierten Profile auch in die Journey eintreten. Dies kann an Zeitfaktoren oder kurzfristigen Ausstiegen aus der Zielgruppe liegen oder daran, dass sich Profile bereits vor der Veröffentlichung in der Zielgruppe befanden. Erfahren Sie mehr zu Überlegungen zum Timing bei der Qualifizierung von Streaming-Zielgruppen.

Überprüfen der Ereignisidentität verify-event-identity-and-rule-data-types

Stellen Sie beim Konfigurieren einer ereignisbasierten Journey sicher, dass das Identitätsfeld der Payload mit dem im Ereignis ausgewählten Namespace) ​. Wenn das Ereignis Felder zum Abgleichen von Profilen enthält, überprüfen Sie ob Groß-/Kleinschreibung) und Datentyp in der Ereignisbedingung genau mit den eingehenden Daten übereinstimmen. Wenn das Ereignisschema beispielsweise roStatus als Zeichenfolge definiert, muss die Journey-Regel sie auch als Zeichenfolge auswerten. Nicht übereinstimmende Datentypen (z. B. Zeichenfolge vs. Ganzzahl) führen dazu, dass die Regelauswertung fehlschlägt und gültige Ereignisse gelöscht werden. Wenn das Ereignis eine Qualifizierungsbedingung“ aufweist z. B. ein Feld darf nicht leer sein), werden Ereignisse, die diese Bedingung nicht erfüllen, verworfen und enthalten keinen Trigger zum Journey. In Protokollen können Verwerfungscodes wie notSuitableInitialEvent angezeigt werden.

Um Ihre Ereignisbedingung in Journey Optimizer zu überprüfen, verwenden Sie die Payload-Vorschau in der Ereigniskonfiguration und stellen Sie sicher, dass die Typen und Werte in der Regel mit der Payload-Struktur übereinstimmen. Erfahren Sie​ wie Sie die Payload ​ und regelbasierte Ereignisse konfigurieren.

Fehlerbehebung bei Transitionen im Testmodus troubleshooting-test-transitions

Wenn Testprofile im Testmodus in Ihrer Journey nicht vorankommen oder der visuelle Fluss keine grünen Pfeile anzeigt, die den Fortschritt durch die Schritte angeben, kann das Problem mit der Transitionsvalidierung zusammenhängen. Dieser Abschnitt enthält Anleitungen zur Diagnose und Behebung gängiger Testmodusprobleme.

Testprofile schreiten nicht voran

Wenn Testprofile in die Journey eintreten, aber nicht über den ursprünglichen Schritt hinausgehen, überprüfen Sie Folgendes:

  • Journey-Startdatum – Die häufigste Ursache ist, dass das Startdatum der Journey in der Zukunft liegt. Testprofile werden sofort verworfen, wenn die aktuelle Zeit außerhalb des konfigurierten Journey-Fensters Start- und Enddatum/-) liegt und den folgenden Protokolleintrag erzeugt: DISPATCHER DISCARD #16 — unqualified on journey version enablements. Behebung:

    • Stellen Sie sicher, dass das Startdatum der Journey nicht in der Zukunft liegt
    • Stellen Sie sicher, dass die aktuelle Uhrzeit in das aktive Datumsfenster der Journey fällt
    • Falls erforderlich, legen Sie das Startdatum vorübergehend auf einen Zeitpunkt vor dem aktuellen Testzeitpunkt fest und stellen Sie ihn dann vor der Veröffentlichung wieder her
  • Testprofilkonfiguration - Vergewissern Sie sich, dass das Profil in Adobe Experience Platform korrekt als Testprofil gekennzeichnet ist. Weitere Informationen finden Sie unter So erstellen Sie Testprofile.

  • Nicht übereinstimmende Identitäts-Namespaces - Eine nicht übereinstimmende Namespace verursacht eine stille Ablage: Das Ereignis wird akzeptiert und gibt eine Erfolgsantwort zurück, aber das Profil gelangt nie auf die Journey und es wird kein Fehler in der Benutzeroberfläche angezeigt. Stellen Sie sicher, dass der Namespace in Profilkennung genau mit dem im Ereignisschema definierten Namespace übereinstimmt (unter Berücksichtigung von Groß-/Kleinschreibung). Weitere Informationen finden ​ unter „Ausdrucksformat ​ Profilkennung“.

Null-Transitionsindikatoren

Bei der technischen Fehlerbehebung kann eine isValidTransition-Eigenschaft auftreten, die in den technischen Details der Journey auf null gesetzt ist. Diese Eigenschaft betrifft ausschließlich die Benutzeroberfläche und hat keine Auswirkungen auf die Backend-Verarbeitung oder die Journey-Leistung. Ein Nullwert kann jedoch auf Folgendes hinweisen:

  • Fehlerhafte Journey-Konfiguration – Das Journey-Startdatum ist für die Zukunft festgelegt, sodass Testereignisse im Hintergrund verworfen werden
  • Beschädigte Transition – In seltenen Fällen müssen Journey-Knoten möglicherweise erneut verbunden werden

Wenn dauerhafte Probleme mit der Transition auftreten:

  1. Überprüfen Sie, ob das Startdatum der Journey aktuell ist
  2. Deaktivieren und reaktivieren Sie den Testmodus
  3. Wenn das Problem weiterhin besteht, duplizieren Sie die betroffenen Journey-Knoten und verbinden Sie sie erneut
  4. Bei ungelösten Fällen Support kontaktieren mit Journey-Protokollen, den betroffenen Profil-IDs und Details zur Null-Transition
NOTE
Ereignisse, die außerhalb des aktiven Datumsfensters der Journey gesendet werden, werden mit dem DISPATCHER DISCARD #16 — unqualified on journey version enablements des Protokolleintrags und ohne Benutzeroberflächenfehler im Hintergrund verworfen. Überprüfen Sie bei der Fehlerbehebung im Zusammenhang mit dem Fortschritt des Testprofils immer zuerst die Timing-Konfiguration Ihrer Journey.

Überprüfen, wie Personen durch die Journey navigieren checking-how-people-navigate-through-the-journey

Berichte zu Journey messen den Fortschritt von Kontakten innerhalb einer Journey. So können Sie leicht ermitteln, wo und warum eine Person gestoppt wurde.

Prüfen Sie folgende Punkte:

  • Ist das Problem auf eine Bedingung zurückzuführen, mit der die Person ausgeschlossen wird? Beispiel: Die Bedingung lautet „Geschlecht = männlich“, während die Person eine Frau ist. Die Prüfung kann von einem Business-Anwender vorgenommen werden, solange die Bedingung nicht zu komplex ist.
  • Ist das Problem auf einen Aufruf einer Datenquelle zurückzuführen, die nicht reagiert? Wenn sich die Journey im Test befindet, können diese Informationen in Testmodusprotokollen angezeigt werden. Wenn die Journey live ist, kann ein Administrator direkte Aufrufe an die Datenquelle testen und die erhaltene Antwort überprüfen. Alternativ kann ein Administrator die Journey duplizieren und dann testen.

Ereignisse, die aufgrund einer blockierten Journey-Instanz verworfen wurden max-instance-stack-events-reached

Wenn Ereignisse angezeigt werden, die aus maxInstanceStackEventsReached Grund verworfen wurden, hat die Journey-Laufzeit das interne Ereignisstapellimit pro Profil von 10 Ereignissen für eine bestimmte Journey-Version erreicht. Dies ist ein Schutzmechanismus, der verhindert, dass zu viele ausstehende Ereignisse gestapelt werden, während ein anderes Ereignis für dasselbe Profil noch verarbeitet wird.

Dies weder Zeitfenster noch ein Durchsatzlimit. Dies tritt auf, wenn die Journey-Instanz des Profils bei einem lang andauernden Schritt blockiert wird (z. B. bei langer Wartezeit, Anreicherung oder erneuten benutzerdefinierten Aktionsversuchen) und wenn Ereignisse für dasselbe, die auch auf dieser Journey verwendet werden, über das Limit von 10 Ereignissen hinaus angesammelt werden.

Um sie zu identifizieren, fragen Sie Journey-Schrittereignisse ab, bei denen der Verwerfungsgrund maxInstanceStackEventsReached ist (z. B. in serviceEvents.stateMachine.eventType oder ähnlichen Feldern). Weitere Informationen über verworfene Ereignistypen finden Sie in der Liste der Schrittereignisfelder.

Was können Sie tun

  • Verringern Sie lange Wartezeiten oder langsame Schritte auf Pfaden, auf denen häufig ein neuer Trigger durchgeführt werden kann.
  • Upstream-Ereignisse nach Möglichkeit deduplizieren oder entschärfen.
  • Teilen Sie Szenarien mit langer Laufzeit in mehrere Journey auf, um das Stapeln zu vermeiden.

Überprüfen, ob Nachrichten erfolgreich gesendet werden checking-that-messages-are-sent-successfully

Wenn Personen die Journey zwar richtig durchlaufen, aber nicht die vorgesehenen Nachrichten erhalten, können Sie Folgendes prüfen:

  • Journey Optimizer hat die Anfrage zum Senden der Nachricht korrekt berücksichtigt. Ein Business-Anwender kann auf die zu sendende Nachricht zugreifen und prüfen, ob der Zeitpunkt der letzten Ausführung mit der Ausführungszeit Ihrer Journey übereinstimmt. Außerdem kann er die neuesten eingegangenen API-Aufrufe/-Ereignisse prüfen.
  • Journey Optimizer hat die Nachricht erfolgreich gesendet. Überprüfen Sie die Journey-Berichte, um sicherzustellen, dass keine Fehler aufgetreten sind.

Bei einer Nachricht, die über eine benutzerdefinierte Aktion gesendet wird, kann während des Journey-Tests nur geprüft werden, ob der Systemaufruf der benutzerdefinierten Aktion zu einem Fehler führt oder nicht. Wenn der Aufruf an das externe System, das mit der benutzerdefinierten Aktion verknüpft ist, nicht zu einem Fehler führt, aber auch nicht zum Senden der Nachricht, sollten Sie das externe System überprüfen.

NOTE
Fragen Sie bei nativen Journey Optimizer-Kanalaktionen den Nachrichten-Feedback-Ereignisdatensatz ab, um den Versandstatus wie sent oder bounce zu bestätigen. Fragen Sie bei benutzerdefinierten Aktionen den Journey-Schritt-Ereignisdatensatz ab, um zu bestätigen, dass Journey Optimizer die Aktion erfolgreich ausgeführt hat. Ein erfolgreicher HTTP-Aufruf bestätigt nicht von selbst, dass das externe System eine Nachricht gesendet hat. Erfahren Sie, wie ​ für Ihren ​ den richtigen Datensatz auswählen.

Grundlegendes zu doppelten Einträgen beim Journey von Schrittereignissen duplicate-step-events

In diesem Abschnitt erfahren Sie, warum doppelte Zeilen beim Journey von Schrittereignissen angezeigt werden können.

Warum sehe ich mehrere Einträge mit derselben Journey-Instanz, demselben Profil, demselben Knoten und derselben Anfrage-ID?

Beim Abfragen von Daten zu Journey-Schrittereignissen werden Ihnen gelegentlich anscheinend doppelte Protokolleinträge für dieselbe Journey-Ausführung auffallen. Diese Einträge haben identische Werte bei:

  • profileID – der Profilidentität
  • instanceID – der Journey-Instanzkennung
  • nodeID – dem spezifischen Journey-Knoten
  • requestID – der Anfragekennung

Diese Einträge weisen jedoch unterschiedliche _id-Werte auf, was der Schlüsselindikator ist, der dieses Szenario von tatsächlicher Datenduplizierung unterscheidet.

Was verursacht dieses Verhalten?

Dies geschieht aufgrund der automatischen Backend-Skalierung (auch als „Rebalancing“ bezeichnet) in der Adobe Journey Optimizer-Microservice-Architektur. In Zeiten von hoher Auslastung oder Systemoptimierung gilt Folgendes:

  1. Ein Journey-Schrittereignis beginnt mit der Verarbeitung und wird im Datensatz für Journey-Schrittereignisse protokolliert
  2. Durch einen automatischen Skalierungsvorgang wird die Workload auf verschiedene Dienstinstanzen verteilt
  3. Dasselbe Ereignis kann von einer anderen Dienstinstanz erneut verarbeitet werden, wodurch ein zweiter Protokolleintrag mit einer anderen _id erstellt wird

Dies ist ein erwartetes Systemverhalten und funktioniert wie vorgesehen.

Hat dies Auswirkungen auf die Ausführung von Journeys oder den Nachrichtenversand?

Nr. Die Auswirkungen sind auf die Protokollierung beschränkt. Adobe Journey Optimizer verfügt über integrierte Deduplizierungsmechanismen auf der Nachrichtenausführungsebene, die Folgendes sicherstellen:

  • Nur eine Nachricht (E-Mail, SMS, Push-Benachrichtigung usw.) wird an jedes Profil gesendet
  • Aktionen werden nur einmal ausgeführt
  • Journey-Ausführung läuft korrekt ab

Sie können dies prüfen, indem Sie den ajo_message_feedback_event_dataset abfragen oder die Aktionsausführungsprotokolle konsultieren. Sie werden sehen, dass trotz der doppelten Journey-Schrittereigniseinträge tatsächlich nur eine Nachricht gesendet wurde.

Wie kann ich diese Fälle in meinen Abfragen erkennen?

Gehen Sie beim Analysieren von Daten zu Journey-Schrittereignissen wie folgt vor:

  1. Prüfen Sie das _id-Feld: Echte Duplikate auf Systemebene würden denselben Wert für _id aufweisen. Unterschiedliche Werte für _id weisen auf separate Protokolleinträge aus dem oben beschriebenen Rebalancing-Szenario hin.

  2. Prüfen Sie den Nachrichtenversand: Sehen Sie sich auch die Daten zum Nachrichten-Feedback an, um sich zu vergewissern, dass nur eine Nachricht gesendet wurde:

    code language-sql
    SELECT
      timestamp,
      _experience.customerJourneyManagement.messageExecution.messageExecutionID,
      _experience.customerJourneyManagement.messageDeliveryfeedback.feedbackStatus
    FROM ajo_message_feedback_event_dataset
    WHERE
      _experience.customerJourneyManagement.messageExecution.journeyVersionID = '<journeyVersionID>'
      AND TO_JSON(identityMap) like '%<profileID>%'
    ORDER BY timestamp DESC;
    
  3. Gruppieren Sie nach eindeutigen Kennungen: Verwenden Sie beim Zählen von Ausführungen _id, um genaue Zahlen zu erhalten:

    code language-sql
    SELECT
      COUNT(DISTINCT _id) as unique_executions
    FROM journey_step_events
    WHERE
      _experience.journeyOrchestration.stepEvents.journeyVersionID = '<journeyVersionID>'
      AND _experience.journeyOrchestration.stepEvents.profileID = '<profileID>'
    

Was sollte ich tun, wenn ich dies feststelle?

Dies ist ein normales Systemverhalten. Es ist keine Aktion erforderlich. Die Duplikatprotokollierung weist nicht auf ein Problem mit Ihrer Journey-Konfiguration oder dem Nachrichtenversand hin.

Wenn Sie Berichte oder Analysen auf der Grundlage von Journey-Schrittereignissen erstellen:

  • Verwenden Sie _id als Primärschlüssel für die Zählung eindeutiger Ereignisse
  • Sehen Sie sich bei der Analyse des Nachrichtenversands auch Datensätze mit Nachrichten-Feedback an
  • Beachten Sie, dass die Zeitplanungsanalyse Einträge innerhalb weniger Sekunden gruppiert anzeigen kann

Weitere Informationen zum Abfragen von Journey-Schrittereignissen finden Sie unter Beispiele für Abfragen.

Fehlerbehebung bei Diskrepanzen der Dashboard-Metriken dashboard-metrics

Wenn die im Dashboard Übersicht angezeigten Metriken nicht mit der tatsächlichen Anzahl der Journeys auf der Registerkarte Durchsuchen übereinstimmen, überprüfen Sie Folgendes:

  • Stellen Sie sicher, dass in den betreffenden Journeys in den letzten 24 Stunden Traffic aufgetreten ist, da Journeys ohne aktuelle Aktivität nicht im Dashboard angezeigt werden.
  • Vergewissern Sie sich, dass Sie über die entsprechenden Zugriffsberechtigungen verfügen, um alle Journeys in Ihrem Unternehmen anzuzeigen.
  • Nach Änderungen an Ihren Journeys kann es bis zu 30 Minuten dauern, bis die Metriken aktualisiert werden.

Wenn Diskrepanzen bestehen bleiben, ​ Sie sich an den Adobe-Support und sehen Sie sich die Screenshots der Registerkarten Übersicht und Durchsuchen an, um eine Untersuchung durchzuführen.

Tracking-Parameter mit leeren Platzhaltern in geschlossenen Journey tracking-parameters-closed-journeys

Wenn Tracking-URLs in gesendeten E-Mails leere Platzhalter wie cid=em-acou-adob{} enthalten, kann dies darauf hinweisen, dass ein Kontextfeld wie context.system.source.actionId nicht aufgelöst werden konnte. Dies geschieht in der Regel, wenn eine Journey geschlossen wurde und nach einer entsprechenden Produktänderung nicht erneut veröffentlicht wurde - nur erneut veröffentlichte Journey füllen diese Kontextfelder in Tracking-URLs korrekt aus.

Um dies zu beheben, veröffentlichen Sie entweder die Journey erneut (erstellen Sie eine neue Version und veröffentlichen Sie sie) oder entfernen Sie den Verweis auf das betroffene Kontextfeld aus den URL-Tracking-Parametern in der Kanalkonfiguration oder im E-Mail-Inhalt.

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 is a comprehensive troubleshooting reference for live journey execution in Adobe Journey Optimizer, covering event delivery, profile entry failures, test mode transition issues, discarded events, duplicate step event logs, message delivery checks, and dashboard metric discrepancies.

Intents:

  • Diagnose why events are not triggering journey entry by checking payload structure, headers, and qualification conditions
  • Verify whether profiles are entering and progressing through a live or test-mode journey
  • Resolve test mode transition failures caused by future start dates or misconfigured identity namespaces
  • Understand and handle the maxInstanceStackEventsReached discard reason for blocked journey instances
  • Identify and correctly query duplicate Journey Step Event log entries caused by backend auto-scaling
  • Investigate missing messages by checking journey reporting and custom action call results
  • Fix empty tracking URL placeholders in emails from closed journeys

Glossary:

  • Journey Step Events: A dataset that logs each step a profile executes within a journey, used for reporting and debugging (product-specific)
  • notSuitableInitialEvent: A discard code indicating an event was received but dropped because the qualification condition was not met (product-specific)
  • maxInstanceStackEventsReached: A discard code indicating the per-profile journey instance event stack limit of 10 has been exceeded (product-specific)
  • isValidTransition: A UI-only property in journey technical details; a null value may indicate a future start date or corrupted node connection, but does not affect backend processing (product-specific)
  • Qualification condition: A rule defined on an event that must be satisfied for the event to trigger a journey; events failing this condition are discarded
  • Rebalancing: A backend auto-scaling operation in AJO microservices that can create duplicate Journey Step Event log entries with different _id values

Guardrails:

  • Events sent outside the journey’s active date/time window are silently discarded with no error message
  • The per-profile journey instance event stack limit is 10 events; exceeding this causes events to be discarded with maxInstanceStackEventsReached
  • Duplicate Journey Step Event entries with different _id values are expected system behavior and do not indicate message duplication
  • Dashboard Overview metrics only include journeys with traffic in the last 24 hours; metrics may take up to 30 minutes to refresh
  • Closed journeys that have not been republished after a product change may produce empty placeholders in tracking URLs

Terminology:

  • Canonical name: Journey Step Events — Acronym: none — variants: step events, journey execution logs
  • Canonical name: Qualification condition — Acronym: none — variants: event qualification rule, event condition
  • Synonyms: “rebalancing” = “auto-scaling” (backend operation causing duplicate log entries)
  • Do not confuse: “duplicate _id” ≠ “duplicate log entries from rebalancing” — true duplicates share the same _id; rebalancing duplicates have different _id values

FAQ:

  • Q: Why are my events not triggering a journey even though they are being sent successfully? — Check that the journey is live or in test mode, the payload matches the event schema structure, the qualification condition is satisfied, and the correct headers (X-gw-ims-org-id, Content-type) are included.
  • Q: Why do test profiles enter the journey but not advance past the first step? — The most common cause is a journey start date set in the future; events are silently discarded outside the active date window. Also verify the test profile flag and identity namespace match.
  • Q: What does maxInstanceStackEventsReached mean? — The journey runtime has hit the internal 10-event stack limit for a specific profile instance, typically because a long-running step is blocking processing. Reduce long waits, deduplicate upstream events, or split the scenario into multiple journeys.
  • Q: I see duplicate rows in Journey Step Events — is something wrong? — No. Duplicate entries with different _id values are expected and result from backend auto-scaling. Only one message is actually sent; verify with the ajo_message_feedback_event_dataset.
  • Q: Why do tracking URLs in emails show empty placeholders like cid=em-acou-adob{}? — The journey was closed and not republished after a product change; context fields cannot be resolved. Republish the journey or remove the affected context field reference from the URL tracking parameters.
  • Q: Why does the Overview dashboard show different numbers than the Browse tab? — The dashboard only counts journeys with traffic in the last 24 hours, metrics take up to 30 minutes to refresh, and access permissions may limit visibility.
recommendation-more-help
journey-optimizer-help