Firebase Analytics Integration

Firebase Analytics is a powerful analytics solution that enables tracking user interactions with your web and mobile applications. This integration allows you to send Hardal analytics events directly to Firebase Analytics.

Setup Process

1

Access Hardal Dashboard
2

Go to your Hardal dashboard
3

Navigate to Destinations
4

Open Marketing Destinations section
5

Add New Destination
6

Click “Add Destination” button
7

Select Firebase
8

Choose “Firebase Analytics” from the list
9

Begin Configuration
10

Start configuring your Firebase integration

Configuration

Your Firebase configuration should include the following essential parameters:

{
  "firebase_config": {
    "project_id": "your-project-id",
    "api_key": "your-firebase-api-key",
    "app_id": "your-firebase-app-id",
    "measurement_id": "G-XXXXXXXXXX"
  },
  "event_mapping": {
    "event_name": "##event_name##",
    "params": "##properties##",
    "user_id": "##user_id##",
    "timestamp_micros": "##created_at##"
  }
}

Variable Reference

The following variables are available for your event mapping configuration:

VariableDescription
##event_name##Name of the event (auto-mapped to Firebase format)
##properties##Event parameters object
##created_at##Event timestamp (auto-converted to microseconds)
##user_id##User identifier
##session_id##Session identifier
##page.url##Current page URL
##page.title##Page title
##page.referrer##Referrer URL

Event Name Mapping

Hardal automatically converts event names to meet these requirements:

{
  "event_name_mapping": {
    "Product Viewed": "product_viewed",
    "Add to Cart": "add_to_cart",
    "Begin Checkout": "begin_checkout"
  }
}

Parameter Validation

Firebase Analytics enforces specific requirements for event parameters:

{
  "parameter_rules": {
    "max_length": 100,
    "allowed_types": ["string", "number", "boolean"],
    "max_parameters": 25
  }
}

Testing Your Integration

1

Verify Configuration
2

Use the “Test Configuration” button to verify your Firebase setup
3

Check Debug View
4

Monitor the Firebase Analytics Debug View for real-time event validation
5

Review Events Log
6

Check the Hardal Events Log for delivery status
7

Confirm in Firebase
8

Verify events in Firebase Analytics dashboard (may take up to 24 hours to appear)

Troubleshooting

Events Not Appearing

  • Verify measurement ID is correct
  • Check API key permissions
  • Ensure events meet Firebase naming requirements