cdp-edge 2.2.1 → 2.2.2

package/extracted-skill/tracking-events-generator/agents/page-analyzer.md

@@ -26,6 +26,9 @@ Toda a sua análise deve ser baseada na infraestrutura nativa da Cloudflare.
 | Página de obrigado | `Purchase_Success` | 🔴 crítico |
 | **Preço Formatado (R$, $, €)** | `value_extraction` (Atrelado ao CTA) | 🔴 crítico |
 | **Campo de Formulário Oculto (CSS hide/opacity 0)** | `honeypot_field` | 🔴 crítico |
+| **[IMÓVEIS] Mapa / botão "Ver localização" / iframe Google Maps** | `FindLocation` | 🔴 crítico imobiliário |
+| **[IMÓVEIS] Simulador de financiamento / parcelas / FGTS / Caixa** | `CustomizeProduct` | 🔴 crítico imobiliário |
+| **[IMÓVEIS] Botão "Favoritar" / ícone de coração / "Salvar imóvel"** | `AddToWishlist` | 🟡 essencial imobiliário |
 | **Aparecimento de Botão Atrasado (Timer)** | `pitch_seen` | 🟡 essencial |
 | **Classe de Erro CSS (.error, .invalid)** | `form_error_detected` | 🟡 essencial |
 | **Micro-Evento: Rage Click** | `rage_click` | 🟡 essencial |
@@ -39,8 +42,9 @@ Toda a sua análise deve ser baseada na infraestrutura nativa da Cloudflare.
 Antes de mapear elementos, identifique o **modelo de negócio** da página para ativar protocolos específicos:
 
 1.  **Lançamento Imobiliário**:
-    *   Sinais: Galeria de fotos de imóveis, botões WhatsApp, formulário curto, mapas.
-    *   Protocolo: Ativar `geolocation` e `lead_lock_whatsapp`.
+    *   Sinais: Galeria de fotos de imóveis, botões WhatsApp, formulário curto, mapas, simulador de financiamento, botão favoritar, calendário de agendamento, tour 360°.
+    *   Protocolo: Ativar `geolocation`, `lead_lock_whatsapp`, `real_estate_events`.
+    *   Eventos obrigatórios extras: `FindLocation` (mapa/localização), `CustomizeProduct` (simulação financiamento), `AddToWishlist` (favoritar), `Schedule` (agendamento de visita), `Contact` (WhatsApp/telefone), `video_25/50/75/complete` (tour virtual/VSL).
 2.  **Página de Vendas (Infoproduto)**:
     *   Sinais: Botões Hotmart/Kiwify/Ticto, Vídeo (VSL), Depoimentos, Preço.
     *   Protocolo: Ativar `checkout_passthrough` e `vsl_retention`.

package/extracted-skill/tracking-events-generator/models/lancamento-imobiliario.md

