cdp-edge 2.3.7 → 2.3.9

package/extracted-skill/tracking-events-generator/models/quiz-funnel.md

@@ -1,15 +1,15 @@
 # Modelo: Quiz Funnel (Cloudflare Native)
 
-Este modelo é destinado a funis de quiz, onde o usuário responde a uma série de perguntas antes de ser redirecionado para a oferta final. O rastreamento foca na progressão do usuário e na captura de dados intermediários.
+Este modelo é destinado a funis de quiz, onde o usuário responde a uma série de perguntas antes de ser redirecionado para a oferta final. O rastreamento foca na progressão do usuário e na **qualificação automática de intenção via Workers AI**.
 
 ---
 
 ## 🏗️ ARQUITETURA TÉCNICA (Quantum Tier)
 
-O rastreamento segue a lógica de micro-eventos:
+O rastreamento segue a lógica de micro-eventos + scoring automático:
 1. **Página**: Dispara um evento a cada resposta dada no quiz via `cdpTrack.track()`.
-2. **Servidor (Worker)**: Recebe e armazena o progresso no banco D1.
-3. **Database (D1)**: Mantém o histórico de respostas vinculado ao `track_user_id`.
+2. **Servidor (Worker)**: Ao receber `QuizComplete`, envia as respostas ao **Quiz Scoring Engine** (Granite 4.0 Micro) que classifica o respondente.
+3. **Pipeline CDP**: A qualificação (`comprador | interessado | curioso | perdido`) é injetada como `intentionLevel` e flui automaticamente para LTV Prediction, Meta Signal Score, D1 e CAPI dispatch.
 
 ---
 
@@ -19,50 +19,114 @@ O rastreamento segue a lógica de micro-eventos:
 |---|---|---|
 | **QuizStart** | Início do quiz | `quiz_name`, `source` |
 | **QuizAnswer** | Resposta a uma pergunta | `question`, `answer`, `step` |
-| **QuizComplete** | Finalização do quiz | `result`, `completion_time` |
+| **QuizComplete** | Finalização + qualificação AI | `quiz_name`, `quiz_answers[]`, `result` |
+
+---
+
+## 🤖 QUALIFICAÇÃO AUTOMÁTICA (Quiz Scoring Engine — Fase 6)
+
+Ao receber `QuizComplete` com `quiz_answers`, o Worker classifica automaticamente:
+
+| Qualificação | Significado | intent_score |
+|---|---|---|
+| **comprador** | Pronto para comprar agora | 0.80–1.00 |
+| **interessado** | Interesse real, avaliando | 0.50–0.79 |
+| **curioso** | Pesquisando, sem urgência | 0.20–0.49 |
+| **perdido** | Fora do público, sem fit | 0.00–0.19 |
+
+O `intent_score` resultante:
+- Alimenta o **LTV Prediction** (comprador → LTV High automaticamente)
+- Compõe o **Meta Signal Score** (pesos dinâmicos por funil)
+- Persiste em `leads.intention_level` e `quiz_sessions` no D1
+- É enviado como `custom_data` para Meta CAPI, GA4 e TikTok
 
 ---
 
 ## 🛠️ PASSO 1: CONFIGURAÇÃO DO SITE
 
 ### 1.1 Rastreamento de Respostas
-Integre este código na lógica de clique do seu quiz.
+Acumule as respostas do quiz em um array local.
 
 ```javascript
-// Exemplo de captura de resposta
+const quizAnswers = [];
+
 function onResponder(pergunta, resposta, etapa) {
+  // Armazena localmente para enviar no QuizComplete
+  quizAnswers.push({ question: pergunta, answer: resposta, step: etapa });
+
+  // Dispara micro-evento por resposta (opcional, para análise granular)
   cdpTrack.track('QuizAnswer', {
     question: pergunta,
     answer: resposta,
     step: etapa,
-    event_id: cdpTrack.generateId()
+    event_id: cdpTrack.generateId(),
   });
 }
 ```
 
