Journeys

Journeys is an incredible tool on ByteBrew used to visualize every paths your players take in your games to reach your vital events.

reviewsPopular Use Case Journeys is used to understand how your players transition through every path in your game by examining your game's custom events. This tools is often used when examining why players are dropping off between two key points in your game. For example, if you've made a custom funnel and can see a drastic decrease in users transitioning between Step 3 and Step 4, then you can make a journey out of those two steps to see why players are falling off at that location and where they are going instead.

Required to Start using Journeys

tag

To start using Journeys, you must first have initialized the ByteBrew SDK and integrated custom events in your game.

lightbulbTip To create the best visual journeys in your games, make sure to not only track custom events throughout your games, but also subparameters under each event. Including subparameters in your custom events will allow you to unlock deeper analysis in your player's behavior.

Creating Journeys

tag

When building Journeys on the dashboard, you have several options for examining your player's user journey through your game. See below sections on how to create Journeys using your game's custom events.

Setting Up Events

To start building a Journey, you must first set up the event's on the Journey dashboard you want to visually analyze. Under the Events column of Journey's settings, you can add a Start Event AND/OR an End Event to build your Journey. Follow steps below to learn how to setup start and end events for your Journey:

infoNote You can set up a journey using both a Start Event and End Event, but you do not need to always use both events to create a Journey. You have the option to build a journey using only a Start Event of an End Event.

lightbulbTip If you build a journey using only 1 Start or End Event then you have the ability to see user Dropoffs in the user journey.

Start Event:

Click the Start Event checkbox to enable a Start Event.

After enabling Start Events, then choose the Start Event you'd like to use in your Journey using the Event dropdown.

Optional:Add a subparameter to your subparameter that you'd like the system to filter your event by when building your Journey.

End Event:

Click the End Event checkbox to enable an End Event.

After enabling End Events, then choose the End Event you'd like to use in your Journey using the Event dropdown.

Optional:Add a subparameter to your subparameter that you'd like the system to filter your event by when building your Journey.

Adding Segments

After setting up your events for your Journey, you can create a user segment to refine what users you want the Journey to be filtered by. See steps below on how to setup your Segments in Journeys:

Click the "Settings" Button to top the Segment settings panel.

Select the filters you'd like to apply to the segment.

Exclude Events

When you're creating a user Journey, you have the option to exlcude events in the query's analysis. Excluding an event will remove it from being visualized in the Journey chart paths. This can be a useful function when you want to clean up your user journey to see a refined series of paths. See steps below to learn how to exclude an event:

Click the Exclude Event checkbox to enable excluding events.

After enabling, choose the event(s) you'd like to exclude from your user Journey using the dropdown. You can exclude multiple events from your Journey by selecting multiple events in the Exclude Events dropdown.

Expand Events

Another option you have when building your user Journey is expanding events in your user paths. Expanding an event will drill into the event's values by the dimension you select.

notification_importantImportantYou cannot expand an event that you've selected as your Start or End Event.

Click the Expand Event checkbox to enable event expansion.

After enabling, start selecting events to expand by selecting "Add Expansion Setting".

Using the dropdown, select the event you want to Expand.

After choosing the event to expand, click "Expand By" and select how you'd like to expand the event. See below for list of options to Expand By:

fiber_manual_record

Value: Expand by event's value.

fiber_manual_record

Date: Expand by Dates of Query.

fiber_manual_record

Build: Expand by Build of your game.

fiber_manual_record

OS: Expand by your player's device Operating System.

fiber_manual_record

Geo: Expand by User's Country.

fiber_manual_record

Device Type: Expand by your player's Devices.

fiber_manual_record

Custom Event Subparameters: Expand by your event's subparameters.

infoNote You can expand multiple events in your Journey by selecting "Add Expansion Settings" to dropdown another event to expand.

Tracked By

Once you've setup your events and journey settings you can determine the user purview you'd like to track. You have two options: 1. Session, 2. Lifetime. See how each option is defined below:

infoNote Default for Tracked by is Session.

Session:

Tracking by a user's session will limit how the user journey is built to examine only within a user's individual game session. This is a great way to get a more micro view at a user's path.

Lifetime:

Tracking by a user's lifetime will show the user journey across user's gameplay sessions in your game. This is will show a more grand macros scale of your user's path spreading across all their sessions.

Top Values

One of the last steps in building a Journey is selecting the percentile of paths you want the query to analyze. In the Top Values dropdown you can select from a range of percentages (%). By selecting a value such as "1%", you are asking the system to only show the top 1% most popular user paths that your players follow. This means that the query will find the absolute most common paths that users take while traveling through your Events setup. If you choose the option for "20%", then you're examining a wider range of paths that are much less popular.

Show Dropoffs

Showing Dropoffs in your journey will add Dropoff paths to your Journey's chart output. To enable this setting, just click the Show Dropoff checkbox.

infoNote If you have selected BOTH a Start Event and End Event in your Journey, then dropoff paths will not populate in your chart.

Journey Chart

tag

Journeys creates an interactive Sankey diagram. By hovering over the diagram will show you information about the user paths. See below sections for the list of info given while hovering on the Journey chart.

lightbulbTipJourney chart diagrams are interactive. See the different chart controls detailed in the Chart Controls section.

Journey Chart Hovers

Path Count	Number count of times users in the Journey have traveled through the path stage.
Users	Number of total users in the Journey have traveled through the path stage.
Transitioned Percentage	The percentage of users who have traveled from the previous stage to the current stage in the user path. *This percentage value only takes into account the percentage of users based on the stage before it, not all previous stages from the start of the journey.*

Chart Controls

The Journeys chart diagram is interactable with user controls. See list of controls below:

Drag	Click and drag anywhere on the diagram to move it.
Zoom In	Pinch in your trackpad or scroll in with a mouse to zoom into the diagram.
Zoom Out	Pinch outwards your trackpad or scroll out with a mouse to zoom out the diagram.

Saving Journeys

After building your journey, you have the option to save it; so you don't need to re-build the same query each time. Follow the steps below to save a Journey:

After creating your Journey, open the Save Filters panel by clicking the "Save Filters" button.

Type the name of the filter you're saving to remember what the filter you built.

Loading Journeys

Any Journey you save can be reloaded later into the Journey dashboard by clicking the "Load Filters" button to open the Load Filters panel. See the options list below the Load Filter panel:

fiber_manual_record

Load Saved Filter: To load a filter you've saved in the "Load Filter" panel, click "Load" button next to the saved filter you want to analyze.

fiber_manual_record

Delete Saved Filter: To delete a filter you've saved in the "Load Filter" panel, click "Delete" button next to the saved filter you want to remove.

FAQs

What does the Transitioned % show?

This metric shows, the percentage of users who have traveled from the previous stage to the current stage. It does not show the percentage of users who have traveled through this path from the start of the Journey.

Why can't I see user dropoffs?

If you set up both a Start Event and an End event, then you will not see user Dropoffs populate in the Journey chart.

What does Top Values mean?

Top Values is the percentile of paths that you want the system to search for. The smaller the percentage, the more popular the paths will be used to analyze. Ex. 1% Top Values will show only the absolute most common user paths taken by players based on your event setup. 20% Top Values will include less common user paths with a wider view of paths.

Why do I not see my selected event Expanded?

The most common reason this happens is that you've expanded an event that is used as a Start or End Event in your Journey query. Events that are used as a Start or End event are not able to be expanded.

Can I export a Journey?

Not currently, however, you can always take a screenshot to save as an image for later.

Need some help?

Join the ByteBrew Discord community to chat with our team and other developers on the platform.

Go to Discord arrow_outward

help What is best practice for creating Journeys? To get the best journey with detailed user paths, make sure to include subparameters under each custom event you integrate in your game.