cdp-edge 1.2.0

package/extracted-skill/tracking-events-generator/engagement-scoring.js

@@ -0,0 +1,226 @@
+/**
+ * ENGAGEMENT SCORING - CDP Edge (Quantum Tier)
+ *
+ * Cálculo preliminar de engajamento no browser.
+ * O cálculo final é feito no servidor para máxima precisão.
+ * @version 1.0.0
+ */
+
+// ── Configurações ──────────────────────────────────────────────────────
+const ENGAGEMENT_CONFIG = {
+  timeWeights: {
+    'curioso': 1.0,       // < 10s: score base 1.0
+    'interessado': 2.5,   // 10-60s: score base 2.5
+    'comprador': 4.0        // > 60s: score base 4.0
+  },
+  scrollWeights: {
+    'baixo': 1.0,           // < 25%: score base 1.0
+    'medio': 2.0,            // 25-75%: score base 2.0
+    'alto': 3.0               // > 75%: score base 3.0
+  },
+  clickWeights: {
+    'generico': 1.0,        // clique sem categoria
+    'cta': 2.5,              // clique em CTA
+    'button': 2.0             // clique em botão
+    'link': 1.5              // clique em link
+    'input': 0.5,            // clique em input
+  },
+  videoWeights: {
+    'play': 1.5,              // vídeo iniciou
+    'progress25': 2.0,        // 25% assistido
+    'progress50': 3.0,        // 50% assistido
+    'progress75': 4.0,        // 75% assistido
+    'complete': 5.0             // vídeo completo
+  },
+  hoverWeights: {
+    'curto': 1.0,             // < 3s: hover curto
+    'medio': 2.0,              // 3-10s: hover médio
+    'longo': 3.0               // > 10s: hover longo
+  }
+};
+
+// ── Estado Global ──────────────────────────────────────────────────────
+const engagementState = {
+  timeOnPage: 0,
+  scrollDepth: 0,
+  clicksCount: 0,
+  videoEngagement: 0,
+  ctaHoverTime: 0,
+  lastActivityTime: Date.now()
+};
+
+// ── Calculadoras ──────────────────────────────────────────────────────────────
+
+/**
+ * Calcular score de tempo na página
+ * @param {number} timeOnPage - Tempo em segundos desde o carregamento
+ * @returns {object} Score e nível de intenção
+ */
+function calculateTimeScore(timeOnPage) {
+  let level = 'curioso';
+  let score = ENGAGEMENT_CONFIG.timeWeights.curioso;
+
+  if (timeOnPage >= 10 && timeOnPage < 60) {
+    level = 'interessado';
+    score = ENGAGEMENT_CONFIG.timeWeights.interessado;
+  } else if (timeOnPage >= 60) {
+    level = 'comprador';
+    score = ENGAGEMENT_CONFIG.timeWeights.comprador;
+  }
+
+  return { score, level };
+}
+
+/**
+ * Calcular score de scroll
+ * @param {number} scrollDepth - Porcentagem de scroll (0-100)
+ * @returns {object} Score e nível
+ */
+function calculateScrollScore(scrollDepth) {
+  let level = 'baixo';
+  let score = ENGAGEMENT_CONFIG.scrollWeights.baixo;
+
+  if (scrollDepth >= 25 && scrollDepth < 75) {
+    level = 'medio';
+    score = ENGAGEMENT_CONFIG.scrollWeights.medio;
+  } else if (scrollDepth >= 75) {
+    level = 'alto';
+    score = ENGAGEMENT_CONFIG.scrollWeights.alto;
+  }
+
+  return { score, level };
+}
+
+/**
+ * Calcular score de cliques
+ * @param {number} clicksCount - Número de cliques
+ * @param {string} clickCategory - Categoria do clique
+ * @returns {number} Score de clique
+ */
+function calculateClickScore(clicksCount, clickCategory) {
+  const baseScore = ENGAGEMENT_CONFIG.clickWeights.generico;
+  const categoryBonus = ENGAGEMENT_CONFIG.clickWeights[clickCategory] || 1.0;
+
+  // Penalidade para cliques excessivos (após 50 cliques)
+  const clickPenalty = Math.max(0, 1 - (clicksCount / 50));
+
+  return baseScore + categoryBonus;
+}
+
+/**
+ * Calcular score de vídeo
+ * @param {string} videoEvent - Tipo de evento de vídeo
+ * @returns {number} Score de vídeo
+ */
+function calculateVideoScore(videoEvent) {
+  return ENGAGEMENT_CONFIG.videoWeights[videoEvent] || 0;
+}
+
+/**
+ * Calcular score de hover no CTA
+ * @param {number} hoverTime - Tempo em segundos de hover
+ * @returns {number} Score de hover
+ */
+function calculateHoverScore(hoverTime) {
+  let level = 'curto';
+  let score = ENGAGEMENT_CONFIG.hoverWeights.curto;
+
+  if (hoverTime >= 3 && hoverTime < 10) {
+    level = 'medio';
+    score = ENGAGEMENT_CONFIG.hoverWeights.medio;
+  } else if (hoverTime >= 10) {
+    level = 'longo';
+    score = ENGAGEMENT_CONFIG.hoverWeights.longo;
+  }
+
+  return { score, level };
+}
+
+// ── Função Principal de Cálculo ──────────────────────────────────────────────
+
+/**
+ * Calcular score de engajamento total (browser-side preliminar)
+ * @returns {object} Score, nível, componentes
+ */
+function calculateEngagementScore() {
+  // 1. Score de tempo
+  const { score: timeScore, level: timeLevel } = calculateTimeScore(engagementState.timeOnPage);
+
+  // 2. Score de scroll
+  const { score: scrollScore } = calculateScrollScore(engagementState.scrollDepth);
+
+  // 3. Score de cliques (com base na média)
+  const clickScore = engagementState.clicksCount > 0
+    ? calculateClickScore(engagementState.clicksCount, 'generico')
+    : 0;
+
+  // 4. Score de vídeo
+  const videoScore = engagementState.videoEngagement;
+
+  // 5. Score de hover no CTA
+  const hoverScore = engagementState.ctaHoverTime > 0
+    ? calculateHoverScore(engagementState.ctaHoverTime / 1000)
+    : 0;
+
+  // 6. Cálculo ponderado
+  const totalScore = (
+    (timeScore * 0.3) +      // 30% peso para tempo
+    (scrollScore * 0.2) +     // 20% peso para scroll
+    (clickScore * 0.15) +    // 15% peso para cliques
+    (videoScore * 0.25) +      // 25% peso para vídeo
+    (hoverScore * 0.1)        // 10% peso para hover
+  );
+
+  // 7. Nível final de intenção
+  let intentionLevel = timeLevel;
+  if (totalScore < 1.5) {
+    intentionLevel = 'curioso';
+  } else if (totalScore < 2.5) {
+    intentionLevel = 'interessado';
+  } else {
+    intentionLevel = 'comprador';
+  }
+
+  return {
+    totalScore: Math.min(totalScore, 5.0),
+    timeScore,
+    scrollScore,
+    clickScore,
+    videoScore,
+    hoverScore,
+    intentionLevel,
+    components: {
+      timeOnPage: engagementState.timeOnPage,
+      scrollDepth: engagementState.scrollDepth,
+      clicksCount: engagementState.clicksCount,
+      videoEngagement: engagementState.videoEngagement,
+      ctaHoverTime: engagementState.ctaHoverTime
+    }
+  };
+}
+
+// ── Atualizador de Estado ──────────────────────────────────────────────────────
+
+/**
+ * Atualizar estado de engajamento
+ * @param {string} component - Componente a atualizar
+ * @param {any} value - Novo valor
+ */
+function updateEngagementState(component, value) {
+  engagementState[component] = value;
+  engagementState.lastActivityTime = Date.now();
+}
+
+// ── Exportações ─────────────────────────────────────────────────────────────────────
+
+export {
+  calculateTimeScore,
+  calculateScrollScore,
+  calculateClickScore,
+  calculateVideoScore,
+  calculateHoverScore,
+  calculateEngagementScore,
+  updateEngagementState,
+  engagementState,
+  ENGAGEMENT_CONFIG
+};