-### 1.2 Finalização do Quiz
-Disparar ao chegar no resultado final ou na página de captura pós-quiz.
+### 1.2 Finalização do Quiz — com qualificação AI automática
+Envie todas as respostas no `QuizComplete`. O Worker qualifica automaticamente.
 
 ```javascript
 cdpTrack.track('QuizComplete', {
-  result: 'Perfil_A',
-  event_id: cdpTrack.generateId()
+  quiz_name: 'Diagnóstico de Perfil',   // nome para o dashboard
+  quiz_answers: quizAnswers,             // array com todas as respostas
+  result: 'Perfil_A',                   // resultado exibido ao usuário (opcional)
+  event_id: cdpTrack.generateId(),
 });
 ```
 
+### 1.3 Resposta do Worker
+O endpoint `/track` retorna a qualificação para uso imediato no front:
+
+```json
+{
+  "ok": true,
+  "userProfile": {
+    "score": 87,
+    "user_id": "uuid-xxx"
+  },
+  "quiz_qualification": "comprador",
+  "quiz_confidence": 0.91,
+  "quiz_signals": ["quero comprar", "tenho budget", "agora"],
+  "intent_score": 0.92,
+  "intent_bucket": "high"
+}
+```
+
+Use esses campos para personalizar o redirecionamento pós-quiz no front-end.
+
 ---
 
 ## ⚡ PASSO 2: SERVIDOR (CLOUDFLARE WORKER)
 
-O Worker realiza:
-- **Agregação**: O `user_id` permite que todas as respostas sejam vinculadas a um único perfil no banco D1.
-- **Enriquecimento**: Se o usuário deixar o e-mail no final, todas as respostas anteriores são associadas ao e-mail para a CAPI.
-- **API Dispatch**: Envio de eventos customizados para Meta e TikTok para otimização de público.
+O Worker realiza automaticamente na ordem:
+
+1. **Quiz Scoring Engine**: Granite 4.0 Micro classifica as respostas → `qualification` + `intent_score`
+2. **LTV Prediction**: usa `intentionLevel = 'comprador'` → LTV High → valor previsto em BRL
+3. **Meta Signal Score**: `intent_score` compõe o score composto (intent × ltv × distância)
+4. **D1 Writes**: `quiz_sessions` + `leads.intention_level` + `user_profiles.cohort_label`
+5. **CAPI Dispatch**: Meta/GA4/TikTok recebem evento com `custom_data.intention = 'comprador'`
+
+---
+
+## 🔀 FALLBACK HEURÍSTICO
+
+Se Workers AI estiver indisponível (timeout, cold start), o sistema usa correspondência de palavras-chave:
+
+- `comprador`: "quero", "comprar", "agora", "tenho interesse", "quanto custa"
+- `interessado`: "talvez", "pensando", "em breve", "estou avaliando"
+- `curioso`: "só olhando", "pesquisando", "curiosidade"
+- `perdido`: "não entendi", "errei aqui", "não é para mim"
+
+O campo `quiz_source` indica `"ai"` ou `"heuristic"` para auditoria.
 
 ---
 
 ## ✅ VALIDAÇÃO TÉCNICA
 
-- **Persistência**: Verifique no banco D1 se a jornada do usuário está sendo gravada passo a passo.
-- **Deduplicação**: O `event_id` único por resposta evita contagens duplicadas.
-- **Match Quality**: A vinculação tardia do e-mail com as respostas iniciais aumenta a precisão da atribuição.
+- **Persistência**: `quiz_sessions` no D1 — jornada completa por `user_id`
+- **Deduplicação**: `event_id` único por evento evita contagens duplicadas
+- **Enriquecimento retroativo**: e-mail preenchido pós-quiz associa todas as respostas ao perfil
+- **Match Quality**: `comprador` com e-mail → score máximo na CAPI Meta
+- **VIEW de dashboard**: `v_quiz_qualification_summary` — distribuição de qualificações por quiz

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cdp-edge",
-  "version": "2.3.7",
+  "version": "2.3.9",
   "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.ts

@@ -101,6 +101,15 @@ import {
   handleFraudStats,
 } from './modules/ml/fraud';
 
