Migration Guides

Migrating from Google Analytics

If you're transitioning from Google Analytics to Mtrix, follow this guide for a smooth migration.

Event Mapping

Google Analytics	Mtrix
page_view	PageView
click	Click
scroll	Scroll
video_start	VideoStart
file_download	FileDownload
purchase	Purchase
add_to_cart	AddToCart
begin_checkout	BeginCheckout
view_item	ProductViewed
sign_up	Signup
login	Login
search	Search

Implementation Steps

1. Run in parallel: Initially implement Mtrix alongside Google Analytics to validate data consistency.

// Dual tracking example
function trackEvent(gaEventName, gaParams, mtrixEventName, mtrixProps) {
  // Google Analytics 4 tracking
  gtag('event', gaEventName, gaParams);
  
  // Mtrix tracking
  mtrix.trackEvent(mtrixEventName, mtrixProps);
}

// Example usage
function handlePurchase(order) {
  trackEvent(
    'purchase', // GA4 event name
    {
      transaction_id: order.id,
      value: order.total,
      currency: 'USD',
      items: order.items.map(item => ({
        item_id: item.product.id,
        item_name: item.product.name,
        price: item.price,
        quantity: item.quantity
      }))
    },
    'Purchase', // Mtrix event name
    {
      orderId: order.id,
      total: order.total,
      currency: 'USD',
      products: order.items.map(item => ({
        productId: item.product.id,
        productName: item.product.name,
        price: item.price,
        quantity: item.quantity
      }))
    }
  );
}

1. Create a data dictionary: Document all events and properties to ensure consistency during the migration.

2. Update data layer integrations: Modify any data layer implementations to support Mtrix.

3. Recreate custom reports: Build equivalent reports in Mtrix for your GA custom reports.

4. Validate data: Compare key metrics between platforms during the parallel tracking period.

Timeline Recommendation

• Week 1-2: Set up Mtrix and implement basic tracking

• Week 3-4: Run both systems in parallel

• Week 5-6: Validate data and address discrepancies

• Week 7-8: Migrate custom reports and dashboards

• Week 9-10: Train team on Mtrix platform

• Week 11-12: Complete transition and phase out GA

Migrating from Mixpanel

If you're moving from Mixpanel to Mtrix, follow these steps to ensure continuity.

Implementation Code

// Mixpanel
mixpanel.track("Purchased Item", {
  "Product ID": "12345",
  "Product Name": "Premium Subscription",
  "Price": 99.99,
  "Currency": "USD"
});

// Mtrix
mtrix.trackEvent("PurchasedItem", {
  productId: "12345",
  productName: "Premium Subscription",
  price: 99.99,
  currency: "USD"
});