How to fix Analytics: Code 5 - Event has more than 25 parameters in Firebase

// Example Firebase Analytics event with too many parameters
logEvent(analytics, 'purchase', {
  item_id: 'SKU_123',
  item_name: 'Premium Widget',
  item_category: 'Electronics',
  price: 99.99,
  currency: 'USD',
  quantity: 1,
  // ... 20+ more parameters
});

// Instead of separate parameters for each user property:
logEvent(analytics, 'user_profile_update', {
  user_age: '30',
  user_gender: 'male',
  user_location: 'New York',
  user_occupation: 'developer',
  // ... many more
});

// Group into a structured parameter:
logEvent(analytics, 'user_profile_update', {
  user_profile: JSON.stringify({
    age: '30',
    gender: 'male',
    location: 'New York',
    occupation: 'developer'
    // Can include many properties as JSON
  }),
  update_timestamp: new Date().toISOString()
});

// Instead of one event with 30+ parameters:
logEvent(analytics, 'checkout_complete', allParameters);

// Split into logical events:
logEvent(analytics, 'checkout_items', {
  item_count: 3,
  total_value: 299.97,
  // Item-specific parameters (max 25)
});

logEvent(analytics, 'checkout_payment', {
  payment_method: 'credit_card',
  payment_processor: 'stripe',
  // Payment-specific parameters (max 25)
});

logEvent(analytics, 'checkout_shipping', {
  shipping_method: 'express',
  shipping_address: '123 Main St',
  // Shipping-specific parameters (max 25)
});

// Before: 28 parameters including debug info
logEvent(analytics, 'app_launch', {
  app_version: '1.2.3',
  os_version: '15.4',
  device_model: 'iPhone13,4',
  debug_mode: true,  // Remove this
  session_id: 'abc123',
  timestamp_ms: 1640995200000,  // Firebase adds timestamp automatically
  // ... 22 more parameters
});

// After: 20 essential parameters
logEvent(analytics, 'app_launch', {
  app_version: '1.2.3',
  os_version: '15.4',
  device_model: 'iPhone13,4',
  session_id: 'abc123',
  // ... 16 more essential parameters
});

function safeLogEvent(analytics, eventName, params) {
  const paramCount = Object.keys(params).length;

  if (paramCount > 25) {
    console.warn(`Event "${eventName}" has ${paramCount} parameters (max 25). Trimming to 25.`);

    // Keep only the first 25 parameters
    const limitedParams = {};
    let count = 0;
    for (const [key, value] of Object.entries(params)) {
      if (count >= 25) break;
      limitedParams[key] = value;
      count++;
    }

    logEvent(analytics, eventName, limitedParams);
    return;
  }

  logEvent(analytics, eventName, params);
}

// Use the safe function
safeLogEvent(analytics, 'custom_event', yourParameters);

// For web: Enable debug mode
import { getAnalytics, setAnalyticsCollectionEnabled } from "firebase/analytics";

const analytics = getAnalytics();
// In development only:
analytics.setDebugModeEnabled?.(true);

// For Android: Add to AndroidManifest.xml
// <meta-data
//   android:name="firebase_analytics_collection_deactivated"
//   android:value="false" />
// And enable verbose logging in app

// For iOS: Add to Info.plist
// <key>FirebaseAnalyticsDebugEnabled</key>
// <true/>