BehavFlow logo
BehavFlow Icon Documentation

How to set up
BehavFlow

Step 1

Connecting GA4 property to BigQuery

To get started, you do not need to install any new tracking scripts on your site, web app or store. No performance drops, no developer tickets. We use the data you already collect.

BehavFlow connects directly to your Google Cloud environment. All you need to do is:

  • Link your existing GA4 property to a BigQuery project in your Google Cloud console (free tier is usually enough).
  • Create a Service Account to grant BehavFlow access to read the daily exports.

💡 Why BigQuery? GA4's standard interface heavily samples data. BigQuery gives us raw, unsampled, hit-level event data to reconstruct accurate user journeys.

Step 2

Syncing sessions (Read-Only Access)

Data privacy and security is our top priority. BehavFlow operates on a strictly Read-Only basis.

When you connect the Service Account, we only ask for the BigQuery Data Viewer and BigQuery Job User roles. This means BehavFlow cannot write, edit, or delete anything in your database, site, web app or store. Period.

Syncing your first 10k Sessions

Once connected, the engine immediately begins analyzing. We look at the first 10,000 raw sessions to map the current state of your funnels. This takes about 3-5 minutes, after which your dashboard will light up with your first visual Maps.

Core Concept

Reading Maps & Patterns

Forget traditional "Page A to Page B" funnels. BehavFlow Maps visualize the messy reality of how users navigate your site, web app or store.

🏆 Golden Paths

The highest-converting, most efficient routes. You want to force more traffic into these exact sequences.

⚠️ Friction Loops

When users bounce back and forth between "Cart", "Shipping Info", and "Return" before dropping off.

When reading a map, focus on the Path Contrast. Compare the conversion rate of a flow with an event versus a flow without that event. BehavFlow highlights the patterns costing you the most revenue automatically.

Settings

Advanced Setup & RegEx

By default, BehavFlow groups similar URLs dynamically. However, for complex setups (like headless commerce or SPAs), you may want to define your own event groupings.

You can configure custom Regular Expressions in your Settings to group paths like /product/nike-air and /product/ultra into a single /product/* node on the Map.