Skip to main content
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
  • Cross-domain tracking: Track users across multiple domains, such as your landing page and FunnelFox funnel
  • Real-time Data: See events as they happen

​
Configuration

​
Prerequisites

  • Active Amplitude account with the data storage location correctly set up
  • 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

Paste API Key in FunnelFox

  1. Go to Settings > Integrations > Amplitude in FunnelFox
  2. Paste your API key into the Amplitude Public API Key field
If you see the Invalid key error message, FunnelFox couldn’t validate your key against the US or EU endpoints. Ensure your data storage location is set correctly in Amplitude, or create a new Amplitude account with the correct region.
3

Enable Session Replay (Optional)

Session Replay captures user interactions for playback:
  1. Check Session Replay in FunnelFox settings
  2. Set Sample Rate (0-100%)
Start with a low sample rate (10%) 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 toggled off: screen_completed → Page View (Amplitude standard names)
  • When toggled 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}
  • User ID: Undefined by default so you can assign your own later
  • User Properties: Includes email and profile ID

​
Cross-domain tracking

Track users across multiple domains, such as your landing page and FunnelFox funnel. Amplitude uses device IDs to track users across domains. By default, FunnelFox generates device IDs using the fnlfx_ prefix and profile ID: fnlfx_{profile_id}. For cross-domain tracking, you need a consistent device ID across all domains. To set up cross-domain tracking:
  1. Go to Settings > Integrations > Amplitude in FunnelFox.
  2. Toggle on Cross-domain Device ID tracking.
  1. Get the device ID from amplitude.options.deviceId on your first domain (e.g., landing page), or use your own custom logic.
  2. Pass the device ID to your FunnelFox funnel using the URL parameter ampDeviceId or amp_device_id.
FunnelFox will use the passed device ID instead of generating a new one. If no device ID is passed, FunnelFox generates a new one automatically. Learn more about cross-domain tracking in Amplitude.

​
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

  • Verify API key is correct
  • Check server zone matches your Amplitude project
  • Ensure funnels were republished after configuration
  • Look for events in Amplitude’s User Lookup, not just charts
  • Confirm Session Replay is enabled in settings
  • Check sample rate is greater than 0
  • Verify your Amplitude plan includes Session Replay
  • Wait 5-10 minutes for recordings to process
  • FunnelFox couldn’t validate your key against the US or EU endpoints
  • Ensure your data storage location is set correctly in Amplitude, or create a new Amplitude account with the correct region

​
Next Steps