Sessions & Cross-Device Tracking

Oppla provides advanced session tracking with cross-device identification, session stitching, and unified user journey analytics. Track users seamlessly as they move between devices, browsers, and products.

Advanced Session Capabilities

Cross-Device Tracking

Track users across mobile, desktop, and tablet seamlessly

Session Stitching

Automatically connect anonymous and identified sessions

Multi-Product Sessions

Track sessions across multiple products and platforms

IP Geolocation

Automatic location tracking via ipapi.co integration

What are Sessions?

Sessions in Oppla represent continuous periods of user activity with advanced features:

Cross-Device Journey: Track users across all their devices
Unified Identity: Connect anonymous and authenticated sessions
Real-Time Tracking: Monitor active sessions as they happen
Smart Attribution: Understand true conversion paths across devices
Session Replay: Reconstruct user journeys across touchpoints

Cross-Device User Identification

Identifying Users Across Devices

Connect user sessions across all devices:

// When user logs in on any device
window.oppla.identify('user_123', {
  email: 'user@example.com',
  name: 'John Doe',
  plan: 'premium',
  // Device-specific attributes
  device: {
    type: getDeviceType(), // 'mobile', 'desktop', 'tablet'
    id: getDeviceId(),
    platform: navigator.platform
  }
});

// This automatically:
// 1. Links current session to user_123
// 2. Connects all past anonymous sessions
// 3. Enables cross-device tracking
// 4. Enriches with IP geolocation

Session Stitching

Oppla automatically stitches sessions when users authenticate:

// Anonymous session (before login)
window.oppla.track('product_viewed', {
  productId: 'prod_123',
  sessionId: 'anon_session_456' // Automatic
});

// User logs in
window.oppla.identify('user_123', {
  email: 'user@example.com'
});
// Previous anonymous events are now linked to user_123

// Continued tracking (after login)
window.oppla.track('product_purchased', {
  productId: 'prod_123',
  sessionId: 'auth_session_789' // Automatic
});

Enhanced Session Events

Oppla tracks comprehensive session data with cross-device context:

// Session Started (with enrichment)
{
  event: 'session_started',
  properties: {
    timestamp: '2024-03-20T10:00:00Z',
    sessionId: 'sess_abc123',
    userId: 'user_123', // If identified
    deviceId: 'device_456',
    referrer: 'https://google.com',
    userAgent: 'Mozilla/5.0...',
    // IP Geolocation (automatic)
    location: {
      ip: '192.168.1.1',
      country: 'United States',
      region: 'California',
      city: 'San Francisco',
      lat: 37.7749,
      lon: -122.4194
    },
    // Device context
    device: {
      type: 'mobile',
      os: 'iOS',
      browser: 'Safari',
      screenResolution: '390x844'
    },
    // Cross-device context
    crossDevice: {
      isReturning: true,
      lastDevice: 'desktop',
      totalDevices: 3
    }
  }
}

// Cross-Device Session Link
{
  event: 'session_linked',
  properties: {
    currentSession: 'sess_mobile_123',
    linkedSessions: ['sess_desktop_456', 'sess_tablet_789'],
    userId: 'user_123',
    linkMethod: 'authentication' // or 'fingerprint', 'email_link'
  }
}

// Session Handoff (device switch)
{
  event: 'session_handoff',
  properties: {
    fromDevice: 'mobile',
    toDevice: 'desktop',
    handoffMethod: 'qr_code', // or 'email_link', 'deep_link'
    continuityScore: 0.95 // Confidence in session continuity
  }
}

Cross-Device Tracking Implementation

Mobile App Tracking

Track mobile sessions with device context:

// React Native
import OPPLATracker from '@oppla/react-native';

OPPLATracker.initialize({
  productId: 'prod_mobile_app',
  enableCrossDevice: true
});

// Track with device context
OPPLATracker.track('app_opened', {
  deviceId: getDeviceId(),
  platform: Platform.OS,
  appVersion: getVersion()
});

// Link to web session
OPPLATracker.linkWebSession({
  webSessionId: 'sess_web_123',
  method: 'deep_link'
});

Desktop Tracking

Desktop session with cross-device awareness:

