cdp-edge 1.18.0 → 2.0.1

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

@@ -1,226 +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
-};
+/**
+ * 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
+};