+// ── Quiz Scoring Engine (Fase 6) ──────────────────────────────────────────────
+import {
+  scoreQuizAnswers,
+  saveQuizSession,
+} from './modules/ml/quiz';
+
+// ── Nurture Engine (Fase 7) ───────────────────────────────────────────────────
+import { scheduleNurture } from './modules/nurture';
+
 // ── Intelligence Agent (Cron) ─────────────────────────────────────────────────
 import {
   runIntelligenceAgent,
@@ -272,6 +281,27 @@ export default {
       const { eventName, behavioral_data, ...payload } = body as { eventName?: string; behavioral_data?: BehavioralData; [key: string]: any };
       const trackPayload: TrackPayload = payload;
 
+      // ── Extrair click_ids e utms de sub-objetos (formato cdpTrack.js) ────────
+      // cdpTrack.js envia fbp/fbc/fbclid dentro de click_ids{} e UTMs dentro de utms{}
+      // O Worker trabalha com campos no nível raiz — esta extração resolve o mismatch.
+      if (payload.click_ids && typeof payload.click_ids === 'object') {
+        const c = payload.click_ids as Record<string, string>;
+        if (!trackPayload.fbp    && c.fbp)    trackPayload.fbp    = c.fbp;
+        if (!trackPayload.fbc    && c.fbc)    trackPayload.fbc    = c.fbc;
+        if (!trackPayload.fbclid && c.fbclid) trackPayload.fbclid = c.fbclid;
+        if (!trackPayload.gclid  && c.gclid)  trackPayload.gclid  = c.gclid;
+        if (!trackPayload.ttclid && c.ttclid) trackPayload.ttclid = c.ttclid;
+        if (!trackPayload.ttp    && c.ttp)    trackPayload.ttp    = c.ttp;    // TikTok Pixel cookie
+      }
+      if (payload.utms && typeof payload.utms === 'object') {
+        const u = payload.utms as Record<string, string>;
+        if (!trackPayload.utmSource   && u.utm_source)   trackPayload.utmSource   = u.utm_source;
+        if (!trackPayload.utmMedium   && u.utm_medium)   trackPayload.utmMedium   = u.utm_medium;
+        if (!trackPayload.utmCampaign && u.utm_campaign) trackPayload.utmCampaign = u.utm_campaign;
+        if (!trackPayload.utmContent  && u.utm_content)  trackPayload.utmContent  = u.utm_content;
+        if (!trackPayload.utmTerm     && u.utm_term)     trackPayload.utmTerm     = u.utm_term;
+      }
+
       // ── Validação de eventName ────────────────────────────────────────
       if (!eventName) {
         return new Response(JSON.stringify({ error: 'eventName é obrigatório' }), { status: 400, headers });
@@ -286,7 +316,7 @@ export default {
 
       const SANITIZE_FIELDS: Record<string, (val: string) => SanitizeResult> = {
         email: (val: string) => {
-          if (!isValidEmail(val)) return { error: 'email inválido (formato incorreto)' };
+          if (!isValidEmail(val)) return { error: 'email inválido (formato incorreto)', sanitized: null };
           return { sanitized: val.toLowerCase().trim() };
         },
         firstName: (val: string) => ({ sanitized: sanitizeString(val, 100) }),
@@ -297,11 +327,11 @@ export default {
         dob: (val: string) => ({ sanitized: sanitizeString(val, 20) }),
         productName: (val: string) => ({ sanitized: sanitizeString(val, 200) }),
         pageUrl: (val: string) => {
-          if (!isValidUrl(val)) return { error: 'pageUrl inválido (formato incorreto)' };
+          if (!isValidUrl(val)) return { error: 'pageUrl inválido (formato incorreto)', sanitized: null };
           return { sanitized: val.trim() };
         },
         currency: (val: string) => {
-          if (!isValidCurrency(val)) return { error: 'currency inválido (deve ser código ISO 4217)' };
+          if (!isValidCurrency(val)) return { error: 'currency inválido (deve ser código ISO 4217)', sanitized: null };
           return { sanitized: val.trim().toUpperCase() };
         },
       };
@@ -360,6 +390,14 @@ export default {
         }
       }
 
+      // ── fbc derivado de fbclid ───────────────────────────────────────────
+      // Quando o usuário vem de um clique Meta, fbclid chega na URL e o cdpTrack.js
+      // o envia como campo. O CAPI espera fbc no formato fb.1.{ms}.{fbclid}.
+      // Sem essa conversão, o sinal de clique some — EMQ cai e deduplicação piora.
+      if (trackPayload.fbclid && !trackPayload.fbc) {
+        trackPayload.fbc = `fb.1.${Date.now()}.${trackPayload.fbclid}`;
+      }
+
       // ── Validação de Valor Numérico ───────────────────────────────────
       if (trackPayload.value !== undefined && trackPayload.value !== null) {
         if (!isValidValue(trackPayload.value)) {
@@ -519,8 +557,46 @@ export default {
                                        distKm < 60 ? 'moderate'   : 'far';
       }
 
+      // ── Quiz Scoring Engine (Fase 6) ─────────────────────────────────────
+      // Roda antes do LTV para que intentionLevel qualificado alimente a predição.
+      // O front envia quiz_answers: [{question, answer, step}] junto com QuizComplete.
+      if (eventName === 'QuizComplete' && Array.isArray(payload.quiz_answers) && payload.quiz_answers.length > 0) {
+        try {
+          const quizResult = await scoreQuizAnswers(env, payload.quiz_answers, payload.quiz_name ?? null);
+
+          // Injeta qualificação no payload — flui para LTV, Meta Signal, D1 e CAPI
+          payload.intentionLevel  = quizResult.qualification;
+          payload.intent_score    = quizResult.intent_score;
+          payload.intentScoreNum  = quizResult.intent_score;
+          payload.intent_bucket   = quizResult.intent_score >= 0.8 ? 'high'
+                                  : quizResult.intent_score >= 0.5 ? 'medium' : 'low';
+
+          // Campos extras para auditoria e dashboard
+          (payload as any).quiz_qualification      = quizResult.qualification;
+          (payload as any).quiz_confidence         = quizResult.confidence;
+          (payload as any).quiz_weighted_score     = quizResult.weighted_score;
+          (payload as any).quiz_dominant_dimension = quizResult.dominant_dimension;
+          (payload as any).quiz_signals            = quizResult.dimensions.map((d: any) => d.signal).filter(Boolean);
+          (payload as any).quiz_source             = quizResult.source;
+
+          // utm_term — injetado pelo Worker após qualificação (nunca configurado nos anúncios)
+          // Flui para Meta CAPI custom_data e D1 user_profiles para cruzar com ROAS Feedback
+          payload.utmTerm = quizResult.qualification;  // comprador | interessado | curioso | perdido
+
+          // Persiste sessão no D1 em background
+          if (env.DB) ctx.waitUntil(saveQuizSession(env, payload.userId, payload, quizResult));
+
+          // Agenda nurture sequence baseada na qualificação (background)
+          ctx.waitUntil(scheduleNurture(env, payload, quizResult.qualification));
+
+        } catch (err: any) {
+          console.error('[QuizScoring] erro ao qualificar respostas:', err?.message || String(err));
+          // Fail-safe: continua sem qualificação
+        }
+      }
+
       // ── LTV Prediction (+ A/B Testing de Prompts) ─────────────────────────
-      const LTV_EVENTS = ['Lead', 'Contact', 'Schedule', 'CompleteRegistration'];
+      const LTV_EVENTS = ['Lead', 'Contact', 'Schedule', 'CompleteRegistration', 'QuizComplete'];
       if (LTV_EVENTS.includes(eventName) && !payload.value) {
         const abVariation = await getLtvAbVariation(env);
         const ltv = await predictLtv(env, payload, request, abVariation?.system_prompt || null);
@@ -727,6 +803,7 @@ export default {
         return new Response(JSON.stringify({ skipped: `status ${wh.order_status}` }), { status: 200, headers });
       }
 
+      const customer = wh.Customer || {};
       const kwTxId = String(wh.order_id || '');
       const dupCheck = await processWebhookDuplicateCheck(env, 'kiwify', kwTxId, JSON.stringify(wh), {
         email: customer.email,
@@ -735,8 +812,6 @@ export default {
       if (dupCheck.duplicate) {
         return new Response(JSON.stringify({ ok: true, skipped: 'duplicate' }), { status: 200, headers });
       }
-
-      const customer = wh.Customer || {};
       const product  = wh.Product || {};
       const profile  = await getProfileByEmail(env, customer.email || '');
 

package/server-edge-tracker/modules/intelligence.ts

@@ -9,6 +9,8 @@ import { sendCallMeBot } from './dispatch/whatsapp.js';
 import { autoDecideAbWinner } from './ml/ltv.js';
 import { analyzeMatchQuality, alertMatchQuality, purgeOldMatchQualityLogs } from './ml/matchquality.js';
 import { trainLogisticRegression, extractFeatures, saveWeights, LTV_WEIGHTS_KV_KEY } from './ml/logistic.js';
+import { computeRoasFeedback, sendRoasAlert } from './ml/roas.js';
+import { runNurtureQueue } from './nurture.js';
 import { Env } from '../types.js';
 
 // ── Tipos ───────────────────────────────────────────────────────────────────────
@@ -57,6 +59,22 @@ export interface IntelligenceAgentResult {
     skipped?: string;
     error?: string;
   };
+  roasResult?: {
+    campaigns: number;
+    total_revenue: number;
+    best_campaign: string | null;
+    skipped?: string;
+  };
+  nurtureResult?: {
+    processed: number;
+    sent: number;
+    failed: number;
+  };
+  lookalikeResult?: {
+    sent: number;
+    seed_type: string;
+    skipped?: string;
+  };
 }
 
 export interface CustomerMatchResult {
@@ -330,11 +348,50 @@ export async function runIntelligenceAgent(
     }
   }
 
-  // 8. Customer Match sync semanal
+  // 8. Customer Match sync semanal (high_intent → Meta Audience)
   const cmResult = await syncMetaCustomAudience(env);
   console.log(`[Intelligence Agent] Customer Match Meta: sent=${cmResult?.sent ?? 0}, received=${cmResult?.received ?? 0}`);
 
-  console.log(`[Intelligence Agent] ${runType} concluído — LTV model, A/B auto-decide, match quality, customer match`);
+  // 9. ROAS Feedback Loop — cruza leads com compras reais por campanha
+  let roasResult: IntelligenceAgentResult['roasResult'] = undefined;
+  try {
+    const report = await computeRoasFeedback(env, 30);
+    if (report) {
+      roasResult = {
+        campaigns:     report.campaigns.length,
+        total_revenue: report.total_revenue,
+        best_campaign: report.best_campaign,
+      };
+      await sendRoasAlert(env, report);
+      console.log(`[Intelligence Agent] ROAS: ${report.campaigns.length} campanhas, R$${report.total_revenue} receita`);
+    } else {
+      roasResult = { campaigns: 0, total_revenue: 0, best_campaign: null, skipped: 'sem dados suficientes' };
+    }
+  } catch (err: any) {
+    console.error('[Intelligence Agent] ROAS error:', err?.message || String(err));
+  }
+
+  // 10. Nurture Queue — processa mensagens agendadas (D+1, D+3, D+7)
+  let nurtureResult: IntelligenceAgentResult['nurtureResult'] = undefined;
+  try {
+    const nr = await runNurtureQueue(env);
+    nurtureResult = { processed: nr.processed, sent: nr.sent, failed: nr.failed };
+    console.log(`[Intelligence Agent] Nurture: ${nr.sent}/${nr.processed} mensagens enviadas`);
+  } catch (err: any) {
+    console.error('[Intelligence Agent] Nurture error:', err?.message || String(err));
+  }
+
+  // 11. Lookalike Dinâmico — compradores confirmados → Meta Audience seed
+  let lookalikeResult: IntelligenceAgentResult['lookalikeResult'] = undefined;
+  try {
+    const lr = await syncMetaLookalikeSeed(env);
+    lookalikeResult = lr;
+    console.log(`[Intelligence Agent] Lookalike seed: sent=${lr.sent}, type=${lr.seed_type}`);
+  } catch (err: any) {
+    console.error('[Intelligence Agent] Lookalike error:', err?.message || String(err));
+  }
+
+  console.log(`[Intelligence Agent] ${runType} concluído — LTV, A/B, match quality, customer match, ROAS, nurture, lookalike`);
 
   return {
     versionResults,
@@ -343,6 +400,9 @@ export async function runIntelligenceAgent(
     abResult,
     mqAnalysis,
     cmResult,
+    roasResult,
+    nurtureResult,
+    lookalikeResult,
   };
 }
 
@@ -400,6 +460,99 @@ export async function syncMetaCustomAudience(env: Env): Promise<CustomerMatchRes
   }
 }
 
+// ── syncMetaLookalikeSeed — compradores confirmados → Meta Audience (Fase 7) ──
+// Seed de Lookalike mais preciso: usa quem REALMENTE comprou (Purchase event)
+// em vez de quem só teve intenção (cohort_label = high_intent).
+// Separado do syncMetaCustomAudience para não misturar seeds de qualidade diferente.
+
+export async function syncMetaLookalikeSeed(env: Env): Promise<{
+  sent: number;
+  seed_type: string;
+  skipped?: string;
+}> {
+  if (!env.META_ACCESS_TOKEN || !env.META_AUDIENCE_ID) {
+    return { sent: 0, seed_type: 'buyer_confirmed', skipped: 'META secrets não configurados' };
+  }
+  if (!env.DB) return { sent: 0, seed_type: 'buyer_confirmed', skipped: 'DB não disponível' };
+
+  try {
+    // Busca perfis de compradores confirmados (Purchase event nos últimos 60 dias)
+    const confirmed = await env.DB.prepare(`
+      SELECT DISTINCT up.email, up.phone, up.first_name, up.last_name
+      FROM user_profiles up
+      JOIN leads l ON l.user_id = up.user_id
+      WHERE l.event_name IN ('Purchase','purchase')
+        AND l.created_at >= datetime('now', '-60 days')
+        AND up.email IS NOT NULL
+      UNION
+      SELECT DISTINCT up.email, up.phone, up.first_name, up.last_name
+      FROM user_profiles up
+      JOIN quiz_sessions qs ON qs.user_id = up.user_id
+      WHERE qs.qualification = 'comprador'
+        AND qs.created_at >= datetime('now', '-30 days')
+        AND up.email IS NOT NULL
+      LIMIT 10000
+    `).all();
+
+    if (!confirmed.results?.length) {
+      return { sent: 0, seed_type: 'buyer_confirmed', skipped: 'nenhum comprador confirmado no período' };
+    }
+
+    const data = await Promise.all(
+      confirmed.results.map(async (p: any) => [
+        p.email ? await sha256(p.email) : '',
+        p.phone ? await sha256(p.phone) : '',
+      ])
+    );
+
+    const body = { payload: { schema: ['EMAIL_SHA256', 'PHONE_SHA256'], data } };
+    const endpoint = `https://graph.facebook.com/v22.0/${env.META_AUDIENCE_ID}/users`;
+
+    const res = await fetch(endpoint, {
+      method:  'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body:    JSON.stringify({ ...body, access_token: env.META_ACCESS_TOKEN }),
+    });
+
+    const result = await res.json() as any;
+
+    // Persiste histórico do seed
+    if (env.DB) {
+      await env.DB.prepare(`
+        INSERT INTO lookalike_seeds (audience_id, seed_type, profiles_sent, profiles_received, period_days)
+        VALUES (?, 'buyer_confirmed', ?, ?, 60)
+      `).bind(
+        env.META_AUDIENCE_ID,
+        confirmed.results.length,
+        result.num_received ?? null,
+      ).run().catch(() => {});
+    }
+
+    if (!res.ok) {
+      console.error('[Lookalike] Meta erro:', result.error?.message);
+      return { sent: 0, seed_type: 'buyer_confirmed', skipped: result.error?.message };
+    }
+
+    // Atualiza cohort_label dos compradores para buyer_confirmed
+    await env.DB.prepare(`
+      UPDATE user_profiles
+      SET cohort_label = 'buyer_confirmed', updated_at = datetime('now')
+      WHERE user_id IN (
+        SELECT DISTINCT user_id FROM leads
+        WHERE event_name IN ('Purchase','purchase')
+          AND created_at >= datetime('now', '-60 days')
+      )
+    `).run().catch(() => {});
+
+    console.log(`[Lookalike] ${confirmed.results.length} compradores confirmados enviados ao Meta`);
+    return { sent: confirmed.results.length, seed_type: 'buyer_confirmed' };
+
+  } catch (err: any) {
+    console.error('[Lookalike] syncMetaLookalikeSeed error:', err?.message || String(err));
+    return { sent: 0, seed_type: 'buyer_confirmed', skipped: err?.message };
+  }
+}
+
 // ── buildGoogleCustomerMatchExport — gera JSON para Google Ads Customer Match ─
 export async function buildGoogleCustomerMatchExport(env: Env): Promise<GoogleCustomerMatchExport[]> {
   if (!env.DB) return [];