Troubleshoot your journey troubleshooting

In this section, learn how to troubleshoot journeys before testing or publishing. All the checks listed below can be performed when the journey is in test mode or when the journey is live. The recommendation is to make all the checks below in test mode and then proceed to publication. See this page.

Check for errors before testing checking-for-errors-before-testing

Before testing and publishing your journey, verify that all the activities are properly configured. You cannot perform tests or publications if errors are still detected by the system.

Errors appear with a warning symbol displayed on the activities themselves on the canvas. Place your cursor on the exclamation mark to display the error message. If you click on the activity, you should see the line in error with a warning. For example, if a mandatory field is empty, an error will be displayed.

For example, in the canvas, when two activities are disconnected, a warning is displayed.

Next to the Test toggle and the Publish button, a warning sign can be displayed. This warning sign displays errors detected by the system and prevents test mode activation or journey publication. Most of the time, errors detected by the system are linked to errors visible on the activities but sometimes they are linked to other issues. In this case, you can display them, try to identify the issue using to the error description. If you can’t identify the issue, you can copy the details and send them to the administrator or to support. Note that errors blocking the test and errors blocking the publication are similar.

The system detects two kinds of issues: errors and warnings. Errors block publication and test activation. Warnings indicate potential issues that are not blocking test activation or publication. You will see a description of the issue and an issue log ID of the type ERR_XXX_XXX. This will help technical support identify the issue.

Two different colors can be displayed on the sign next to the Test toggle and the Publish button. The sign is displayed in red in case of errors. It is displayed in orange in case of warnings.

Errors and warnings that are global to the journey appear first in the list. Error and warnings related to specific activities are listed after, by activity order or appearance in the journey from left to right. The Copy details button copies technical information about the journey which the support team can use to troubleshoot.

When an error occurs in an action or a condition, the journey of an individual stops. The only way to make it continue is to check the box Add an alternative path in case of a timeout or an error. See this section.

Check that events are properly sent checking-that-events-are-properly-sent

The starting point of a journey is always an event. You can perform tests using tools such as Postman.

You can check if the API call you send through these tools is sent correctly or not. If you get an error back, it means that your call has an issue. Check the payload again, the header (and especially the organization ID) and the destination URL. You can ask your administrator what is the right URL to hit.

Events are not pushed directly from the source to journeys. Indeed, journeys rely on Adobe Experience Platform’s streaming ingestion APIs. As a result, in case of event related issues, you can refer to Adobe Experience Platform documentation for Streaming ingestion APIs troubleshooting.

Check if people enter the journey checking-if-people-enter-the-journey

Journey reporting measures people’s entrances in a journey in real-time.

If you’re successfully sending the event but see no entrance in the journey, it means that something goes wrong between the event sending and the event reception in the journey.

You can start troubleshooting with the questions below:

Check how people navigate through the journey checking-how-people-navigate-through-the-journey

Journey reporting measures the progress of individuals inside a journey. It’s easy to identify where and why a person got stopped.

Here are a few things to check:

Check that messages are sent successfully checking-that-messages-are-sent-successfully

If individuals flow the right way in the journey but don’t receive messages they should receive, you can check if:

In case of a message sent via a custom action, the only thing that can be checked during journey test is the fact that the call of the custom action’s system leads to an error or not. If the call to the external system associated with the custom action does not lead to an error but does not lead to a message sending, some investigations should be done on the external system’s side.