Home NPS - Eventos PostHog

Resumen

El Home Annual Review (NPS) trackea 7 eventos con el prefijo home_nps_*. Cubren el funnel completo: exposicion (card) → apertura del survey → progreso paso a paso → finalizacion/abandono → visualizacion de resultados. Todos los eventos se definen como constantes en analyticsEvents.homeNps.* en src/core/analytics/events.ts.

Propiedades base

Todos los eventos del Home NPS incluyen estas propiedades:

Propiedad	Tipo	Descripcion
`survey_type`	`string`	Siempre `"home-review"` (slug de la encuesta)
`survey_id`	`string \| null`	ID de la encuesta en backend. Null si la definicion no ha cargado aun
`home_id`	`string \| null`	Mapea a `propertyId` internamente

Las propiedades survey_version (numero de version de la definicion) solo estan disponibles en eventos del flujo del survey (opened, step_completed, abandoned, completed).

Catalogo de eventos

1. `home_nps_survey_cta_viewed`

El card de review es visible en la seccion home para una propiedad tappable.

Propiedad	Tipo	Valor
`survey_type`	string	`"home-review"`
`survey_id`	string \| null	Desde `useHomeReviewStatus`
`home_id`	string	`propertyId`

Archivo: HomeReviewCard.tsx
Trigger: useEffect on mount, una vez por propiedad tappable (omite status completed)
Multi-propiedad: Dispara un evento por cada fila de propiedad tappable.

2. `home_nps_survey_opened`

Usuario entra al flujo del survey desde cualquier entry point.

Propiedad	Tipo	Valor
`survey_type`	string	`"home-review"`
`survey_id`	string	Desde `definition.survey_id`
`survey_version`	number	Desde `definition.version`
`home_id`	string \| null	`propertyId`
`entry_point`	string	`"home"` \| `"deep_link"`

Archivo: SurveyScreen.tsx
Trigger: useEffect cuando viewState transiciona a intro o questions por primera vez
Guard: No se dispara si engine.alreadyCompleted (survey reanudado ya completado)

Entry points:

Home Card
Deep Link

Usuario toca CTA en el card de la home screen → URL param entryPoint=home

Push notification, email link, etc. → Sin param entryPoint, default a "deep_link"

3. `home_nps_step_completed`

Usuario responde una pregunta y avanza a la siguiente.

Propiedad	Tipo	Valor
`survey_type`	string	`"home-review"`
`survey_id`	string	Desde `definition.survey_id`
`survey_version`	number	Desde `definition.version`
`home_id`	string	Siempre disponible durante el flujo del survey
`step_number`	number	Posicion secuencial 1-based tal como la experimenta el usuario
`step_id`	string	`question.id` de la definicion backend — joinable con datos del backend
`step_type`	string	`"star_rating"` \| `"single_choice"` \| `"multi_choice"` \| `"open_text"` \| `"swipe_boolean"`
`has_optional_comment`	boolean	Si el usuario lleno una pregunta condicional inline de tipo `open_text`

Archivo: useSurveyEngine.ts (callback) → SurveyScreen.tsx (capture)
Trigger: Dentro de goToNextQuestion, via callback onStepCompleted

step_number es secuencial sin gaps — refleja la experiencia del usuario, no el orden de la definicion. Preguntas condicionales que no se muestran no generan eventos.

4. `home_nps_survey_abandoned`

Usuario sale del survey sin completarlo.

Propiedad	Tipo	Valor
`survey_type`	string	`"home-review"`
`survey_id`	string	Desde `definition.survey_id`
`survey_version`	number	Desde `definition.version`
`home_id`	string \| null	Null si se abandono antes de seleccionar propiedad
`steps_completed`	number	Numero de pasos completados (0 si aun en el primer paso)

Archivo: SurveyScreen.tsx
Trigger: handleClose cuando viewState !== 'completion'
Se dispara al cerrar explicitamente (boton back/close), NO al ir a background (background dispara flushToBackend para guardar progreso)

5. `home_nps_survey_completed`