// Desktop web app
window.oppla.track('session_started', {
  device: 'desktop',
  screenResolution: `${screen.width}x${screen.height}`,
  // Check for mobile sessions
  checkCrossDevice: true
});

// Generate QR code for mobile continuation
const qrData = window.oppla.generateSessionHandoff({
  targetDevice: 'mobile',
  expiresIn: 300 // 5 minutes
});

Session Continuity

Maintain session continuity across devices:

// Save session for cross-device access
window.oppla.saveSessionForDevice({
  userId: 'user_123',
  sessionData: {
    cart: getCartItems(),
    preferences: getUserPreferences(),
    progress: getCurrentProgress()
  }
});

// Restore on another device
window.oppla.restoreSession({
  userId: 'user_123',
  merge: true // Merge with current session
});

Advanced Session Analytics

Cross-Device Funnels

Track conversion funnels across devices:

// Track funnel step with device context
window.oppla.track('funnel_step', {
  funnel: 'purchase_flow',
  step: 2,
  stepName: 'add_to_cart',
  device: getCurrentDevice(),
  // Previous steps on other devices
  crossDeviceJourney: [
    { step: 1, device: 'mobile', timestamp: '2024-01-01T10:00:00Z' }
  ]
});

// Analyze cross-device conversion
const funnelAnalysis = await oppla.analyzeFunnel({
  funnel: 'purchase_flow',
  includeCrossDevice: true,
  attribution: 'last_touch' // or 'linear', 'time_decay'
});

Device Switching Patterns

Analyze how users switch between devices:

// Track device switch
window.oppla.track('device_switched', {
  from: getPreviousDevice(),
  to: getCurrentDevice(),
  reason: 'user_initiated', // or 'session_timeout', 'app_switch'
  sessionContinuity: true,
  timeBetweenDevices: 120 // seconds
});

// Common patterns
window.oppla.track('device_pattern', {
  pattern: 'research_mobile_purchase_desktop',
  devices: ['mobile', 'desktop'],
  totalTime: 3600, // 1 hour
  conversions: 1
});

Multi-Product Sessions

Track sessions across multiple products:

// Product A (Web App)
window.oppla.track('cross_product_session', {
  currentProduct: 'web_app',
  userId: 'user_123',
  sessionFlow: ['landing_page', 'signup', 'dashboard']
});

// Product B (Mobile App)
OPPLATracker.track('cross_product_session', {
  currentProduct: 'mobile_app',
  userId: 'user_123',
  previousProduct: 'web_app',
  continuationMethod: 'push_notification'
});

// Product C (API)
oppla.track('cross_product_session', {
  currentProduct: 'api',
  userId: 'user_123',
  apiClient: 'mobile_app',
  sessionChain: ['web_app', 'mobile_app', 'api']
});

Session Intelligence Dashboard

Cross-Device Analytics

View comprehensive cross-device metrics:

Device Distribution: See how users split across devices
Journey Maps: Visualize cross-device user paths
Attribution Models: Understand conversion attribution
Session Timeline: View unified session history
Device Cohorts: Analyze behavior by device combinations

Real-Time Session Monitoring

Monitor active sessions across all devices:

// Real-time session feed
const activeSessions = await oppla.getActiveSessions({
  includeCrossDevice: true,
  groupByUser: true
});

// Returns
{
  "user_123": {
    "devices": ["mobile", "desktop"],
    "sessions": [
      {
        "device": "mobile",
        "started": "2024-01-01T10:00:00Z",
        "location": "San Francisco, CA",
        "active": true
      },
      {
        "device": "desktop",
        "started": "2024-01-01T10:05:00Z",
        "location": "San Francisco, CA",
        "active": true
      }
    ],
    "isMultiDevice": true
  }
}

Best Practices

1. User Identification Strategy

// Identify users consistently across devices
const identifyUser = (userId, userData) => {
  // Always include email for cross-device matching
  window.oppla.identify(userId, {
    email: userData.email, // Key for cross-device
    ...userData,
    identifiedAt: new Date().toISOString(),
    identificationMethod: getIdentificationMethod()
  });
};

2. Handle Device Transitions

