Documentation Index Fetch the complete documentation index at: https://docs.cryptique.io/llms.txt
Use this file to discover all available pages before exploring further.
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
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
Set Conversion Window
Choose how long users have to complete the funnel:
1 hour, 1 day, 7 days, 30 days, etc.
Choose Measurement
Conversion Rate : Percentage completing all stepsUnique Users : Count at each stepTime to Convert : Average time between steps
Apply Filters
Filter to specific user segments or time periods
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 → CInvalid: 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