Survey enviado exitosamente al backend.

Propiedad	Tipo	Valor
`survey_type`	string	`"home-review"`
`survey_id`	string	Desde `definition.survey_id`
`survey_version`	number	Desde `definition.version`
`home_id`	string	Siempre disponible al completar
`has_final_comment`	boolean	Si la ultima pregunta (tipo `open_text`) fue respondida
`total_steps`	number	`definition.steps.length` — varia por condicionales

Archivo: SurveyScreen.tsx
Trigger: useEffect cuando viewState transiciona a completion
Guard: No se dispara si engine.alreadyCompleted (survey reanudado ya completado)

Las encuestas completadas por agentes de soporte via back office se rastrean server-side. Se pueden distinguir de las completadas en la app usando la propiedad $lib de PostHog (posthog-react-native para la app vs el SDK del backend para back office).

6. `home_nps_report_cta_viewed`

El card de resultados es visible para el usuario (~8 dias despues del cierre del periodo de review).

Propiedad	Tipo	Valor
`survey_type`	string	`"home-review"`
`survey_id`	string \| null	Desde `useHomeReviewStatus`
`home_id`	string	`propertyId`

Archivo: HomeReviewResultsCard.tsx (useEffect on mount)

7. `home_nps_report_opened`

Usuario toca el CTA para ver el reporte de resultados.

Propiedad	Tipo	Valor
`survey_type`	string	`"home-review"`
`survey_id`	string \| null	Desde `useHomeReviewStatus`
`home_id`	string	`propertyId`

Archivo: HomeReviewResultsCard.tsx (onPress antes de WebView)

Diagramas de flujo

Entry points

[Card]      survey_cta_viewed → [toca CTA] → survey_opened(entry_point="home")

[Deep Link] [sin evento de exposicion] → survey_opened(entry_point="deep_link")

Flujo del survey

survey_opened
  → step_completed(1) → step_completed(2) → ... → survey_completed

survey_opened
  → step_completed(1) → step_completed(2) → survey_abandoned(steps_completed=1)

survey_opened
  → survey_abandoned(steps_completed=0)

Resultados

report_cta_viewed → [toca CTA] → report_opened

Guia de dashboard en PostHog

Dashboard: “Home NPS - Survey Analytics”

Todas las insights deben filtrar por survey_type = "home-review".

Funnels

Completion Funnel
Card Conversion
Report Engagement

Survey Completion FunnelMide la conversion desde apertura hasta finalizacion del survey.

Ir a Insights → New → Funnels
Agregar pasos:
- home_nps_survey_opened
- home_nps_step_completed (filter: step_number = 1)
- home_nps_step_completed (filter: step_number = 2)
- …continuar por cada paso conocido
- home_nps_survey_completed
Breakdown by: entry_point
Conversion window: 7 dias
El drop-off entre cada paso muestra donde abandonan los usuarios

Home Card Conversion FunnelMide la efectividad del card en la home screen.

Insights → New → Funnels
Pasos:
- home_nps_survey_cta_viewed
- home_nps_survey_opened (filter: entry_point = "home")
- home_nps_survey_completed

Report Engagement FunnelMide cuantos usuarios ven el reporte despues de que se publican los resultados.

Insights → New → Funnels
Pasos:
- home_nps_report_cta_viewed
- home_nps_report_opened

Trends

Completion Rate
Abandonment
Entry Points

Tasa de completado

Insights → New → Trends
Serie A: home_nps_survey_completed (unique users)
Serie B: home_nps_survey_opened (unique users)
Activar Formula mode: A / B
Display: Line chart, granularidad diaria o semanal

Abandono por paso

Insights → New → Trends
Evento: home_nps_survey_abandoned
Breakdown by: steps_completed
Display: Bar chart
Muestra en que punto los usuarios deciden abandonar

Distribucion de entry points

Insights → New → Trends
Evento: home_nps_survey_opened
Breakdown by: entry_point
Display: Pie chart
Responde: cual es el entry point mas efectivo?

Number Insights (KPIs)