// Smooth device handoff
const initiateDeviceHandoff = async () => {
  const handoffToken = await window.oppla.createHandoffToken({
    currentSession: getSessionId(),
    expiresIn: 300,
    targetDevices: ['mobile', 'tablet']
  });
  
  // Display QR code or send email
  displayHandoffQR(handoffToken);
};

3. Privacy Considerations

// Respect user privacy preferences
window.oppla.configure({
  crossDeviceTracking: getUserConsent('cross_device'),
  ipGeolocation: getUserConsent('location'),
  sessionRecording: getUserConsent('recording')
});

4. Session Quality Metrics

Monitor cross-device session quality:

Multi-Device Users: Percentage using multiple devices
Device Switching Rate: How often users switch
Cross-Device Conversion: Conversion rates for multi-device users
Session Continuity: Success rate of session handoffs
Device Attribution: Which devices drive conversions

Troubleshooting

Common Issues

Issue	Solution
Sessions not linking	Ensure users are identified with same ID across devices
Missing device context	Check that device detection is enabled
Incorrect attribution	Verify attribution model settings
Session timeout	Adjust session timeout settings for your use case

Debug Mode

// Enable cross-device debug mode
localStorage.setItem('oppla.crossdevice.debug', 'true');

// Log all session events
window.oppla.onSessionEvent = (event) => {
  console.log('[Oppla Session]', event);
};

Next Steps

Real-Time Analytics

Monitor sessions in real-time

Multi-Product Setup

Track across multiple products

User Journey

Analyze cross-device journeys

Privacy Settings

Configure privacy and consent

Getting Started

Advanced Features

How To

Sessions & Cross-Device Tracking

Sessions & Cross-Device Tracking

Advanced Session Capabilities

Cross-Device Tracking

Session Stitching

Multi-Product Sessions

IP Geolocation

What are Sessions?

Cross-Device User Identification

Identifying Users Across Devices

Session Stitching

Enhanced Session Events

Cross-Device Tracking Implementation

Mobile App Tracking

Desktop Tracking

Session Continuity

Advanced Session Analytics

Cross-Device Funnels

Device Switching Patterns

Multi-Product Sessions

Session Intelligence Dashboard

Cross-Device Analytics

Real-Time Session Monitoring

Best Practices

1. User Identification Strategy

2. Handle Device Transitions

3. Privacy Considerations

4. Session Quality Metrics

Troubleshooting

Common Issues

Debug Mode

Next Steps

Real-Time Analytics

Multi-Product Setup

User Journey

Privacy Settings

Getting Started

Advanced Features

How To

Documentation Index

​Sessions & Cross-Device Tracking

​Advanced Session Capabilities

Cross-Device Tracking

Session Stitching

Multi-Product Sessions

IP Geolocation

​What are Sessions?

​Cross-Device User Identification

​Identifying Users Across Devices

​Session Stitching

​Enhanced Session Events

​Cross-Device Tracking Implementation

​Mobile App Tracking

​Desktop Tracking

​Session Continuity

​Advanced Session Analytics

​Cross-Device Funnels

​Device Switching Patterns

​Multi-Product Sessions

​Session Intelligence Dashboard

​Cross-Device Analytics

​Real-Time Session Monitoring

​Best Practices

​1. User Identification Strategy

​2. Handle Device Transitions

​3. Privacy Considerations

​4. Session Quality Metrics

​Troubleshooting

​Common Issues

​Debug Mode

​Next Steps

Real-Time Analytics

Multi-Product Setup

User Journey

Privacy Settings

Sessions & Cross-Device Tracking

Advanced Session Capabilities

What are Sessions?

Cross-Device User Identification

Identifying Users Across Devices

Session Stitching

Enhanced Session Events

Cross-Device Tracking Implementation

Mobile App Tracking

Desktop Tracking

Session Continuity

Advanced Session Analytics

Cross-Device Funnels

Device Switching Patterns

Multi-Product Sessions

Session Intelligence Dashboard

Cross-Device Analytics

Real-Time Session Monitoring

Best Practices

1. User Identification Strategy

2. Handle Device Transitions

3. Privacy Considerations

4. Session Quality Metrics

Troubleshooting

Common Issues

Debug Mode

Next Steps