Skip to main content


Scuba Docs

Create a flow

A flow helps you visualize the path of actions taken by a group of actors.

You can view the discovery paths of all actors simultaneously, investigate the events of all actors on an individual path, or use information from a flow as input in a top-level query. In this way, flows provide you with the tools to track trends and determine projected user behaviors over time.

Creating a basic flow

Among their many uses, flows help you analyze actor engagement, conversion, and path discovery. This section demonstrates how to create a flow that shows the paths for users who purchased a movie. 

To create a basic flow, do the following:
  1. In the Scuba UI, click Data in the left navigation bar.
  2. Click the Flows tab.
  3. Choose a dataset from the dropdown list at the top of the window. We chose the movies dataset for our example. The options available to you will reflect your data.
  4. In the top right corner of the window, click +New Flow.
  5. Enter a name for the flow at the top of the page.
  6. In the Definition tab, select an Actor from the drop-down list. We chose user for our example.
  7. Enter a descriptive name for Step 1 and select a filter from the drop-down menu. We entered Anything for the name and accepted the default filter all events

Screen Shot 2019-12-26 at 1.26.37 PM.png

  1. Enter a descriptive name for Step 2 and select the appropriate filter options from the dropdown lists. We entered Purchase Movie and click on all events to select events with action that matches purchase_movie. See Understand flow definition conditions in the User's Guide for more information.

Screen Shot 2019-12-26 at 10.55.44 AM.png

  1. Optional: Add another step, entering a name, and selecting filter options.
  2. To end the flow, click the minus sign next to the last, empty step, and scroll down to Global Rules.
    1. Select end flow from inactivity and enter or select a time interval.
      Screen Shot 2019-12-26 at 1.58.15 PM.png
    2. Enter or select an end flow for max total time option. The selections for our example are shown in the following screenshot.
      Screen Shot 2019-12-26 at 2.02.32 PM.png
  3. Specify Filtered to values or accept all events as we did for our example.
  4. Click GO to generate the flow. The results appear in the window on the right. We received the following results for our flow.
    Note that the gray segment denotes the population that dropped off. These are flow instances that satisfied one of the flow end conditions (inactivity of 30 minutes or max total time of 1 week) before they were able to reach the "Purchase movie" step. It follows that only the smaller line on the bottom denotes the population that purchased a movie.
  5. Optional: Split by an additional quantity to compare user paths leading to a movie purchase. In the results pane, next to Split by Flow Path, click + to access the dropdown. In our example, we select action.

What's Next

Now that you've created a basic flow, you're ready to analyze the results.

  • Was this article helpful?