@@ -0,0 +1,344 @@
+# Modelo: Lançamento Imobiliário (Cloudflare Native)
+
+Template para páginas de lançamento imobiliário com formulário de interesse, galeria, mapa/localização, simulador de financiamento, vídeo de tour, calendário de agendamento e botão WhatsApp.
+
+---
+
+## 🏗️ ARQUITETURA TÉCNICA (Quantum Tier)
+
+```
+Browser (cdpTrack.js)
+  ├─ PageView              → ao carregar
+  ├─ ViewContent           → ao entrar na galeria
+  ├─ FindLocation          → ao interagir com mapa/localização
+  ├─ video_25/50/75/complete → ao assistir tour virtual
+  ├─ CustomizeProduct      → ao usar simulador de financiamento
+  ├─ AddToWishlist         → ao favoritar imóvel
+  ├─ Contact               → ao clicar em WhatsApp/telefone
+  ├─ Schedule              → ao confirmar agendamento de visita
+  └─ Lead                  → ao enviar formulário (PII completo)
+        │
+        ▼
+  Cloudflare Worker (same-domain /track)
+    ├─ Fraud Gate
+    ├─ LTV Prediction (Granite 4.0 Micro) + score por eventType
+    ├─ D1: upsertProfile, identity graph, distanceKm
+    └─ CAPI dispatch: Meta v22.0 + GA4 + TikTok v1.3
+```
+
+---
+
+## 📘 MAPA DE EVENTOS
+
+| Evento | Gatilho | Sinal para as plataformas |
+|---|---|---|
+| `PageView` | Carregamento | Topo do funil |
+| `ViewContent` | Entra na galeria de fotos | Interesse no produto |
+| `FindLocation` | Clica em mapa / "Como chegar" / abre localização | Intenção de visita física — +10 LTV |
+| `video_25` / `video_50` / `video_75` / `video_complete` | Tour virtual / VSL em % assistido | Engajamento profundo |
+| `CustomizeProduct` | Usa simulador de financiamento/parcelas/FGTS | Intenção de compra máxima — +15 LTV |
+| `AddToWishlist` | Clica em "Favoritar" / coração | Interesse persistente — +8 LTV |
+| `Contact` | Clica em WhatsApp ou telefone | Alta intenção de contato |
+| `Schedule` | Confirma agendamento de visita | Conversão de visita |
+| `Lead` | Envia formulário (nome/email/telefone) | Conversão principal com PII |
+
+---
+
+## 🛠️ PASSO 1: CONFIGURAÇÃO DO SDK
+
+### 1.1 Header
+```html
+<script src="/js/cdpTrack.js" async></script>
+<script>
+  window.cdpConfig = {
+    metaId: 'SEU_PIXEL_ID',
+    ttId: 'SEU_TIKTOK_ID',
+    trackEndpoint: '/track'
+  };
+</script>
+```
+
+---
+
+## 🛠️ PASSO 2: EVENTOS DE COMPORTAMENTO
+
+### 2.1 PageView (automático via SDK)
+O SDK dispara automaticamente. Não precisa de código adicional.
+
+---
+
+### 2.2 ViewContent — Galeria de fotos
+```javascript
+// Dispara quando usuário abre/rola a galeria de imagens
+document.querySelector('.galeria-imovel, [data-section="gallery"]')?.addEventListener('click', () => {
+  cdpTrack.track('ViewContent', {
+    contentName: 'Galeria — [NOME DO EMPREENDIMENTO]',
+    contentCategory: 'imovel',
+    funnel_stage: 'gallery_view',
+  });
+});
+```
+
+---
+
+### 2.3 FindLocation — Mapa / Localização
+```javascript
+// Dispara quando usuário clica no mapa, "Como chegar" ou "Ver localização"
+document.querySelectorAll(
+  'a[href*="maps"], a[href*="waze"], [data-section="localizacao"], #mapa, .btn-localizacao, .btn-como-chegar'
+).forEach(el => {
+  el.addEventListener('click', () => {
+    cdpTrack.track('FindLocation', {
+      contentName: 'Localização — [NOME DO EMPREENDIMENTO]',
+      contentCategory: 'imovel',
+      funnel_stage: 'map_view',
+      // Coordenadas do empreendimento (preencher):
+      property_lat: -23.5505,   // latitude
+      property_lng: -46.6333,   // longitude
+    });
+  });
+});
+```
+
+---
+
+### 2.4 Vídeo / Tour Virtual
+```javascript
+// Para vídeo HTML5 nativo:
+const video = document.querySelector('video#tour-virtual, video.tour-360');
+if (video) {
+  const fired = new Set();
+  video.addEventListener('timeupdate', () => {
+    const pct = Math.floor((video.currentTime / video.duration) * 100);
+    if (pct >= 25 && !fired.has(25)) {
+      fired.add(25);
+      cdpTrack.track('video_25', { contentName: 'Tour Virtual — [NOME DO EMPREENDIMENTO]' });
+    }
+    if (pct >= 50 && !fired.has(50)) {
+      fired.add(50);
+      cdpTrack.track('video_50', { contentName: 'Tour Virtual — [NOME DO EMPREENDIMENTO]' });
+    }
+    if (pct >= 75 && !fired.has(75)) {
+      fired.add(75);
+      cdpTrack.track('video_75', { contentName: 'Tour Virtual — [NOME DO EMPREENDIMENTO]' });
+    }
+  });
+  video.addEventListener('ended', () => {
+    cdpTrack.track('video_complete', { contentName: 'Tour Virtual — [NOME DO EMPREENDIMENTO]' });
+  });
+}
+
+// Para YouTube embed (via YouTube API):
+// Adicionar ?enablejsapi=1 na URL do iframe e usar onStateChange
+// Ver: https://developers.google.com/youtube/iframe_api_reference
+```
+
+---
+
+### 2.5 CustomizeProduct — Simulador de Financiamento
+```javascript
+// Dispara quando usuário interage com o simulador de parcelas/FGTS/Caixa
+const simulador = document.querySelector(
+  '#simulador, .simulador-financiamento, [data-section="simulacao"], form.simulador'
+);
+
+if (simulador) {
+  // Dispara ao 1º interact (foco em qualquer campo do simulador)
+  let simuladorFired = false;
+  simulador.addEventListener('focusin', () => {
+    if (simuladorFired) return;
+    simuladorFired = true;
+    cdpTrack.track('CustomizeProduct', {
+      contentName: 'Simulador de Financiamento — [NOME DO EMPREENDIMENTO]',
+      contentCategory: 'imovel',
+      funnel_stage: 'financing_simulation',
+      intentionLevel: 'comprador',
+    });
+  });
+
+  // Dispara também ao clicar em "Simular" / "Calcular"
+  simulador.querySelector('button[type="submit"], .btn-simular, .btn-calcular')?.addEventListener('click', () => {
+    const valorImovel = simulador.querySelector('input[name="valor"], #valor-imovel')?.value;
+    cdpTrack.track('CustomizeProduct', {
+      contentName: 'Simulação Concluída — [NOME DO EMPREENDIMENTO]',
+      contentCategory: 'imovel',
+      funnel_stage: 'financing_simulation',
+      intentionLevel: 'comprador',
+      value: valorImovel ? parseFloat(valorImovel.replace(/\D/g, '')) : undefined,
+      currency: 'BRL',
+    });
+  });
+}
+```
+
+---
+
+### 2.6 AddToWishlist — Favoritar Imóvel
+```javascript
+// Dispara quando usuário clica em favoritar / ícone de coração
+document.querySelectorAll('.btn-favoritar, .icon-heart, [data-action="favoritar"], .favorito').forEach(el => {
+  el.addEventListener('click', () => {
+    cdpTrack.track('AddToWishlist', {
+      contentName: '[NOME DO EMPREENDIMENTO]',
+      contentCategory: 'imovel',
+      funnel_stage: 'wishlist',
+    });
+  });
+});
+```
+
+---
+
+### 2.7 Contact — WhatsApp / Telefone
+```javascript
+// WhatsApp
+document.querySelectorAll('a[href*="wa.me"], a[href*="whatsapp.com"], .btn-whatsapp').forEach(el => {
+  el.addEventListener('click', () => {
+    cdpTrack.track('Contact', {
+      contentName: 'WhatsApp — [NOME DO EMPREENDIMENTO]',
+      contentCategory: 'imovel_whatsapp',
+      funnel_stage: 'whatsapp_click',
+      intentionLevel: 'comprador',
+    });
+  });
+});
+
+// Telefone
+document.querySelectorAll('a[href^="tel:"], .btn-ligar, .btn-telefone').forEach(el => {
+  el.addEventListener('click', () => {
+    cdpTrack.track('Contact', {
+      contentName: 'Telefone — [NOME DO EMPREENDIMENTO]',
+      contentCategory: 'imovel_telefone',
+      funnel_stage: 'phone_click',
+      intentionLevel: 'comprador',
+    });
+  });
+});
+```
+
+---
+
+### 2.8 Schedule — Calendário de Agendamento de Visita
+```javascript
+// Dispara quando usuário CONFIRMA o agendamento (não ao abrir o calendário)
+// Adaptar ao provider: Calendly, Google Calendar, formulário próprio
+
+// Exemplo com Calendly:
+window.addEventListener('message', (e) => {
+  if (e.data?.event === 'calendly.event_scheduled') {
+    cdpTrack.track('Schedule', {
+      contentName: 'Visita Agendada — [NOME DO EMPREENDIMENTO]',
+      contentCategory: 'imovel',
+      funnel_stage: 'schedule_confirmed',
+      intentionLevel: 'comprador',
+      // Dados do lead do Calendly (se disponíveis via payload):
+      email: e.data?.payload?.invitee?.email,
+      firstName: e.data?.payload?.invitee?.first_name,
+    });
+  }
+});
+
+// Exemplo com formulário próprio de agendamento:
+document.querySelector('#form-agendamento')?.addEventListener('submit', async (e) => {
+  e.preventDefault();
+  const data = new FormData(e.target);
+  await cdpTrack.track('Schedule', {
+    contentName: 'Visita Agendada — [NOME DO EMPREENDIMENTO]',
+    contentCategory: 'imovel',
+    funnel_stage: 'schedule_confirmed',
+    intentionLevel: 'comprador',
+    email: data.get('email'),
+    phone: data.get('phone'),
+    firstName: data.get('nome')?.split(' ')[0],
+  });
+  e.target.submit();
+});
+```
+
+---
+
+### 2.9 Lead — Formulário Principal de Interesse
+```javascript
+document.querySelector('#form-interesse, #form-lead, form.form-contato')?.addEventListener('submit', async (e) => {
+  e.preventDefault();
+
+  await cdpTrack.track('Lead', {
+    // PII — enviados hasheados pelo Worker
+    email:     e.target.email?.value?.trim(),
+    phone:     e.target.phone?.value?.trim() || e.target.telefone?.value?.trim(),
+    firstName: e.target.nome?.value?.split(' ')[0]?.trim(),
+    lastName:  e.target.nome?.value?.split(' ').slice(1).join(' ')?.trim(),
+
+    // Contexto
+    contentName:     '[NOME DO EMPREENDIMENTO]',
+    contentCategory: 'imovel',
+    intentionLevel:  'comprador',
+    funnel_stage:    'lead_form',
+
+    // UTMs capturados pelo SDK automaticamente
+    // Coordenadas do imóvel para distância geoespacial no Worker:
+    property_lat: -23.5505,
+    property_lng: -46.6333,
+  });
+
+  // Redirecionar para obrigado
+  window.location.href = '/obrigado';
+});
+```
+
+---
+
+## 📊 LTV por Evento — O que o Worker calcula
+
+| Evento | Bonus LTV Score | Multiplicador Valor |
+|---|---|---|
+| `Lead` (utm_source=facebook, intention=comprador) | ~65–80 pts | 3.5× → **High** |
+| `CustomizeProduct` | +15 pts automático | Score sobe para High |
+| `FindLocation` | +10 pts automático | Puxa Medium → High |
+| `AddToWishlist` | +8 pts automático | Sinal de retargeting |
+| `Schedule` (visita confirmada) | intention=comprador → +20 pts | Máximo High |
+| `Contact` (WhatsApp) | Sem LTV (evento de sinal) | — |
+
+---
+
+## 🔄 FLUXO COMPLETO DO LEAD IMOBILIÁRIO
+
+```
+Usuário chega na landing
+  │
+  ├─ PageView → sinal de alcance
+  ├─ ViewContent (galeria) → interesse qualificado
+  ├─ video_50 (tour) → engajamento profundo
+  ├─ FindLocation (mapa) → intenção de visita física (+10 LTV)
+  ├─ CustomizeProduct (simulador) → intenção máxima (+15 LTV)
+  ├─ Contact (WhatsApp) → ação de contato
+  ├─ Schedule (agendamento) → visita confirmada
+  └─ Lead (formulário) → conversão principal
+        │
+        ▼
+  Worker: LTV score ~75-90 → High → valor 3.5× injetado
+        │
+        ▼
+  Meta CAPI + GA4 + TikTok recebem Lead com value=R$689
+        │
+        ▼
+  Algoritmo de Meta aprende a buscar mais leads de alto valor
+```
+
+---
+
+## 📋 CHECKLIST DE IMPLEMENTAÇÃO
+
+- [ ] SDK `cdpTrack.js` carregando no `<head>`
+- [ ] `PageView` disparando (automático)
+- [ ] `ViewContent` na galeria
+- [ ] `FindLocation` no mapa e botão "Como chegar"
+- [ ] Vídeo/tour instrumentado (`video_25`, `video_75`, `video_complete`)
+- [ ] `CustomizeProduct` no simulador de financiamento
+- [ ] `AddToWishlist` no botão de favoritar
+- [ ] `Contact` nos botões de WhatsApp e telefone
+- [ ] `Schedule` no calendário (Calendly ou formulário próprio)
+- [ ] `Lead` no formulário principal com PII e `property_lat/lng`
+- [ ] Verificar `/health` retornando `d1: ok, kv: ok, ai: ok`
+- [ ] Testar evento `Lead` no Meta Events Manager → Test Events
+- [ ] Confirmar LTV na resposta JSON do `/track` (`class: "High"`)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cdp-edge",
-  "version": "2.2.1",
+  "version": "2.2.2",
   "description": "CDP Edge - Quantum Tracking - Sistema multi-agente para tracking digital Cloudflare Native (Workers + D1)",
   "main": "dist/index.js",
   "type": "module",

