Building a Bulletproof dataLayer: Standardized Event Schemas for Enterprise Apps

export interface LeadEvent {
  event: "generate_lead";
  event_id: string;
  lead_type: "consultation_booking" | "audit_request" | "newsletter_signup";
  lead_value?: number;
  currency?: "USD" | "EUR" | "GBP";
  form_id: string;
  user_data?: {
    email?: string;
    phone?: string;
  };
}

export interface PurchaseEvent {
  event: "purchase";
  event_id: string;
  ecommerce: {
    transaction_id: string;
    value: number;
    currency: string;
    tax?: number;
    shipping?: number;
    items: Array<{
      item_id: string;
      item_name: string;
      price: number;
      quantity: number;
    }>;
  };
}

export type AnalyticsEvent = LeadEvent | PurchaseEvent;

export function pushDataLayer(payload: AnalyticsEvent): void {
  if (typeof window !== "undefined") {
    window.dataLayer = window.dataLayer || [];
    window.dataLayer.push(payload);
  }
}