Amplitude integration enables automatic event tracking from your FunnelFox funnels to your existing Amplitude analytics.
Amplitude integration settings

​
Features

  • Event Tracking: Automatic capture of all standard funnel events
  • Session Replay: Record and watch user sessions to understand behavior
  • User Paths: Visualize how users navigate through your funnel
  • Behavioral Cohorts: Group users by actions and properties
  • Revenue Analytics: Track conversion rates and lifetime value
  • Real-time Data: See events as they happen

​
Configuration

​
Prerequisites

  • Active Amplitude account
  • Amplitude project with API key
  • FunnelFox project with funnels ready to publish

​
Setup Steps

1

Get Amplitude API Key

  1. Log into Amplitude
  2. Go to Settings → Projects
  3. Select your project
  4. Copy the API Key
2

Configure Server Zone

Select your data residency region:
  • US: Default, uses US data centers
  • EU: For GDPR compliance, uses EU data centers
Choose the correct server zone based on where you created your Amplitude project. Mismatched zones will cause events to fail.
3

Enable Session Replay (Optional)

Session Replay captures user interactions for playback:
  1. Check Session Replay in FunnelFox settings
  2. Set Sample Rate (0-1):
    • 0: No recordings
    • 0.1: Record 10% of sessions
    • 1: Record all sessions
Start with a low sample rate (0.1) to manage costs, then increase if needed for debugging specific issues.
4

Configure Advanced Options

Disable default events: Turn off automatic event name conversions
  • When OFF: screen_completed → Page View (Amplitude standard)
  • When ON: Events keep original names
Add Custom Amplitude (Optional): Send events to additional instance
  • Useful for staging environments or data warehouses
  • Requires separate API key and server URL
5

Save and Republish

  1. Click Save changes
  2. Republish your funnels to activate tracking
  3. Test in preview mode first

​
Event Mapping

Amplitude receives all standard events with automatic naming conventions:
FunnelFox EventAmplitude EventDescription
screen_presentedPage ViewUser completes page interactions
Enable “Disable default events” to keep original event names without Amplitude’s automatic conversions.

​
User Identification

Amplitude identifies users with:
  • Device ID: fnlfx_{profile_id} - Consistent across sessions
  • User ID: Set when email is collected or custom ID provided
  • User Properties: Email, profile ID, and custom attributes

​
Session Replay

When enabled, Session Replay provides:
  • Visual recordings of user sessions
  • Click maps and scroll depth
  • Error tracking and rage clicks
  • Form interaction analysis

​
Privacy Considerations

Session Replay automatically:
  • Masks sensitive input fields (passwords, credit cards)
  • Excludes personally identifiable information
  • Respects user privacy settings
Review Amplitude’s privacy documentation to ensure compliance with your privacy policy.

​
Automatic Event Tracking

FunnelFox automatically sends events to Amplitude. Here’s what gets sent: 
// This is what FunnelFox sends automatically when a page loads:
amplitude.track('Page View', {
  funnel_id: 'welcome-flow',
  page_index: 0,
  page_id: 'intro',
  // ... other properties
});

// For custom tracking in your funnel code:
fox.track('Custom Event', {
  category: 'engagement',
  value: 100
});

​
Testing

​
Preview Mode

  • Events are sent to Amplitude in real-time
  • Device ID includes sandbox indicator
  • Use Amplitude’s User Lookup to verify events

​
Debugging Tools

For debugging, use the Amplitude Instrumentation Explorer Chrome Extension to see events firing in real-time directly in your browser.

​
Debugging Steps

  1. Open Amplitude’s User Lookup
  2. Search for device ID: fnlfx_{your_profile_id}
  3. View real-time event stream
  4. Check event properties and user properties

​
Troubleshooting

​
Next Steps