cdp-edge 2.1.0 → 2.2.0

package/extracted-skill/tracking-events-generator/cdpTrack.js

@@ -25,6 +25,7 @@ import {
   initAntiBlocking,
   ANTI_BLOCKING_CONFIG
 } from './anti-blocking.js';
+import { initRouteIntentCapture } from './route-intent-capture.js';
 
 // ── Guards — segurança em SSR e SDK não carregado ──
 const isBrowser = typeof window !== 'undefined';
@@ -631,6 +632,12 @@ export async function init() {
     passCheckoutParams({ platforms: CONFIG.platforms });
   }
 
+  // 7. Route Intent Capture — widget pós-clique de rota para imóveis
+  // Ativa quando CONFIG.routeIntent.whatsappNumber estiver configurado.
+  if (CONFIG.routeIntent?.whatsappNumber) {
+    initRouteIntentCapture(CONFIG.routeIntent);
+  }
+
   if (CONFIG.debug) console.log('✅ cdpTrack SDK inicializado (Quantum Tier)');
 }
 

package/extracted-skill/tracking-events-generator/route-intent-capture.js

@@ -0,0 +1,222 @@
+/**
+ * CDP Edge — Route Intent Capture
+ * @version 2.0.0
+ *
+ * Fluxo:
+ *   1. Usuário clica em "Ver rota" → Google Maps abre normalmente
+ *   2. Widget aparece com um botão de WhatsApp
+ *   3. Usuário clica → WhatsApp abre com mensagem pré-escrita
+ *   4. Usuário envia → corretor recebe e responde
+ *
+ * Uso:
+ *   initRouteIntentCapture({
+ *     whatsappNumber: '5511999999999',   // número do plantão/corretor
+ *     propertyName:   'Reserva do Jardim',
+ *     propertyId:     'rj-001',
+ *     propertyLat:    -23.6519,
+ *     propertyLng:    -46.5330,
+ *   });
+ */
+
+const isBrowser = typeof window !== 'undefined';
+
+/**
+ * @param {object} options
+ * @param {string}   options.whatsappNumber   Número do plantão (ex: '5511999999999')
+ * @param {string}  [options.propertyName]    Nome do empreendimento
+ * @param {string}  [options.propertyId]      ID interno do imóvel
+ * @param {number}  [options.propertyLat]     Latitude
+ * @param {number}  [options.propertyLng]     Longitude
+ * @param {string}  [options.routeSelector]   CSS selector dos botões de rota (default auto)
+ * @param {string}  [options.distanceBucket]  'very_close'|'close'|'nearby'|'moderate'|'far'
+ * @param {number}  [options.distanceKm]      Distância em km — exibe tempo estimado
+ * @param {string}  [options.metaSignalBucket] 'hot'|'warm'|'cold'
+ * @param {string}  [options.brokerName]       Nome do corretor de plantão (ex: 'Ramon')
+ */
+export function initRouteIntentCapture(options = {}) {
+  if (!isBrowser) return;
+
+  const {
+    whatsappNumber,
+    propertyName    = 'o imóvel',
+    propertyId      = null,
+    propertyLat     = null,
+    propertyLng     = null,
+    routeSelector   = '[data-route-intent], a[href*="maps/dir"], a[href*="maps?q="]',
+    distanceBucket  = null,
+    distanceKm      = null,
+    metaSignalBucket = null,
+    brokerName      = null,
+  } = options;
+
+  if (!whatsappNumber) {
+    console.warn('[RouteIntent] whatsappNumber é obrigatório.');
+    return;
+  }
+
+  _injectStyles();
+
+  document.addEventListener('click', (e) => {
+    const btn = e.target.closest(routeSelector);
+    if (!btn) return;
+    _showWidget(btn, { whatsappNumber, propertyName, propertyId, propertyLat, propertyLng, distanceBucket, distanceKm, metaSignalBucket, brokerName });
+  }, true);
+}
+
+// ── Widget ────────────────────────────────────────────────────────────────────
+
+function _showWidget(anchorEl, opts) {
+  document.getElementById('cdp-ri-widget')?.remove();
+
+  const travelMinutes = _estimateTravelMinutes(opts.distanceKm);
+  const travelText    = travelMinutes
+    ? `<p class="cdp-ri-travel">📍 Você está a cerca de <strong>${travelMinutes} min</strong> daqui</p>`
+    : '';
+
+  const brokerLine = opts.brokerName
+    ? `<p class="cdp-ri-broker">Ao chegar, pergunte pelo <strong>${opts.brokerName}</strong> — ele vai estar te aguardando com tudo pronto 🤝</p>`
+    : '';
+
+  const widget = document.createElement('div');
+  widget.id = 'cdp-ri-widget';
+  widget.innerHTML = `
+    <div class="cdp-ri-inner">
+      ${travelText}
+      <p class="cdp-ri-headline">Vi que você quer visitar o local! Confirme sua vinda enviando a mensagem abaixo — nossa equipe já fica de prontidão pra te receber 👇</p>
+      ${brokerLine}
+      <button id="cdp-ri-btn" type="button">
+        ${_waIcon()} Confirmar minha visita
+      </button>
+      <button id="cdp-ri-dismiss" type="button" class="cdp-ri-dismiss">Agora não</button>
+    </div>
+  `;
+
+  anchorEl.insertAdjacentElement('afterend', widget);
+  setTimeout(() => widget.scrollIntoView({ behavior: 'smooth', block: 'nearest' }), 150);
+
+  document.getElementById('cdp-ri-btn').addEventListener('click', () => _handleClick(widget, opts));
+  document.getElementById('cdp-ri-dismiss').addEventListener('click', () => {
+    window.cdpTrack?.track?.('ViewContent', {
+      content_name:       'rota_dispensada',
+      property_id:        opts.propertyId,
+      funnel_stage:       'route_dismiss',
+      intent_score:       'medium',
+      distance_bucket:    opts.distanceBucket  || undefined,
+      meta_signal_bucket: opts.metaSignalBucket || undefined,
+    });
+    widget.remove();
+  });
+}
+
+// ── Click — dispara evento e abre WhatsApp ────────────────────────────────────
+
+async function _handleClick(widget, opts) {
+  const btn = document.getElementById('cdp-ri-btn');
+  if (btn) btn.disabled = true;
+
+  // Evento Contact → Worker: LTV + hot lead trigger + CAPI
+  // Phone capturado depois via webhook quando a mensagem chegar
+  window.cdpTrack?.track?.('Contact', {
+    content_name:       'aviso_chegada_whatsapp',
+    property_id:        opts.propertyId,
+    property_lat:       opts.propertyLat,
+    property_lng:       opts.propertyLng,
+    funnel_stage:       'route_click',
+    intent_score:       'high',
+    distance_bucket:    opts.distanceBucket   || undefined,
+    meta_signal_bucket: opts.metaSignalBucket || undefined,
+  });
+
+  // Monta mensagem — acolhedora, foco em confirmar chegada
+  const travelMinutes = _estimateTravelMinutes(opts.distanceKm);
+  const travelLine    = travelMinutes ? `Estou a cerca de ${travelMinutes} minutos daí.` : '';
+  const brokerLine    = opts.brokerName
+    ? `Vou procurar pelo ${opts.brokerName} ao chegar.`
+    : '';
+
+  const msg = [
+    `Oi! Estou interessado(a) em visitar o ${opts.propertyName} e gostaria de confirmar minha visita.`,
+    travelLine,
+    brokerLine || `Vocês conseguem me receber agora ou preciso marcar horário?`,
+  ].filter(Boolean).join(' ');
+
+  _showSuccess(widget, opts.whatsappNumber, msg);
+}
+
+// ── Tela de confirmação ───────────────────────────────────────────────────────
+
+function _showSuccess(widget, whatsappNumber, msg) {
+  widget.innerHTML = `
+    <div class="cdp-ri-inner cdp-ri-ok">
+      <span class="cdp-ri-check">✅</span>
+      <p><strong>Abrindo WhatsApp...</strong><br><span>A equipe já foi avisada!</span></p>
+    </div>
+  `;
+  setTimeout(() => {
+    window.open(`https://wa.me/${whatsappNumber}?text=${encodeURIComponent(msg)}`, '_blank');
+    setTimeout(() => widget?.remove(), 3500);
+  }, 600);
+}
+
+// ── Helpers ───────────────────────────────────────────────────────────────────
+
+function _estimateTravelMinutes(distanceKm) {
+  if (!distanceKm || distanceKm <= 0) return null;
+  return Math.max(5, Math.round((distanceKm * 60 / 25) / 5) * 5);
+}
+
+function _waIcon() {
+  return `<svg width="18" height="18" viewBox="0 0 24 24" fill="currentColor" aria-hidden="true">
+    <path d="M17.472 14.382c-.297-.149-1.758-.867-2.03-.967-.273-.099-.471-.148-.67.15-.197.297-.767.966-.94 1.164-.173.199-.347.223-.644.075-.297-.15-1.255-.463-2.39-1.475-.883-.788-1.48-1.761-1.653-2.059-.173-.297-.018-.458.13-.606.134-.133.298-.347.446-.52.149-.174.198-.298.298-.497.099-.198.05-.371-.025-.52-.075-.149-.669-1.612-.916-2.207-.242-.579-.487-.5-.669-.51-.173-.008-.371-.01-.57-.01-.198 0-.52.074-.792.372-.272.297-1.04 1.016-1.04 2.479 0 1.462 1.065 2.875 1.213 3.074.149.198 2.096 3.2 5.077 4.487.709.306 1.262.489 1.694.625.712.227 1.36.195 1.871.118.571-.085 1.758-.719 2.006-1.413.248-.694.248-1.289.173-1.413-.074-.124-.272-.198-.57-.347z"/>
+    <path d="M12 0C5.373 0 0 5.373 0 12c0 2.122.554 4.118 1.528 5.852L0 24l6.335-1.513A11.933 11.933 0 0012 24c6.627 0 12-5.373 12-12S18.627 0 12 0zm0 21.818a9.818 9.818 0 01-5.002-1.368l-.359-.213-3.722.888.924-3.617-.234-.372A9.818 9.818 0 012.182 12C2.182 6.57 6.57 2.182 12 2.182S21.818 6.57 21.818 12 17.43 21.818 12 21.818z"/>
+  </svg>`;
+}
+
+// ── Estilos ───────────────────────────────────────────────────────────────────
+
+function _injectStyles() {
+  if (document.getElementById('cdp-ri-styles')) return;
+  const s = document.createElement('style');
+  s.id = 'cdp-ri-styles';
+  s.textContent = `
+    #cdp-ri-widget {
+      margin-top: 12px;
+      padding: 16px 18px;
+      background: #f0fdf4;
+      border: 1.5px solid #22c55e;
+      border-radius: 12px;
+      font-family: Arial, sans-serif;
+      animation: cdp-ri-in .25s ease;
+    }
+    @keyframes cdp-ri-in {
+      from { opacity: 0; transform: translateY(-8px); }
+      to   { opacity: 1; transform: translateY(0); }
+    }
+    .cdp-ri-inner         { display: flex; flex-direction: column; gap: 10px; }
+    .cdp-ri-travel        { margin: 0; font-size: 13px; color: #555; }
+    .cdp-ri-travel strong { color: #0f766e; }
+    .cdp-ri-headline      { margin: 0; font-size: 14px; color: #15803d; font-weight: bold; line-height: 1.4; }
+    .cdp-ri-broker        { margin: 0; font-size: 13px; color: #555; line-height: 1.4; }
+    .cdp-ri-broker strong { color: #0f766e; }
+    #cdp-ri-btn {
+      display: flex; align-items: center; justify-content: center; gap: 8px;
+      width: 100%; padding: 13px 16px;
+      background: #25D366; color: #fff;
+      border: none; border-radius: 10px;
+      font-size: 15px; font-weight: bold; cursor: pointer;
+    }
+    #cdp-ri-btn:hover    { background: #1ebe5a; }
+    #cdp-ri-btn:disabled { background: #86efac; cursor: not-allowed; }
+    .cdp-ri-dismiss {
+      background: none; border: none;
+      color: #aaa; font-size: 12px;
+      cursor: pointer; padding: 2px 0; text-align: center;
+    }
+    .cdp-ri-dismiss:hover { color: #666; }
+    .cdp-ri-ok   { align-items: center; text-align: center; gap: 8px; }
+    .cdp-ri-check { font-size: 28px; }
+    .cdp-ri-ok p  { margin: 0; font-size: 14px; color: #15803d; line-height: 1.5; }
+    .cdp-ri-ok span { font-size: 13px; color: #555; }
+  `;
+  document.head.appendChild(s);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cdp-edge",
-  "version": "2.1.0",
+  "version": "2.2.0",
   "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

@@ -16,6 +16,11 @@ import {
   sha256,
   META_TO_GA4,
   VALID_EVENT_NAMES,
+  resolveFunnelStage,
+  resolveIntentScore,
+  distanceBucketWeight,
+  computeMetaSignalWeights,
+  metaSignalBucket,
 } from './modules/utils.js';
 
 // ── Banco de dados (D1) ───────────────────────────────────────────────────────
@@ -31,6 +36,7 @@ import {
   saveEdgeFingerprint,
   resurrectUTM,
   upsertLtvProfile,
+  recordLtvFeedback,
 } from './modules/db.js';
 
 // ── Dispatch — plataformas de ads ─────────────────────────────────────────────
@@ -92,6 +98,16 @@ import {
   buildGoogleCustomerMatchExport,
 } from './modules/intelligence.js';
 
+// ── Haversine distance (km) — sem dependência externa ────────────────────────
+function haversineKm(lat1, lon1, lat2, lon2) {
+  const R    = 6371;
+  const dLat = (lat2 - lat1) * Math.PI / 180;
+  const dLon = (lon2 - lon1) * Math.PI / 180;
+  const a    = Math.sin(dLat / 2) ** 2 +
+    Math.cos(lat1 * Math.PI / 180) * Math.cos(lat2 * Math.PI / 180) * Math.sin(dLon / 2) ** 2;
+  return R * 2 * Math.atan2(Math.sqrt(a), Math.sqrt(1 - a));
+}
+
 // ─────────────────────────────────────────────────────────────────────────────
 // HANDLER PRINCIPAL
 // ─────────────────────────────────────────────────────────────────────────────
@@ -270,6 +286,9 @@ export default {
         payload.engagementScore = behavioral_data.engagement_score ?? behavioral_data.totalScore ?? null;
         payload.intentionLevel  = behavioral_data.intention_level  ?? null;
         payload.userScore       = behavioral_data.user_score       ?? null;
+        // Sinais de engajamento profundo — usados no anti-falso-positivo e no LTV
+        payload.scrollScore     = behavioral_data.scroll_score     ?? null;
+        payload.timeLevel       = behavioral_data.time_level       ?? null;
         payload.email     = payload.email     || behavioral_data.email      || null;
         payload.phone     = payload.phone     || behavioral_data.phone      || null;
         payload.firstName = payload.firstName || behavioral_data.first_name  || behavioral_data.firstName || null;
@@ -280,6 +299,35 @@ export default {
         payload.dob       = payload.dob       || behavioral_data.dob         || null;
       }
 
+      // ── Normalização de intent_score → 0.0–1.0 ──────────────────────────
+      // Aceita string ('high'/'medium'/'low'), 0-1 ou 0-100 enviados pelo front.
+      // intent_bucket mantém a label legível para D1 e logs.
+      const intentScoreNum = resolveIntentScore(payload.intent_score);
+      if (intentScoreNum !== null) {
+        payload.intent_score  = intentScoreNum;
+        payload.intentScoreNum = intentScoreNum;
+        payload.intent_bucket = intentScoreNum >= 0.8 ? 'high'
+                              : intentScoreNum >= 0.5 ? 'medium' : 'low';
+      } else {
+        payload.intentScoreNum = null;
+      }
+
+      // ── Anti-falso-positivo ───────────────────────────────────────────────
+      // Penaliza intent se engajamento insuficiente: scroll raso E tempo curto.
+      // scroll_score < 2.0 ≈ não passou de 50% da página.
+      // time_level 'curioso' = menos de 60 segundos na página.
+      if (payload.intentScoreNum !== null) {
+        const isShallowScroll = payload.scrollScore !== null && payload.scrollScore < 2.0;
+        const isShallowTime   = payload.timeLevel === 'curioso';
+        if (isShallowScroll && isShallowTime) {
+          const penalized = Math.round(payload.intentScoreNum * 0.7 * 100) / 100;
+          payload.intentScoreNum    = penalized;
+          payload.intent_score      = penalized;
+          payload.intent_bucket     = penalized >= 0.8 ? 'high' : penalized >= 0.5 ? 'medium' : 'low';
+          payload.intent_penalized  = true;  // flag auditável — visível no D1 e logs
+        }
+      }
+
       // ── Edge Fingerprint + UTM Resurrection ──────────────────────────────
       const fingerprint = await generateEdgeFingerprint(request);
       payload.utmRestored = false;
@@ -324,6 +372,34 @@ export default {
 
       const ga4Name = META_TO_GA4[eventName] || eventName.toLowerCase();
 
+      // ── Dual-layer semantics ─────────────────────────────────────────────
+      // Meta sempre recebe o nome canônico (Schedule, Lead, etc.).
+      // Internamente o CDP usa semântica de funil precisa via FUNNEL_TAXONOMY.
+      if (payload.funnel_stage) {
+        const { depth, funnelDepth } = resolveFunnelStage(payload.funnel_stage);
+        payload.funnelDepth = funnelDepth;  // ex: 'bottom_intent', 'bottom_conversion'
+        payload.funnelLevel = depth;        // ex: 'bottom', 'conversion', 'mid'
+      }
+      if (eventName === 'Schedule' && payload.funnel_stage === 'route_click') {
+        payload.internalEvent = 'IntentToVisit';
+      }
+
+      // ── Real Estate Distance Enrichment ──────────────────────────────────
+      // Calcula distância entre o IP do usuário (via Cloudflare) e o imóvel.
+      // Ativa quando o evento carrega property_lat + property_lng (ex: Schedule de rota).
+      const propLat = parseFloat(payload.property_lat ?? payload.propertyLat);
+      const propLng = parseFloat(payload.property_lng ?? payload.propertyLng);
+      const userLat = parseFloat(request.cf?.latitude);
+      const userLng = parseFloat(request.cf?.longitude);
+      if (!isNaN(propLat) && !isNaN(propLng) && !isNaN(userLat) && !isNaN(userLng)) {
+        const distKm = haversineKm(userLat, userLng, propLat, propLng);
+        payload.distanceKm     = Math.round(distKm * 10) / 10;
+        payload.distanceBucket = distKm <  5 ? 'very_close' :
+                                 distKm < 15 ? 'close'      :
+                                 distKm < 30 ? 'nearby'     :
+                                 distKm < 60 ? 'moderate'   : 'far';
+      }
+
       // ── LTV Prediction (+ A/B Testing de Prompts) ─────────────────────────
       const LTV_EVENTS = ['Lead', 'Contact', 'Schedule', 'CompleteRegistration'];
       if (LTV_EVENTS.includes(eventName) && !payload.value) {
@@ -352,6 +428,35 @@ export default {
         }
       }
 
+      // ── LTV Feedback Loop — fecha o ciclo preditivo ──────────────────────
+      // Quando uma compra real acontece, registra o valor real e recalcula accuracy.
+      // Alimenta ltv_ab_variations.accuracy_score → autoDecideAbWinner usa isso.
+      if (eventName === 'Purchase' && payload.value > 0) {
+        ctx.waitUntil(recordLtvFeedback(env, payload.userId, payload.value));
+      }
+
+      // ── Meta Signal Score (composite, pesos dinâmicos) ───────────────────
+      // Pesos variam por profundidade de funil: fundo = comportamento pesa mais.
+      {
+        const w  = computeMetaSignalWeights(payload.funnelLevel);
+        const iW = payload.intentScoreNum ?? 0.5;
+        const lW = payload.ltvScore ? payload.ltvScore / 100 : 0.5;
+        const dW = distanceBucketWeight(payload.distanceBucket);
+        payload.metaSignal       = Math.round(((iW * w.intent) + (lW * w.ltv) + (dW * w.dist)) * 100) / 100;
+        payload.metaSignalBucket = metaSignalBucket(payload.metaSignal);  // 'hot'/'warm'/'cold'
+      }
+
+      // ── Hot Lead Trigger (timing + sinal) ────────────────────────────────
+      // Reage em tempo real: WhatsApp apenas quando comportamento + sinal justificam.
+      // Critérios: rota + muito próximo + (intent alto OU meta_signal alto)
+      //            + (janela de decisão BRT 18–22h OU sinal excepcional ≥ 0.9)
+      const hourBRT  = (new Date().getUTCHours() - 3 + 24) % 24;
+      const inWindow = hourBRT >= 18 && hourBRT <= 22;
+      const isHotLead = payload.funnel_stage === 'route_click'
+                     && payload.distanceBucket === 'very_close'
+                     && ((payload.intentScoreNum ?? 0) >= 0.8 || payload.metaSignal >= 0.85)
+                     && (inWindow || payload.metaSignal >= 0.9);
+
       // Cross-Device Graph — background
       if (env.DB && payload.userId && (payload.email || payload.phone)) {
         ctx.waitUntil(resolveDeviceGraph(env.DB, payload.userId, payload.email, payload.phone));
@@ -366,10 +471,10 @@ export default {
         sendMetaCapi(env, eventName, payload, request, ctx),
         sendGA4Mp(env, ga4Name, payload, ctx),
         sendTikTokApi(env, eventName, payload, request, ctx),
-        saveLead(env, eventName, payload, request, 'website'),
+        saveLead(env, payload.internalEvent || eventName, payload, request, 'website'),
         upsertProfile(env, eventName, payload, request),
-        ...(WHATSAPP_NOTIFY_EVENTS.includes(eventName)
-          ? [sendWhatsApp(env, eventName, payload)]
+        ...(WHATSAPP_NOTIFY_EVENTS.includes(eventName) || isHotLead
+          ? [sendWhatsApp(env, isHotLead ? 'hot_lead_intent_to_visit' : eventName, payload)]
           : []),
       ]);
 

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

@@ -443,6 +443,77 @@ export async function upsertLtvProfile(env, userId, ltv) {
   }
 }
 
+// ── recordLtvFeedback — fecha o ciclo preditivo com valor real de compra ─────
+// Chamado em background quando um Purchase chega com payload.value > 0.
+// Atualiza user_profiles + ltv_ab_assignments + ltv_ab_variations em cascata.
+export async function recordLtvFeedback(env, userId, realValue) {
+  if (!env.DB || !userId || !realValue || realValue <= 0) return;
+
+  try {
+    // 1. Busca predicted_ltv_value atual do perfil
+    const profile = await env.DB.prepare(`
+      SELECT predicted_ltv_value FROM user_profiles WHERE user_id = ?
+    `).bind(userId).first();
+
+    // accuracy = 1 - |pred-real|/real  (0–1, mesmo padrão do A/B test accuracy_score)
+    const predictedValue = profile?.predicted_ltv_value;
+    const ltv_accuracy = (predictedValue !== null && predictedValue !== undefined)
+      ? Math.max(0, Math.round((1 - Math.abs(predictedValue - realValue) / Math.max(realValue, 1)) * 100) / 100)
+      : null;
+
+    // 2. Grava valor real + accuracy no perfil
+    await env.DB.prepare(`
+      UPDATE user_profiles
+      SET real_ltv_value  = ?,
+          ltv_accuracy    = ?,
+          ltv_feedback_at = datetime('now'),
+          updated_at      = datetime('now')
+      WHERE user_id = ?
+    `).bind(realValue, ltv_accuracy, userId).run();
+
+    // 3. Fecha assignment do A/B test mais recente não convertido (janela 60 dias)
+    const assignment = await env.DB.prepare(`
+      SELECT id, variation_id, predicted_ltv
+      FROM ltv_ab_assignments
+      WHERE user_id  = ?
+        AND converted = 0
+        AND assigned_at > datetime('now', '-60 days')
+      ORDER BY assigned_at DESC
+      LIMIT 1
+    `).bind(userId).first();
+
+    if (!assignment) return;
+
+    // 3a. Marca assignment como convertido
+    await env.DB.prepare(`
+      UPDATE ltv_ab_assignments
+      SET converted    = 1,
+          real_revenue = ?,
+          converted_at = datetime('now')
+      WHERE id = ?
+    `).bind(realValue, assignment.id).run();
+
+    // 3b. Atualiza métricas acumuladas da variação (running average — safe para concorrência D1)
+    const predLtv  = assignment.predicted_ltv || 0;
+    const indivAcc = Math.max(0, 1 - Math.abs(predLtv - realValue) / Math.max(realValue, 1));
+
+    await env.DB.prepare(`
+      UPDATE ltv_ab_variations
+      SET total_purchases  = total_purchases + 1,
+          sum_real_revenue = sum_real_revenue + ?,
+          avg_real_revenue = (sum_real_revenue + ?) / (total_purchases + 1),
+          accuracy_score   = ROUND(
+            (COALESCE(accuracy_score, 0) * total_purchases + ?) / (total_purchases + 1),
+            4
+          )
+      WHERE id = ?
+    `).bind(realValue, realValue, indivAcc, assignment.variation_id).run();
+
+  } catch (err) {
+    console.error('[LTV-Feedback] recordLtvFeedback error:', err.message);
+  }
+}
+
 // ── Feedback Loop — Log de falhas e métricas de saúde ────────────────────────
 
 export async function logApiFailure(DB, platform, eventName, errorCode, errorMessage, eventId, rawPayload) {

package/server-edge-tracker/modules/dispatch/meta.js

@@ -24,6 +24,9 @@ export async function sendMetaCapi(env, eventName, payload, request, ctx) {
     eventId, pageUrl,
     value, currency,
     contentIds, contentName, contentType, numItems,
+    // Dual-layer context — funil avançado + imóveis
+    funnel_stage, distance_bucket, intent_score, intent_bucket,
+    ltvScore, ltvClass, metaSignal, metaSignalBucket: metaSignalBucketVal,
   } = payload;
 
   const phoneNorm   = normalizePhone(phone);
@@ -57,6 +60,15 @@ export async function sendMetaCapi(env, eventName, payload, request, ctx) {
     ...(contentName && { content_name: contentName }),
     ...(contentType && { content_type: contentType }),
     ...(numItems    && { num_items: parseInt(numItems) }),
+    // Contexto de funil e proximidade — enriquece matching e otimização Meta
+    ...(funnel_stage    && { funnel_stage }),
+    ...(distance_bucket && { distance_bucket }),
+    ...(intent_score    && { intent_score }),
+    ...(ltvScore    !== undefined && ltvScore    !== null && { ltv_score: ltvScore }),
+    ...(ltvClass    && { ltv_class: ltvClass }),
+    ...(metaSignal       !== undefined && metaSignal       !== null && { meta_signal: metaSignal }),
+    ...(metaSignalBucketVal && { meta_signal_bucket: metaSignalBucketVal }),
+    ...(intent_bucket    && { intent_bucket }),
   };
 
   const eventPayload = {

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

@@ -8,6 +8,23 @@ import { extractFeatures, predictWithWeights, loadActiveWeights } from './logist
 // Cache key para o teste ativo (KV — evita hit no D1 a cada request /track)
 const AB_LTV_CACHE_KEY = 'ab_ltv_active_test';
 
+// ── Prompt especializado para imóveis ────────────────────────────────────────
+// Ativado automaticamente quando property_lat/lng estão presentes no payload.
+// Override por A/B test tem prioridade sobre este prompt.
+const REAL_ESTATE_PROMPT = `You are a real estate lead scoring expert for the Brazilian market.
+Reply ONLY with a JSON object {"adjustment": <integer between -15 and 15>} based on the lead data.
+Scoring rules (apply additively):
+- distance_km < 5:  +12 (lives nearby, buys fast)
+- distance_km 5-15: +8
+- distance_km 15-30: +3
+- distance_km > 30:  0
+- distance_km unknown: +3 (gave intent signal without geo)
+- event = Schedule or route click: +5 (physical visit intent)
+- scroll_score >= 3 AND time_level = comprador: +4 (deep engagement)
+- hour_brt between 18-22 (weekday): +3 (active decision window)
+- has_phone = true: +2 (reachable for follow-up)
+No explanation. JSON only.`;
+
 // ── predictLtv — Heurística em 5 dimensões (0-100 pts) ───────────────────────
 export async function predictLtv(env, payload, request, customSystemPrompt = null) {
   // ── Tentar modelo treinado (regressão logística real) ─────────────────────
@@ -83,6 +100,19 @@ export async function predictLtv(env, payload, request, customSystemPrompt = nul
   if (payload.phone) score += 4;
   if (payload.firstName) score += 2;
 
+  // 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) {
+    if      (distKm <  5)  score += 15;
+    else if (distKm < 15)  score += 10;
+    else if (distKm < 30)  score += 6;
+    else if (distKm < 60)  score += 3;
+    // > 60km: sem bônus — lead distante precisa de argumento diferente
+  } else if (payload.property_lat || payload.propertyLat) {
+    // Coords no payload mas distância não resolvida: pequeno bônus por intenção de rota
+    score += 3;
+  }
+
   score = Math.min(100, score);
 
   let ltvClass, ltvMultiplier;
@@ -102,19 +132,34 @@ export async function predictLtv(env, payload, request, customSystemPrompt = nul
   let aiAdjustment = 0;
   if (env.AI && score >= 40) {
     try {
+      const isRealEstate = !!(payload.property_lat || payload.propertyLat);
       const systemContent = customSystemPrompt ||
-        'You are a conversion rate expert. Reply ONLY with a JSON object {"adjustment": <number between -10 and 10>} based on the lead data provided. No explanation.';
+        (isRealEstate
+          ? REAL_ESTATE_PROMPT
+          : 'You are a conversion rate expert. Reply ONLY with a JSON object {"adjustment": <number between -10 and 10>} based on the lead data provided. No explanation.');
+
+      const userContext = {
+        utm_source:  payload.utmSource,
+        intention:   intentionLevel,
+        engagement:  engScore,
+        hour_utc:    hour,
+        country,
+        has_email:   !!payload.email,
+        has_phone:   !!payload.phone,
+      };
+      if (isRealEstate) {
+        userContext.event_type     = 'real_estate_schedule';
+        userContext.distance_km    = payload.distanceKm ?? payload.user_distance_km ?? 'unknown';
+        userContext.distance_bucket = payload.distanceBucket ?? 'unknown';
+        userContext.scroll_score   = payload.scrollScore || payload.scroll_score || 0;
+        userContext.time_level     = payload.timeLevel || payload.time_level || 'unknown';
+        userContext.intent_score   = payload.intent_score || 'high';
+        userContext.hour_brt       = (hour - 3 + 24) % 24; // UTC-3 aproximado
+      }
+
       const prompt = [
         { role: 'system', content: systemContent },
-        { role: 'user', content: JSON.stringify({
-          utm_source:  payload.utmSource,
-          intention:   intentionLevel,
-          engagement:  engScore,
-          hour_utc:    hour,
-          country,
-          has_email:   !!payload.email,
-          has_phone:   !!payload.phone,
-        })},
+        { 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 parsed = JSON.parse(aiRes.response.trim());

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

@@ -87,3 +87,79 @@ export const VALID_EVENT_NAMES = new Set([
   'StartTrial','Subscribe','SubmitApplication','Search',
   'video_start','video_25','video_50','video_75','video_complete',
 ]);
+
+// ── 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'],
+  conversion: ['schedule_confirmed', 'lead_form', 'purchase', 'visit_booked'],
+};
+
+// Índice invertido: funnel_stage → depth (construído uma vez, zero custo em runtime)
+const _STAGE_TO_DEPTH = Object.entries(FUNNEL_TAXONOMY).reduce((acc, [depth, stages]) => {
+  stages.forEach(s => { acc[s] = depth; });
+  return acc;
+}, {});
+
+/**
+ * Resolve funnel_stage em funnelDepth semântico.
+ * bottom_intent  = intenção forte (route_click, whatsapp_click)
+ * bottom_conversion = ação confirmada (schedule_confirmed, lead_form)
+ */
+export function resolveFunnelStage(funnel_stage) {
+  const depth = _STAGE_TO_DEPTH[funnel_stage] || 'unknown';
+  const funnelDepth = depth === 'conversion' ? 'bottom_conversion'
+                    : depth === 'bottom'     ? 'bottom_intent'
+                    : depth;
+  return { depth, funnelDepth };
+}
+
+// ── Normalização de intent_score → 0.0–1.0 ───────────────────────────────────
+// Aceita: string ('high'/'medium'/'low'), numérico 0-1 ou numérico 0-100
+const _INTENT_STRING_MAP = { high: 0.92, medium: 0.65, low: 0.30 };
+
+export function resolveIntentScore(value) {
+  if (value === null || value === undefined) return null;
+  if (typeof value === 'string') return _INTENT_STRING_MAP[value.toLowerCase()] ?? null;
+  const num = parseFloat(value);
+  if (isNaN(num)) return null;
+  const normalized = num > 1 ? num / 100 : num;  // escala 0-100 → 0-1
+  return Math.min(1, Math.max(0, Math.round(normalized * 100) / 100));
+}
+
+/**
+ * Distância (distanceBucket) → peso numérico para meta_signal.
+ * very_close=1.0 ... far=0.1 ... sem dado=0.3 (neutro)
+ */
+export function distanceBucketWeight(bucket) {
+  const map = { very_close: 1.0, close: 0.75, nearby: 0.5, moderate: 0.25, far: 0.1 };
+  return map[bucket] ?? 0.3;
+}
+
+/**
+ * Pesos dinâmicos do meta_signal por profundidade de funil.
+ * Fundo: comportamento pesa mais (intent + dist).
+ * Topo: perfil pesa mais (ltv).
+ * Default (mid/unknown): balanceado.
+ */
+export function computeMetaSignalWeights(funnelLevel) {
+  if (funnelLevel === 'bottom' || funnelLevel === 'conversion') {
+    return { intent: 0.5, ltv: 0.2, dist: 0.3 };
+  }
+  if (funnelLevel === 'top') {
+    return { intent: 0.2, ltv: 0.6, dist: 0.2 };
+  }
+  return { intent: 0.4, ltv: 0.4, dist: 0.2 };
+}
+
+/**
+ * Quantiza meta_signal contínuo em bucket legível.
+ * Usado em criação de públicos e leitura de BI.
+ */
+export function metaSignalBucket(score) {
+  if (score >= 0.8) return 'hot';
+  if (score >= 0.6) return 'warm';
+  return 'cold';
+}

package/server-edge-tracker/schema-ltv-feedback.sql

@@ -0,0 +1,11 @@
+-- CDP Edge — Schema LTV Feedback Loop
+-- Fecha o ciclo preditivo: Purchase real → corrige predicted_ltv_value
+-- Execução: wrangler d1 execute cdp-edge-db --file=schema-ltv-feedback.sql --remote
+--
+-- Idempotência: ALTER TABLE não suporta IF NOT EXISTS no SQLite.
+-- Se a coluna já existir, o comando gera erro mas não afeta dados existentes.
+-- Seguro executar mais de uma vez.
+
+ALTER TABLE user_profiles ADD COLUMN real_ltv_value  REAL;
+ALTER TABLE user_profiles ADD COLUMN ltv_accuracy    REAL;   -- 1 - |pred-real|/real  (0–1, maior = melhor)
+ALTER TABLE user_profiles ADD COLUMN ltv_feedback_at TEXT;   -- timestamp do último feedback