Crear 3 Number insights para la fila superior del dashboard:

KPI	Configuracion en PostHog
Tasa de completado	Formula: A (`survey_completed`, unique users) / B (`survey_opened`, unique users)
Tasa de apertura reporte	Formula: A (`report_opened`) / B (`report_cta_viewed`)
Promedio pasos antes de abandonar	`survey_abandoned` → Aggregation: Property average → `steps_completed`

Layout del dashboard

Organizar en filas:

Fila superior: 3 Number insights (KPIs principales)
Segunda fila: Survey Completion Funnel (ancho completo)
Tercera fila: Card Conversion (izq) + Report Engagement (der)
Cuarta fila: Entry Point Distribution (izq) + Abandonment by Step (der)

Joining con Data Warehouse

Los eventos envian survey_id y step_id (= question.id del backend). Para cruzar con datos backend:

SELECT
  ph.step_id,
  sq.label,
  ph.step_type,
  COUNT(*) as completions,
  SUM(CASE WHEN ph.has_optional_comment THEN 1 ELSE 0 END) as with_comment
FROM posthog_events ph
JOIN survey_questions sq ON sq.id = ph.step_id
WHERE ph.event = 'home_nps_step_completed'
  AND ph.survey_id = '<survey_id>'
GROUP BY ph.step_id, sq.label, ph.step_type
ORDER BY completions DESC;

Archivos de implementacion

Archivo	Eventos
`src/core/analytics/events.ts`	Constantes `analyticsEvents.homeNps.*`
`src/modules/home/components/HomeReviewCard.tsx`	`survey_cta_viewed`
`src/modules/home/components/HomeReviewResultsCard.tsx`	`report_cta_viewed`, `report_opened`
`src/modules/surveys/components/SurveyScreen.tsx`	`survey_opened`, `abandoned`, `completed`, `step_completed`
`src/modules/surveys/hooks/useSurveyEngine.ts`	Callback `onStepCompleted`

Overview

Architecture

Modules

Shared

Integrations

Guides

Home NPS - Eventos PostHog

Resumen

Propiedades base

Catalogo de eventos

1. `home_nps_survey_cta_viewed`

2. `home_nps_survey_opened`

3. `home_nps_step_completed`

4. `home_nps_survey_abandoned`

5. `home_nps_survey_completed`

6. `home_nps_report_cta_viewed`

7. `home_nps_report_opened`

Diagramas de flujo

Entry points

Flujo del survey

Resultados

Guia de dashboard en PostHog

Dashboard: “Home NPS - Survey Analytics”

Funnels

Trends

Number Insights (KPIs)

Layout del dashboard

Joining con Data Warehouse

Archivos de implementacion

Checklist de verificacion

​Resumen

​Propiedades base

​Catalogo de eventos

​1. home_nps_survey_cta_viewed

​2. home_nps_survey_opened

​3. home_nps_step_completed

​4. home_nps_survey_abandoned

​5. home_nps_survey_completed

​6. home_nps_report_cta_viewed

​7. home_nps_report_opened

​Diagramas de flujo

​Entry points

​Flujo del survey

​Resultados

​Guia de dashboard en PostHog

​Dashboard: “Home NPS - Survey Analytics”

​Funnels

​Trends

​Number Insights (KPIs)

​Layout del dashboard

​Joining con Data Warehouse

​Archivos de implementacion

​Checklist de verificacion

Resumen

Propiedades base

Catalogo de eventos

1. `home_nps_survey_cta_viewed`

2. `home_nps_survey_opened`

3. `home_nps_step_completed`

4. `home_nps_survey_abandoned`

5. `home_nps_survey_completed`

6. `home_nps_report_cta_viewed`

7. `home_nps_report_opened`

Diagramas de flujo

Entry points

Flujo del survey

Resultados

Guia de dashboard en PostHog

Dashboard: “Home NPS - Survey Analytics”

Funnels

Trends

Number Insights (KPIs)

Layout del dashboard

Joining con Data Warehouse

Archivos de implementacion

Checklist de verificacion