package/server-edge-tracker/modules/ml/ltv.js

@@ -100,6 +100,12 @@ export async function predictLtv(env, payload, request, customSystemPrompt = nul
   if (payload.phone) score += 4;
   if (payload.firstName) score += 2;
 
+  // 5b. Tipo de evento imobiliário (0–15) — sinais de intenção de compra física
+  const evType = (payload.eventType || '').toLowerCase();
+  if (evType === 'customizeproduct') score += 15; // simulação de financiamento → intenção máxima
+  else if (evType === 'findlocation')  score += 10; // viu mapa/localização → visita física iminente
+  else if (evType === 'addtowishlist') score += 8;  // favoritou → interesse persistente
+
   // 6. Proximidade ao imóvel físico (0–15) — apenas quando distância calculada
   const distKm = parseFloat(payload.distanceKm ?? payload.user_distance_km ?? -1);
   if (distKm >= 0) {

package/server-edge-tracker/modules/utils.js

@@ -86,14 +86,16 @@ export const VALID_EVENT_NAMES = new Set([
   'AddToCart','CompleteRegistration','Contact','Schedule',
   'StartTrial','Subscribe','SubmitApplication','Search',
   'video_start','video_25','video_50','video_75','video_complete',
+  // Imóveis — intenção de visita física, financiamento e favoritar
+  'FindLocation','CustomizeProduct','AddToWishlist',
 ]);
 
 // ── Taxonomia de funil (funnel_stage → profundidade semântica) ────────────────
 // Fonte de verdade para interpretar funnel_stage em qualquer ponto do sistema.
 export const FUNNEL_TAXONOMY = {
-  top:        ['scroll_50', 'time_30s', 'page_view', 'gallery_view'],
-  mid:        ['map_view', 'gallery_click', 'price_hover', 'time_3min'],
-  bottom:     ['route_click', 'whatsapp_click', 'cta_hover'],
+  top:        ['scroll_50', 'time_30s', 'page_view', 'gallery_view', 'AddToWishlist'],
+  mid:        ['map_view', 'gallery_click', 'price_hover', 'time_3min', 'FindLocation'],
+  bottom:     ['route_click', 'whatsapp_click', 'cta_hover', 'CustomizeProduct'],
   conversion: ['schedule_confirmed', 'lead_form', 'purchase', 'visit_booked'],
 };
 

package/server-edge-tracker/worker.js

@@ -1867,6 +1867,12 @@ async function predictLtv(env, payload, request, customSystemPrompt = null) {
   if (payload.phone) score += 4;
   if (payload.firstName) score += 2;
 
+  // 5b. Tipo de evento imobiliário (0–15) — sinais de intenção de compra física
+  const evType = (payload.eventType || '').toLowerCase();
+  if (evType === 'customizeproduct') score += 15; // simulação de financiamento → intenção máxima
+  else if (evType === 'findlocation')  score += 10; // viu mapa/localização → visita física iminente
+  else if (evType === 'addtowishlist') score += 8;  // favoritou → interesse persistente
+
   score = Math.min(100, score);
 
   // Classificação
@@ -1901,6 +1907,7 @@ async function predictLtv(env, payload, request, customSystemPrompt = null) {
           country,
           has_email: !!payload.email,
           has_phone: !!payload.phone,
+          event_type: payload.eventType || null,
         })},
       ];
       const aiRes = await env.AI.run('@cf/ibm-granite/granite-4.0-h-micro', { messages: prompt, max_tokens: 32 });
