Add react_app and page_type to hydro-analytics events (#59437)

Author: heiskr

src/events/components/hydro-analytics.ts

@@ -57,7 +57,8 @@ const AUTO_COLLECTED_FIELDS = new Set([
 
 /**
  * Flatten a nested event body into a single-level context object,
- * excluding fields that hydro-analytics-client already auto-collects.
+ * excluding fields that hydro-analytics-client already auto-collects,
+ * and adding fields required for analytics_v0_page_view compatibility.
  */
 export function prepareData(body: Record<string, unknown>): {
   type: string
@@ -74,6 +75,16 @@ export function prepareData(body: Record<string, unknown>): {
       .filter(([key]) => !AUTO_COLLECTED_FIELDS.has(key))
       .map(([key, value]) => [key, String(value)]),
   )
+
+  // Add fields required for analytics_v0_page_view compatibility
+  // These are expected by the BI team's dashboards
+  context.react_app = 'docs'
+  // Preserve our page_type as docs_page_type, then set page_type to 'marketing' for BI
+  if (context.page_type) {
+    context.docs_page_type = context.page_type
+  }
+  context.page_type = 'marketing'
+
   return { type: typeof type === 'string' ? type : 'unknown', context }
 }
 

src/events/tests/hydro-analytics.ts

@@ -99,4 +99,33 @@ describe('prepareData', () => {
     expect(result.type).toBe('page')
     expect(result.context.exit_scroll_length).toBe('0.5')
   })
+
+  test('adds react_app field for analytics_v0_page_view compatibility', () => {
+    const body = {
+      type: 'page',
+      context: { event_id: '123' },
+    }
+    const result = prepareData(body)
+    expect(result.context.react_app).toBe('docs')
+  })
+
+  test('adds page_type field when not present', () => {
+    const body = {
+      type: 'page',
+      context: { event_id: '123' },
+    }
+    const result = prepareData(body)
+    expect(result.context.page_type).toBe('marketing')
+    expect(result.context.docs_page_type).toBeUndefined()
+  })
+
+  test('preserves existing page_type as docs_page_type and sets page_type to marketing', () => {
+    const body = {
+      type: 'page',
+      context: { event_id: '123', page_type: 'article' },
+    }
+    const result = prepareData(body)
+    expect(result.context.page_type).toBe('marketing')
+    expect(result.context.docs_page_type).toBe('article')
+  })
 })