cdp-edge 2.2.0 → 2.2.2

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.0",
+  "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/index.js

@@ -191,7 +191,7 @@ export default {
       }
 
       try {
-        await env.AI.run('@cf/meta/llama-3.1-8b-instruct', {
+        await env.AI.run('@cf/ibm-granite/granite-4.0-h-micro', {
           messages: [{ role: 'user', content: 'ping' }],
           max_tokens: 1,
         });

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

@@ -6,13 +6,6 @@
 import { sha256, tryParseJson } from '../utils.js';
 
 // ── Listas de detecção ────────────────────────────────────────────────────────
-export const DISPOSABLE_EMAIL_DOMAINS = new Set([
-  'mailinator.com','guerrillamail.com','tempmail.com','throwaway.email',
-  'yopmail.com','sharklasers.com','guerrillamailblock.com','spam4.me',
-  '10minutemail.com','trashmail.com','maildrop.cc','fakeinbox.com',
-  'dispostable.com','getairmail.com','mailnull.com',
-]);
-
 export const DATACENTER_PATTERNS = /amazon|google|microsoft|digitalocean|linode|ovh|vultr|hetzner|contabo|cloudflare|packet|rackspace|leaseweb/i;
 
 // ── checkFraudGate — roda ANTES de qualquer processamento de evento ────────────
@@ -64,15 +57,7 @@ export async function checkFraudGate(env, request, payload) {
       result.score += 20; result.reasons.push('no_accept_language');
     }
 
-    // 6. Email descartável
-    if (email) {
-      const domain = email.split('@')[1]?.toLowerCase();
-      if (domain && DISPOSABLE_EMAIL_DOMAINS.has(domain)) {
-        result.score += 25; result.reasons.push('disposable_email');
-      }
-    }
-
-    // 7. Velocity check via KV
+    // 6. Velocity check via KV
     if (env.GEO_CACHE && ip) {
       const velKey1h = `fraud_velocity:${ip}:h`;
       const velStr   = await env.GEO_CACHE.get(velKey1h);

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) {
@@ -161,7 +167,7 @@ export async function predictLtv(env, payload, request, customSystemPrompt = nul
         { role: 'system', content: systemContent },
         { role: 'user', content: JSON.stringify(userContext) },
       ];
-      const aiRes = await env.AI.run('@cf/meta/llama-3.1-8b-instruct', { messages: prompt, max_tokens: 32 });
+      const aiRes = await env.AI.run('@cf/ibm-granite/granite-4.0-h-micro', { messages: prompt, max_tokens: 32 });
       const parsed = JSON.parse(aiRes.response.trim());
       if (typeof parsed.adjustment === 'number') {
         aiAdjustment = Math.max(-10, Math.min(10, parsed.adjustment));