Tracking

O objetivo é medir toda a jornada do usuário ao ativar um template com ou sem plano/cupom, sem eventos desnecessários.

Escopo

Eventos implementados:

• template_install_click - Clique no botão instalar
• template_signup_complete - Conclusão com sucesso
• Auth Registration: auth_register_start, auth_register_success, auth_register_failure
• Auth Login: auth_login_start, auth_login_success, auth_login_failure
• Auth Instagram: auth_instagram_start, auth_instagram_success, auth_instagram_failure
• Profile: profile_completed - Conclusão do perfil
• Consent: consent_accepted - Aceitação de compartilhamento
• Checkout: checkout_viewed, checkout_submitted, checkout_completed, checkout_error

Propriedades comuns

Todos os eventos incluem, quando disponíveis:

• template_id - ID único do template
• template_slug - Slug amigável do template
• plan_id - ID do plano (se aplicável)
• amount_in_cents - Valor do plano em centavos
• coupon_id - ID do cupom (se aplicável)
• percent_off - Percentual de desconto do cupom
• duration_in_months - Duração do desconto em meses
• applies_first_month_only - Se o desconto aplica apenas ao primeiro mês

Nota: O funnel_session_id (PostHog session) é gerenciado automaticamente pelo SDK

Eventos e payloads

Eventos do Funil Principal

template_install_click

Disparado quando o usuário clica no botão instalar.

interface TemplateInstallClickEvent {
  template_id: string;
  template_slug: string;
  plan_id?: string;
  coupon_id?: string;
  amount_in_cents?: number;
}

template_form_start

Disparado quando o usuário inicia o preenchimento do formulário de perfil.

interface TemplateFormStartEvent {
  template_id: string;
  template_slug: string;
  plan_id?: string;
  coupon_id?: string;
}

template_form_drop

Disparado quando o usuário abandona o funil (inatividade ou navegação para fora).

interface TemplateFormDropEvent {
  template_id: string;
  template_slug: string;
  plan_id?: string;
  coupon_id?: string;
  abandonment_point: 'account' | 'contact' | 'wizard_profile' | 'wizard_discovery' | 'activation';
}

template_signup_complete

Disparado quando o usuário chega na página de sucesso após ativação.

interface TemplateSignupCompleteEvent {
  template_id: string;
  template_slug: string;
  plan_id?: string;
  coupon_id?: string;
  amount_in_cents?: number;
}

---

Eventos de Autenticação

Todos os eventos de auth seguem o padrão: auth_{method}_{outcome} onde:

• method: register, login, instagram
• outcome: start, success, failure

auth_register_start / auth_register_success / auth_register_failure

interface AuthRegisterEvent {
  auth_method: 'registration';
  template_id?: string;
  template_slug?: string;
  error_code?: string;      // apenas em failure
  error_message?: string;   // apenas em failure
}

auth_login_start / auth_login_success / auth_login_failure

interface AuthLoginEvent {
  auth_method: 'login';
  template_id?: string;
  template_slug?: string;
  error_code?: string;      // apenas em failure
  error_message?: string;   // apenas em failure
}

auth_instagram_start / auth_instagram_success / auth_instagram_failure

interface AuthInstagramEvent {
  auth_method: 'instagram';
  template_id?: string;
  template_slug?: string;
  error_code?: string;      // apenas em failure
  error_message?: string;   // apenas em failure
}

---

Eventos de Community Modal

community_modal_view

Disparado quando o modal de preview é aberto ou fechado.

interface CommunityModalViewEvent {
  template_id: string;
  template_slug: string;
  modal_state: 'open' | 'close';
}

community_modal_install_click

Disparado quando o usuário clica em instalar dentro do modal da comunidade.

interface CommunityModalInstallClickEvent {
  template_id: string;
  template_slug: string;
  plan_id?: string;
  coupon_id?: string;
}

Tracking por Pageviews

Para medir churn entre etapas do funil, use pageviews automáticos do PostHog ao invés de eventos customizados:

URLs do Funil

• Auth: /t/{slug}/install - Página de autenticação
• Profile: /t/{slug}/install/profile - Página de perfil
• Consent: /t/{slug}/install/consent - Página de consentimento
• Checkout: /t/{slug}/install/checkout - Página de checkout
• Success: /t/{slug}/install/success - Página de sucesso

Insights Baseados em Pageviews

1. Funil Completo por Páginas - Mede conversão Auth → Profile → Consent → Checkout → Success
2. Pageviews por Etapa - Tendência - Compara volume de cada etapa ao longo do tempo
3. Churn entre Etapas - Diferença entre pageviews consecutivas identifica abandono

Vantagens:

• Sem código adicional (autocapture do PostHog)
• Tempo médio entre etapas calculado automaticamente
• Sessões rastreadas automaticamente
• Menos eventos customizados = menos manutenção