@@ -3968,7 +3975,9 @@ export default {
         'PageView','ViewContent','Lead','Purchase','InitiateCheckout',
         'AddToCart','CompleteRegistration','Contact','Schedule',
         'StartTrial','Subscribe','SubmitApplication','Search',
-        'video_start','video_25','video_50','video_75','video_complete'
+        'video_start','video_25','video_50','video_75','video_complete',
+        // Imóveis — intenção de visita física, financiamento e favoritar
+        'FindLocation','CustomizeProduct','AddToWishlist',
       ]);
       const STR_FIELDS = ['email','phone','firstName','lastName','city','state','zip','userId',
                           'utmSource','utmMedium','utmCampaign','utmContent','utmTerm',
@@ -4075,8 +4084,9 @@ export default {
       // ── LTV Prediction (+ A/B Testing de Prompts) ────────────────────────────
       // Lead, Contact, Schedule: sem valor monetário real → injetar LTV preditivo
       // Isso treina os algoritmos de Meta/TikTok a priorizar leads de alto valor
-      const LTV_EVENTS = ['Lead', 'Contact', 'Schedule', 'CompleteRegistration'];
+      const LTV_EVENTS = ['Lead', 'Contact', 'Schedule', 'CompleteRegistration', 'FindLocation', 'CustomizeProduct', 'AddToWishlist'];
       if (LTV_EVENTS.includes(eventName) && !payload.value) {
+        payload.eventType = eventName; // expõe ao predictLtv para scoring por tipo de evento
         // A/B Testing: busca variação ativa (usa KV cache — ~0ms de latência extra)
         const abVariation = await getLtvAbVariation(env);
         const ltv = await predictLtv(env, payload, request, abVariation?.system_prompt || null);

package/server-edge-tracker/wrangler.toml

@@ -4,6 +4,7 @@ name = "server-edge-tracker"
 main = "index.js"
 compatibility_date = "2025-01-01"
 compatibility_flags = ["nodejs_compat"]
+workers_dev = true
 
 # ── Worker Routes — same-domain tracking (imune a bloqueios) ─────────────────
 # Substituir SEU_DOMINIO pelo domínio do cliente antes do deploy

package/templates/lancamento-imobiliario.md

@@ -0,0 +1,344 @@
+# Modelo: Lançamento Imobiliário (Cloudflare Native)
+
+Template para páginas de lançamento imobiliário com formulário de interesse, galeria, mapa/localização, simulador de financiamento, vídeo de tour, calendário de agendamento e botão WhatsApp.
+
+---
+
+## 🏗️ ARQUITETURA TÉCNICA (Quantum Tier)
+
+```
+Browser (cdpTrack.js)
+  ├─ PageView              → ao carregar
+  ├─ ViewContent           → ao entrar na galeria
+  ├─ FindLocation          → ao interagir com mapa/localização
+  ├─ video_25/50/75/complete → ao assistir tour virtual
+  ├─ CustomizeProduct      → ao usar simulador de financiamento
+  ├─ AddToWishlist         → ao favoritar imóvel
+  ├─ Contact               → ao clicar em WhatsApp/telefone
+  ├─ Schedule              → ao confirmar agendamento de visita
+  └─ Lead                  → ao enviar formulário (PII completo)
+        │
+        ▼
+  Cloudflare Worker (same-domain /track)
+    ├─ Fraud Gate
+    ├─ LTV Prediction (Granite 4.0 Micro) + score por eventType
+    ├─ D1: upsertProfile, identity graph, distanceKm
+    └─ CAPI dispatch: Meta v22.0 + GA4 + TikTok v1.3
+```
+
+---
+
+## 📘 MAPA DE EVENTOS
+
+| Evento | Gatilho | Sinal para as plataformas |
+|---|---|---|
+| `PageView` | Carregamento | Topo do funil |
+| `ViewContent` | Entra na galeria de fotos | Interesse no produto |
+| `FindLocation` | Clica em mapa / "Como chegar" / abre localização | Intenção de visita física — +10 LTV |
+| `video_25` / `video_50` / `video_75` / `video_complete` | Tour virtual / VSL em % assistido | Engajamento profundo |
+| `CustomizeProduct` | Usa simulador de financiamento/parcelas/FGTS | Intenção de compra máxima — +15 LTV |
+| `AddToWishlist` | Clica em "Favoritar" / coração | Interesse persistente — +8 LTV |
+| `Contact` | Clica em WhatsApp ou telefone | Alta intenção de contato |
+| `Schedule` | Confirma agendamento de visita | Conversão de visita |
+| `Lead` | Envia formulário (nome/email/telefone) | Conversão principal com PII |
+
+---
+
+## 🛠️ PASSO 1: CONFIGURAÇÃO DO SDK
+
+### 1.1 Header
+```html
+<script src="/js/cdpTrack.js" async></script>
+<script>
+  window.cdpConfig = {
+    metaId: 'SEU_PIXEL_ID',
+    ttId: 'SEU_TIKTOK_ID',
+    trackEndpoint: '/track'
+  };
+</script>
+```
+
+---
+
+## 🛠️ PASSO 2: EVENTOS DE COMPORTAMENTO
+
+### 2.1 PageView (automático via SDK)
+O SDK dispara automaticamente. Não precisa de código adicional.
+
+---
+
+### 2.2 ViewContent — Galeria de fotos
+```javascript
+// Dispara quando usuário abre/rola a galeria de imagens
+document.querySelector('.galeria-imovel, [data-section="gallery"]')?.addEventListener('click', () => {
+  cdpTrack.track('ViewContent', {
+    contentName: 'Galeria — [NOME DO EMPREENDIMENTO]',
+    contentCategory: 'imovel',
+    funnel_stage: 'gallery_view',
+  });
+});
+```
+
+---
+
+### 2.3 FindLocation — Mapa / Localização
+```javascript
+// Dispara quando usuário clica no mapa, "Como chegar" ou "Ver localização"
+document.querySelectorAll(
+  'a[href*="maps"], a[href*="waze"], [data-section="localizacao"], #mapa, .btn-localizacao, .btn-como-chegar'
+).forEach(el => {
+  el.addEventListener('click', () => {
+    cdpTrack.track('FindLocation', {
+      contentName: 'Localização — [NOME DO EMPREENDIMENTO]',
+      contentCategory: 'imovel',
+      funnel_stage: 'map_view',
+      // Coordenadas do empreendimento (preencher):
+      property_lat: -23.5505,   // latitude
+      property_lng: -46.6333,   // longitude
+    });
+  });
+});
+```
+
+---
+
+### 2.4 Vídeo / Tour Virtual
+```javascript
+// Para vídeo HTML5 nativo:
+const video = document.querySelector('video#tour-virtual, video.tour-360');
+if (video) {
+  const fired = new Set();
+  video.addEventListener('timeupdate', () => {
+    const pct = Math.floor((video.currentTime / video.duration) * 100);
+    if (pct >= 25 && !fired.has(25)) {
+      fired.add(25);
+      cdpTrack.track('video_25', { contentName: 'Tour Virtual — [NOME DO EMPREENDIMENTO]' });
+    }
+    if (pct >= 50 && !fired.has(50)) {
+      fired.add(50);
+      cdpTrack.track('video_50', { contentName: 'Tour Virtual — [NOME DO EMPREENDIMENTO]' });
+    }
+    if (pct >= 75 && !fired.has(75)) {
+      fired.add(75);
+      cdpTrack.track('video_75', { contentName: 'Tour Virtual — [NOME DO EMPREENDIMENTO]' });
+    }
+  });
+  video.addEventListener('ended', () => {
+    cdpTrack.track('video_complete', { contentName: 'Tour Virtual — [NOME DO EMPREENDIMENTO]' });
+  });
+}
+
+// Para YouTube embed (via YouTube API):
+// Adicionar ?enablejsapi=1 na URL do iframe e usar onStateChange
+// Ver: https://developers.google.com/youtube/iframe_api_reference
+```
+
+---
+
+### 2.5 CustomizeProduct — Simulador de Financiamento
+```javascript
+// Dispara quando usuário interage com o simulador de parcelas/FGTS/Caixa
+const simulador = document.querySelector(
+  '#simulador, .simulador-financiamento, [data-section="simulacao"], form.simulador'
+);
+
+if (simulador) {
+  // Dispara ao 1º interact (foco em qualquer campo do simulador)
+  let simuladorFired = false;
+  simulador.addEventListener('focusin', () => {
+    if (simuladorFired) return;
+    simuladorFired = true;
+    cdpTrack.track('CustomizeProduct', {
+      contentName: 'Simulador de Financiamento — [NOME DO EMPREENDIMENTO]',
+      contentCategory: 'imovel',
+      funnel_stage: 'financing_simulation',
+      intentionLevel: 'comprador',
+    });
+  });
+
+  // Dispara também ao clicar em "Simular" / "Calcular"
+  simulador.querySelector('button[type="submit"], .btn-simular, .btn-calcular')?.addEventListener('click', () => {
+    const valorImovel = simulador.querySelector('input[name="valor"], #valor-imovel')?.value;
+    cdpTrack.track('CustomizeProduct', {
+      contentName: 'Simulação Concluída — [NOME DO EMPREENDIMENTO]',
+      contentCategory: 'imovel',
+      funnel_stage: 'financing_simulation',
+      intentionLevel: 'comprador',
+      value: valorImovel ? parseFloat(valorImovel.replace(/\D/g, '')) : undefined,
+      currency: 'BRL',
+    });
+  });
+}
+```
+
+---
+
+### 2.6 AddToWishlist — Favoritar Imóvel
+```javascript
+// Dispara quando usuário clica em favoritar / ícone de coração
+document.querySelectorAll('.btn-favoritar, .icon-heart, [data-action="favoritar"], .favorito').forEach(el => {
+  el.addEventListener('click', () => {
+    cdpTrack.track('AddToWishlist', {
+      contentName: '[NOME DO EMPREENDIMENTO]',
+      contentCategory: 'imovel',
+      funnel_stage: 'wishlist',
+    });
+  });
+});
+```
+
+---
+
+### 2.7 Contact — WhatsApp / Telefone
+```javascript
+// WhatsApp
+document.querySelectorAll('a[href*="wa.me"], a[href*="whatsapp.com"], .btn-whatsapp').forEach(el => {
+  el.addEventListener('click', () => {
+    cdpTrack.track('Contact', {
+      contentName: 'WhatsApp — [NOME DO EMPREENDIMENTO]',
+      contentCategory: 'imovel_whatsapp',
+      funnel_stage: 'whatsapp_click',
+      intentionLevel: 'comprador',
+    });
+  });
+});
+
+// Telefone
+document.querySelectorAll('a[href^="tel:"], .btn-ligar, .btn-telefone').forEach(el => {
+  el.addEventListener('click', () => {
+    cdpTrack.track('Contact', {
+      contentName: 'Telefone — [NOME DO EMPREENDIMENTO]',
+      contentCategory: 'imovel_telefone',
+      funnel_stage: 'phone_click',
+      intentionLevel: 'comprador',
+    });
+  });
+});
+```
+
+---
+
+### 2.8 Schedule — Calendário de Agendamento de Visita
+```javascript
+// Dispara quando usuário CONFIRMA o agendamento (não ao abrir o calendário)
+// Adaptar ao provider: Calendly, Google Calendar, formulário próprio
+
+// Exemplo com Calendly:
+window.addEventListener('message', (e) => {
+  if (e.data?.event === 'calendly.event_scheduled') {
+    cdpTrack.track('Schedule', {
+      contentName: 'Visita Agendada — [NOME DO EMPREENDIMENTO]',
+      contentCategory: 'imovel',
+      funnel_stage: 'schedule_confirmed',
+      intentionLevel: 'comprador',
+      // Dados do lead do Calendly (se disponíveis via payload):
+      email: e.data?.payload?.invitee?.email,
+      firstName: e.data?.payload?.invitee?.first_name,
+    });
+  }
+});
+
+// Exemplo com formulário próprio de agendamento:
+document.querySelector('#form-agendamento')?.addEventListener('submit', async (e) => {
+  e.preventDefault();
+  const data = new FormData(e.target);
+  await cdpTrack.track('Schedule', {
+    contentName: 'Visita Agendada — [NOME DO EMPREENDIMENTO]',
+    contentCategory: 'imovel',
+    funnel_stage: 'schedule_confirmed',
+    intentionLevel: 'comprador',
+    email: data.get('email'),
+    phone: data.get('phone'),
+    firstName: data.get('nome')?.split(' ')[0],
+  });
+  e.target.submit();
+});
+```
+
+---
+
+### 2.9 Lead — Formulário Principal de Interesse
+```javascript
+document.querySelector('#form-interesse, #form-lead, form.form-contato')?.addEventListener('submit', async (e) => {
+  e.preventDefault();
+
+  await cdpTrack.track('Lead', {
+    // PII — enviados hasheados pelo Worker
+    email:     e.target.email?.value?.trim(),
+    phone:     e.target.phone?.value?.trim() || e.target.telefone?.value?.trim(),
+    firstName: e.target.nome?.value?.split(' ')[0]?.trim(),
+    lastName:  e.target.nome?.value?.split(' ').slice(1).join(' ')?.trim(),
+
+    // Contexto
+    contentName:     '[NOME DO EMPREENDIMENTO]',
+    contentCategory: 'imovel',
+    intentionLevel:  'comprador',
+    funnel_stage:    'lead_form',
+
+    // UTMs capturados pelo SDK automaticamente
+    // Coordenadas do imóvel para distância geoespacial no Worker:
+    property_lat: -23.5505,
+    property_lng: -46.6333,
+  });
+
+  // Redirecionar para obrigado
+  window.location.href = '/obrigado';
+});
+```
+
+---
+
+## 📊 LTV por Evento — O que o Worker calcula
+
+| Evento | Bonus LTV Score | Multiplicador Valor |
+|---|---|---|
+| `Lead` (utm_source=facebook, intention=comprador) | ~65–80 pts | 3.5× → **High** |
+| `CustomizeProduct` | +15 pts automático | Score sobe para High |
+| `FindLocation` | +10 pts automático | Puxa Medium → High |
+| `AddToWishlist` | +8 pts automático | Sinal de retargeting |
+| `Schedule` (visita confirmada) | intention=comprador → +20 pts | Máximo High |
+| `Contact` (WhatsApp) | Sem LTV (evento de sinal) | — |
+
+---
+
+## 🔄 FLUXO COMPLETO DO LEAD IMOBILIÁRIO
+
+```
+Usuário chega na landing
+  │
+  ├─ PageView → sinal de alcance
+  ├─ ViewContent (galeria) → interesse qualificado
+  ├─ video_50 (tour) → engajamento profundo
+  ├─ FindLocation (mapa) → intenção de visita física (+10 LTV)
+  ├─ CustomizeProduct (simulador) → intenção máxima (+15 LTV)
+  ├─ Contact (WhatsApp) → ação de contato
+  ├─ Schedule (agendamento) → visita confirmada
+  └─ Lead (formulário) → conversão principal
+        │
+        ▼
+  Worker: LTV score ~75-90 → High → valor 3.5× injetado
+        │
+        ▼
+  Meta CAPI + GA4 + TikTok recebem Lead com value=R$689
+        │
+        ▼
+  Algoritmo de Meta aprende a buscar mais leads de alto valor
+```
+
+---
+
+## 📋 CHECKLIST DE IMPLEMENTAÇÃO
+
+- [ ] SDK `cdpTrack.js` carregando no `<head>`
+- [ ] `PageView` disparando (automático)
+- [ ] `ViewContent` na galeria
+- [ ] `FindLocation` no mapa e botão "Como chegar"
+- [ ] Vídeo/tour instrumentado (`video_25`, `video_75`, `video_complete`)
+- [ ] `CustomizeProduct` no simulador de financiamento
+- [ ] `AddToWishlist` no botão de favoritar
+- [ ] `Contact` nos botões de WhatsApp e telefone
+- [ ] `Schedule` no calendário (Calendly ou formulário próprio)
+- [ ] `Lead` no formulário principal com PII e `property_lat/lng`
+- [ ] Verificar `/health` retornando `d1: ok, kv: ok, ai: ok`
+- [ ] Testar evento `Lead` no Meta Events Manager → Test Events
+- [ ] Confirmar LTV na resposta JSON do `/track` (`class: "High"`)