package/extracted-skill/tracking-events-generator/evals/evals.json

@@ -0,0 +1,235 @@
+{
+  "skill_name": "tracking-events-generator",
+  "evals": [
+    {
+      "id": 1,
+      "group": "browser-only",
+      "note": "Eval legado — testa output browser-only (sem Cloudflare). Mantido para retrocompatibilidade.",
+      "prompt": "Cria os eventos de tracking para minha página de imóvel em SBC (São Bernardo do Campo), apartamento de 260m², 3 vagas de garagem, bairro nobre. Preciso rastrear para Meta Ads e Google Ads.",
+      "expected_output": "Código completo com Meta Pixel base (PageView), ViewContent com parâmetros de imóvel (city: São Bernardo do Campo, region: SP, content_type: home_listing, property_size: 260), evento Lead para formulário, evento Contact para WhatsApp, Google Ads global tag com evento de conversão para lead, e instruções de implementação.",
+      "assertions": [
+        {
+          "name": "contem_meta_pixel_base",
+          "type": "contains",
+          "value": "fbq('init'"
+        },
+        {
+          "name": "contem_pageview",
+          "type": "contains",
+          "value": "PageView"
+        },
+        {
+          "name": "contem_viewcontent",
+          "type": "contains",
+          "value": "ViewContent"
+        },
+        {
+          "name": "contem_home_listing",
+          "type": "contains",
+          "value": "home_listing"
+        },
+        {
+          "name": "contem_sbc_ou_sao_bernardo",
+          "type": "contains_any",
+          "value": ["São Bernardo", "sao_bernardo", "SBC", "s_o_bernardo"]
+        },
+        {
+          "name": "contem_google_ads_tag",
+          "type": "contains",
+          "value": "gtag"
+        },
+        {
+          "name": "contem_evento_lead",
+          "type": "contains",
+          "value": "Lead"
+        },
+        {
+          "name": "contem_evento_contact",
+          "type": "contains",
+          "value": "Contact"
+        },
+        {
+          "name": "contem_instrucoes_implementacao",
+          "type": "contains_any",
+          "value": ["implementar", "Implementar", "IMPLEMENTAR", "colar", "Colar", "head"]
+        }
+      ],
+      "files": []
+    },
+    {
+      "id": 2,
+      "group": "browser-only",
+      "note": "Eval legado — testa output browser-only (sem Cloudflare). Mantido para retrocompatibilidade.",
+      "prompt": "Preciso de tracking para uma página de vendas do meu curso online de Excel avançado, valor R$497. Quero rastrear Meta Pixel e Google Ads. A página tem um botão de compra que vai para o checkout da Hotmart.",
+      "expected_output": "Código com Meta Pixel base, ViewContent para produto digital (content_type: product, value: 497, currency: BRL), InitiateCheckout no clique do botão de compra, Purchase na página de obrigado, Google Ads com evento de conversão de compra, e instruções sobre como capturar o Purchase na Hotmart.",
+      "assertions": [
+        {
+          "name": "contem_meta_pixel",
+          "type": "contains",
+          "value": "fbq('init'"
+        },
+        {
+          "name": "contem_viewcontent",
+          "type": "contains",
+          "value": "ViewContent"
+        },
+        {
+          "name": "contem_initiate_checkout",
+          "type": "contains",
+          "value": "InitiateCheckout"
+        },
+        {
+          "name": "contem_purchase",
+          "type": "contains",
+          "value": "Purchase"
+        },
+        {
+          "name": "contem_valor_497",
+          "type": "contains_any",
+          "value": ["497", "497.00"]
+        },
+        {
+          "name": "contem_currency_brl",
+          "type": "contains",
+          "value": "BRL"
+        },
+        {
+          "name": "contem_google_ads",
+          "type": "contains",
+          "value": "gtag"
+        },
+        {
+          "name": "menciona_hotmart",
+          "type": "contains",
+          "value": "Hotmart"
+        }
+      ],
+      "files": []
+    },
+    {
+      "id": 3,
+      "group": "browser-only",
+      "note": "Eval legado — testa output browser-only (sem Cloudflare). Mantido para retrocompatibilidade.",
+      "prompt": "Minha clínica de estética tem uma página de agendamento de consulta. Quero rastrear quando alguém visualiza a página, quando clica no WhatsApp e quando preenche o formulário de agendamento. Usa só o Meta Pixel por enquanto, não precisa do Google Ads.",
+      "expected_output": "Código com Meta Pixel base, PageView, ViewContent para serviço, evento Contact no clique do WhatsApp, evento Schedule no envio do formulário de agendamento. Não deve incluir código do Google Ads (somente Meta Pixel conforme solicitado).",
+      "assertions": [
+        {
+          "name": "contem_meta_pixel",
+          "type": "contains",
+          "value": "fbq('init'"
+        },
+        {
+          "name": "contem_pageview",
+          "type": "contains",
+          "value": "PageView"
+        },
+        {
+          "name": "contem_contact_whatsapp",
+          "type": "contains",
+          "value": "Contact"
+        },
+        {
+          "name": "contem_schedule",
+          "type": "contains",
+          "value": "Schedule"
+        },
+        {
+          "name": "nao_deve_ter_google_ads_obrigatorio",
+          "type": "note",
+          "value": "Google Ads não solicitado — verificar se o skill respeitou essa restrição ou ofereceu como opcional"
+        }
+      ],
+      "files": []
+    },
+    {
+      "id": 4,
+      "group": "tier10",
+      "note": "Eval Quantum Tier — verifica padrões Cloudflare Native (cdpTrack SDK + Worker server-side).",
+      "prompt": "Cria o tracking completo Quantum Tier para uma página de vendas de curso online (R$997). Preciso de Meta CAPI v22.0 + GA4 + TikTok, com Worker Cloudflare. O botão de compra vai para o checkout da Hotmart.",
+      "expected_output": "tracking.js com cdpTrack.track(), worker.js com endpoints /track e /webhook/hotmart, deduplicação por event_id, SHA-256 via crypto.subtle, D1 para persistência, event_id idêntico entre browser e servidor.",
+      "assertions": [
+        {
+          "name": "usa_cdptrack_sdk",
+          "type": "contains",
+          "value": "cdpTrack.track("
+        },
+        {
+          "name": "usa_worker_endpoint",
+          "type": "contains_any",
+          "value": ["/track", "cdpTrack"]
+        },
+        {
+          "name": "contem_event_id_dedup",
+          "type": "contains",
+          "value": "event_id"
+        },
+        {
+          "name": "contem_capi_v22",
+          "type": "contains",
+          "value": "v22.0"
+        },
+        {
+          "name": "contem_sha256_webcrypto",
+          "type": "contains",
+          "value": "crypto.subtle"
+        },
+        {
+          "name": "contem_purchase",
+          "type": "contains",
+          "value": "Purchase"
+        },
+        {
+          "name": "contem_initiate_checkout",
+          "type": "contains",
+          "value": "InitiateCheckout"
+        },
+        {
+          "name": "contem_currency_brl",
+          "type": "contains",
+          "value": "BRL"
+        }
+      ],
+      "files": []
+    },
+    {
+      "id": 5,
+      "group": "tier10",
+      "note": "Eval Quantum Tier — verifica tratamento correto de webhook de compra com D1 match.",
+      "prompt": "Meu Worker Cloudflare recebe webhook da Kiwify. Preciso que ele recupere o fbp/fbc do D1 pelo email do comprador e dispare o Purchase para Meta CAPI v22.0 e TikTok Events API v1.3.",
+      "expected_output": "Worker com handler /webhook/kiwify, lookup de user_profiles no D1 por email, payload com fbp/fbc recuperados, SHA-256 de email e telefone, event_id = kiwify_{order_id}, endpoint Meta v22.0, endpoint TikTok v1.3.",
+      "assertions": [
+        {
+          "name": "contem_webhook_kiwify",
+          "type": "contains",
+          "value": "/webhook/kiwify"
+        },
+        {
+          "name": "recupera_fbp_do_d1",
+          "type": "contains_any",
+          "value": ["profile?.fbp", "profile.fbp", "getProfileByEmail"]
+        },
+        {
+          "name": "usa_capi_v22",
+          "type": "contains",
+          "value": "v22.0"
+        },
+        {
+          "name": "usa_tiktok_v13",
+          "type": "contains",
+          "value": "v1.3"
+        },
+        {
+          "name": "contem_sha256",
+          "type": "contains",
+          "value": "SHA-256"
+        },
+        {
+          "name": "contem_event_id_kiwify",
+          "type": "contains_any",
+          "value": ["kiwify_", "order_id"]
+        }
+      ],
+      "files": []
+    }
+  ]
+}