Skip to main content

Overview

Funnels measure how users progress through a sequence of events. Track conversion rates, identify drop-off points, and understand how long users take to complete multi-step processes. In Cryptique, funnels are uniquely powerful because they can combine off-chain events (website behavior) with on-chain transactions (blockchain activity).

Use Cases

  • What percent of users who view the swap page actually swap?
  • Where do users drop off in the onboarding flow?
  • How does mobile conversion compare to desktop?
  • What percent of wallet connections lead to transactions?
  • How long from first visit to first on-chain transaction?
  • Which traffic sources have the highest transaction conversion?
  • How many users who try feature X go on to use feature Y?
  • What’s the path from free to paid?
  • Do users who complete onboarding transact more?

Quick Start

1

Define Funnel Steps

Add events in order. Each step must happen after the previous:
Step 1: page_view (landing page)
Step 2: wallet_connect
Step 3: swap_initiated
Step 4: Transaction: swapExactTokensForTokens
2

Set Conversion Window

Choose how long users have to complete the funnel:
  • 1 hour, 1 day, 7 days, 30 days, etc.
3

Choose Measurement

  • Conversion Rate: Percentage completing all steps
  • Unique Users: Count at each step
  • Time to Convert: Average time between steps
4

Apply Filters

Filter to specific user segments or time periods
5

Add Breakdowns

See how conversion varies by property

Funnel Structure

Steps

Each funnel step is an event or transaction:

Conversion Window

Users must complete all steps within the window: Conversion Window: 7 days — User A completed in 6 days; User B missed the window.

Step Order

Steps must occur in the defined order: Valid: A → B → C Invalid: A → C → B or B → A → C (order matters)

Measurements

Conversion Rate

Percentage of users who complete each step: Overall Conversion: 8%

Step-by-Step Rate

Conversion from each step to the next:
├── Step 1 → Step 2: 35% (3,500 / 10,000)
├── Step 2 → Step 3: 34% (1,200 / 3,500)
└── Step 3 → Step 4: 67% (800 / 1,200)

Time to Convert

How long users take between steps:
Average time:
├── Step 1 → Step 2: 2.5 hours
├── Step 2 → Step 3: 15 minutes
├── Step 3 → Step 4: 5 minutes
└── Total: 2 hours 50 minutes

Filters

Filter your funnel to specific segments:

Global Filters

Apply to all steps:
Filter: country = "US" AND device_type = "mobile"

All steps will only include US mobile users

Step-Specific Filters

Apply to individual steps:
Step 1: page_view
  └── where: uri = "/swap" (step filter)
  
Step 2: wallet_connect
  └── where: wallet_type = "metamask" (step filter)

User Property Filters

Filter by user attributes:
Filter: Users where
├── plan = "pro"
├── AND wallet_age_days > 30
└── AND is_whale = false

Breakdowns

See how conversion varies across segments:

Property Breakdown

Funnel by utm_source:
├── twitter: 12% conversion
├── discord: 18% conversion
├── google: 8% conversion
└── direct: 15% conversion

Cohort Breakdown

Funnel by user type:
├── Whales: 25% conversion
├── Active traders: 15% conversion
└── New users: 6% conversion

Visualizations

Funnel Steps View

See the funnel as a visual diagram: 65% drop → 23% drop → 4% drop between steps

Line Chart

See conversion trend over time:
Overall conversion rate by week:
├── Week 1: 7%
├── Week 2: 8%
├── Week 3: 9%
└── Week 4: 8%

Bar Chart

Compare conversion across segments:
Conversion by chain:
├── Ethereum: 12%
├── Polygon: 15%
├── Arbitrum: 18%
└── Base: 14%

Advanced Features

Conversion Criteria

Ordered Steps (default): Users must complete steps in exact order.
A → B → C required
A → C → B does not convert
Any Order: Steps can happen in any sequence within window.
A, B, C required (any order)
A → C → B converts ✓
C → A → B converts ✓

Counting Methods

Unique Users (default): Each user counted once, on first entry:
User enters funnel multiple times:
├── Monday: Enters at Step 1
├── Tuesday: Enters at Step 1 again
└── → Only Monday entry counted
Totals: Count all funnel entries:
User enters funnel multiple times:
├── Monday: Entry 1
├── Tuesday: Entry 2
└── → Both entries counted

Time to Convert Distribution

See how conversion time varies:
Time to complete funnel:
├── < 1 hour: 45%
├── 1-4 hours: 25%
├── 4-24 hours: 15%
├── 1-3 days: 10%
└── > 3 days: 5%

Hold Property Constant

Require a property to be the same across steps:
Hold constant: input_token

User swaps ETH in step 1, must swap ETH in transaction:
├── Step 1: swap_initiated (input_token = "ETH")
└── Step 4: Transaction with ETH → Counts ✓

├── Step 1: swap_initiated (input_token = "ETH")
└── Step 4: Transaction with MATIC → Does NOT count ✗

Web3 Funnel Examples

Website to On-Chain Conversion

Track the full journey from landing to blockchain:
Step 1: page_view (landing page)
Step 2: button_clicked (CTA)
Step 3: wallet_connect
Step 4: swap_initiated (button click)
Step 5: [Transaction] swap on DEX

Filter: utm_source = "twitter"
Window: 7 days

Multi-Chain Attribution

Compare conversion by blockchain:
Step 1: wallet_connect
Step 2: chain_selected
Step 3: [Transaction] any transaction

Breakdown: chain

NFT Mint Funnel

Track mint journey:
Step 1: collection_viewed
Step 2: wallet_connect
Step 3: mint_initiated
Step 4: [Transaction] mint function

Breakdown: traffic_source

Feature to Transaction

Do feature users convert better?
Step 1: feature_used (advanced_charts)
Step 2: [Transaction] any transaction

Compare to:
Step 1: page_view (any page)
Step 2: [Transaction] any transaction

Analyzing Results

Identifying Drop-Off Points

Look for the biggest drops:
├── Step 1 → Step 2: 35% (65% drop) ← Biggest drop!
├── Step 2 → Step 3: 80% (20% drop)
└── Step 3 → Step 4: 90% (10% drop)

Focus on: Why aren't users connecting wallets?

Comparing Segments

Find high-performing segments:
By device:
├── Desktop: 12% conversion
└── Mobile: 4% conversion ← Investigate mobile UX

By country:
├── US: 15% conversion
├── UK: 14% conversion
└── DE: 8% conversion ← Different market?

Time Analysis

Understand conversion timing:
Users who convert in < 1 hour: 45%
→ Quick decision makers

Users who convert in > 24 hours: 15%
→ Need nurturing/reminders

Best Practices

Keep Funnels Focused

✅ Good: 4-6 steps focused on one journey
page_view → wallet_connect → swap_init → transaction

❌ Avoid: 15 steps covering everything
page_view → click → scroll → hover → click → modal → ...

Choose Appropriate Windows

Quick actions (checkout): 1 hour - 1 day
Considered decisions (signup): 1-7 days
Long cycles (enterprise): 7-30 days

Use Consistent Filters

When comparing funnels, use the same base filters:
✅ Compare: 
- Twitter traffic funnel (filter: utm_source = twitter)
- Discord traffic funnel (filter: utm_source = discord)

❌ Misleading:
- All traffic funnel
- Mobile-only funnel (different population)

Next Steps

Retention

Measure user engagement over time

Cohorts

Create user segments