cdp-edge 1.2.0

package/extracted-skill/tracking-events-generator/agents/intelligence-scheduling.md

@@ -0,0 +1,643 @@
+# Intelligence Agent — Configuração de Scheduling Automático
+
+Este arquivo documenta como configurar o Intelligence Agent para rodar automaticamente em intervalos regulares, garantindo que o ecossistema CDP Edge esteja sempre atualizado com as últimas versões de API e conformidades de privacidade.
+
+---
+
+## 📅 VISÃO GERAL DO SCHEDULING
+
+O Intelligence Agent possui três níveis de execução automática:
+
+| Tipo | Frequência | Horário | Objetivo | Impacto |
+|-------|-------------|----------|-----------|----------|
+| **Semanal** | Domingo 02:00 UTC | Verificação completa de versões | 🔴 CRÍTICO |
+| **Mensal** | 1º do mês 03:00 UTC | Auditoria de privacidade + depreciações | 🔴 CRÍTICO |
+| **On-Demand** | A qualquer momento | Check específico quando houver suspeita | 🟠 HIGH |
+
+---
+
+## 🚀 IMPLEMENTAÇÃO NO CLOUDFLARE WORKER
+
+### PASSO 1 — Configurar Triggers no wrangler.toml
+
+Adicionar ao arquivo `server-edge-tracker/wrangler.toml` (ou `wrangler.toml` do Worker):
+
+```toml
+# ===========================================
+# INTELLIGENCE AGENT — SCHEDULING
+# ===========================================
+
+# Trigger Semanal — Domingo 02:00 UTC (Verificação de versões de API)
+[[triggers.crons]]
+cron = "0 2 * * 0"
+schedule = "weekly-intelligence-check"
+
+# Trigger Mensal — 1º do mês 03:00 UTC (Auditoria de privacidade + depreciações)
+[[triggers.crons]]
+cron = "0 3 1 * *"
+schedule = "monthly-privacy-audit"
+
+# Variáveis de ambiente para controlar o scheduling
+[vars]
+INTELLIGENCE_ENABLED = true
+INTELLIGENCE_WEEKLY_CRON = "0 2 * * 0"
+INTELLIGENCE_MONTHLY_CRON = "0 3 1 * *"
+INTELLIGENCE_ALERT_ENABLED = true
+```
+
+---
+
+### PASSO 2 — Adicionar Handlers no worker.js
+
+Adicionar ao arquivo `server-edge-tracker/worker.js`:
+
+```javascript
+// ===========================================
+// INTELLIGENCE AGENT — SCHEDULING
+// ===========================================
+
+/**
+ * Handler Semanal — Check completo de versões de API
+ * Roda: Domingo 02:00 UTC
+ * Objetivo: Garantir que todas as APIs estejam atualizadas
+ */
+export async function runIntelligenceWeekly(env, ctx) {
+  console.log('🕵️‍♂️ Intelligence Agent — Check Semanal iniciado');
+  console.log('📅 Horário:', new Date().toISOString());
+
+  try {
+    const platforms = ['meta', 'google', 'tiktok', 'pinterest', 'reddit'];
+    const issues = [];
+
+    for (const platform of platforms) {
+      const result = await checkApiVersion(platform, env);
+      if (result.issue) {
+        issues.push(result);
+      }
+      console.log(`✅ ${platform.toUpperCase()}: ${result.status}`);
+    }
+
+    // Se houver problemas, disparar alerta
+    if (issues.length > 0) {
+      await dispatchIntelligenceAlert('API_VERSION_CHECK', issues, env);
+    }
+
+    // Logar resultado no D1
+    await logIntelligenceRun('weekly', platforms, issues, env);
+
+    console.log('✅ Intelligence Agent — Check Semanal concluído');
+
+  } catch (error) {
+    console.error('❌ Erro no Check Semanal:', error);
+    await dispatchIntelligenceAlert('WEEKLY_CHECK_ERROR', error.message, env);
+  }
+}
+
+/**
+ * Handler Mensal — Auditoria de privacidade + depreciações
+ * Roda: 1º do mês 03:00 UTC
+ * Objetivo: Garantir conformidade LGPD/GDPR/CCPA e verificar depreciações
+ */
+export async function runIntelligenceMonthly(env, ctx) {
+  console.log('🕵️‍♂️ Intelligence Agent — Auditoria Mensal iniciado');
+  console.log('📅 Horário:', new Date().toISOString());
+
+  try {
+    const issues = [];
+
+    // 1. Check de privacidade
+    const privacyIssues = await auditPrivacyCompliance(env);
+    issues.push(...privacyIssues);
+
+    // 2. Check de depreciações de API
+    const deprecationIssues = await checkApiDepreciations(env);
+    issues.push(...deprecationIssues);
+
+    // 3. Check de novos parâmetros de Event Match Quality
+    const matchQualityIssues = await checkNewMatchQualityParams(env);
+    issues.push(...matchQualityIssues);
+
+    // Se houver problemas, disparar alerta
+    if (issues.length > 0) {
+      await dispatchIntelligenceAlert('MONTHLY_AUDIT', issues, env);
+    }
+
+    // Logar resultado no D1
+    await logIntelligenceRun('monthly', [], issues, env);
+
+    console.log('✅ Intelligence Agent — Auditoria Mensal concluída');
+
+  } catch (error) {
+    console.error('❌ Erro na Auditoria Mensal:', error);
+    await dispatchIntelligenceAlert('MONTHLY_AUDIT_ERROR', error.message, env);
+  }
+}
+
+// ===========================================
+// FUNÇÕES DE CHECK DE API VERSION
+// ===========================================
+
+async function checkApiVersion(platform, env) {
+  const apiUrls = {
+    meta: 'https://graph.facebook.com/v22.0/',
+    google: 'https://www.google-analytics.com/mp/collect',
+    tiktok: 'https://business-api.tiktok.com/open_api/v1.3/',
+    pinterest: 'https://api.pinterest.com/v5/',
+    reddit: 'https://ads-api.reddit.com/api/v2.0/'
+  };
+
+  const minimumVersions = {
+    meta: 'v22.0',
+    google: 'v2',
+    tiktok: 'v1.3',
+    pinterest: 'v5',
+    reddit: 'v2.0'
+  };
+
+  try {
+    const response = await fetch(apiUrls[platform], {
+      method: 'GET',
+      headers: {
+        'User-Agent': 'CDP Edge/1.0-Intelligence-Agent'
+      }
+    });
+
+    if (response.ok) {
+      return {
+        platform,
+        status: 'current',
+        issue: false
+      };
+    } else {
+      return {
+        platform,
+        status: 'error',
+        issue: true,
+        error: `HTTP ${response.status}`
+      };
+    }
+
+  } catch (error) {
+    return {
+      platform,
+      status: 'unreachable',
+      issue: true,
+      error: error.message
+    };
+  }
+}
+
+// ===========================================
+// FUNÇÕES DE AUDITORIA DE PRIVACIDADE
+// ===========================================
+
+async function auditPrivacyCompliance(env) {
+  const issues = [];
+
+  // 1. Check: Google Consent Mode v2
+  const consentModeFiles = [
+    'tracking.js',
+    'tracking.config.js'
+  ];
+
+  for (const file of consentModeFiles) {
+    try {
+      const content = await readFile(file);
+      const hasConsentMode = content.includes('ad_storage') &&
+                            content.includes('analytics_storage') &&
+                            content.includes('ad_user_data') &&
+                            content.includes('ad_personalization');
+
+      const hasUrlPassthrough = content.includes('url_passthrough: true');
+
+      if (!hasConsentMode) {
+        issues.push({
+          platform: 'google',
+          issue: 'Consent Mode v2 não está implementado',
+          severity: 'CRITICAL',
+          fix: 'Implementar ad_storage=denied, analytics_storage=denied, etc. no browser-tracking.md',
+          file: file
+        });
+      }
+
+      if (!hasUrlPassthrough) {
+        issues.push({
+          platform: 'google',
+          issue: 'url_passthrough: true não está ativo',
+          severity: 'HIGH',
+          fix: 'Adicionar url_passthrough: true no gtag config',
+          file: file
+        });
+      }
+
+    } catch (error) {
+      console.log(`⚠️ Não foi possível auditar ${file}:`, error.message);
+    }
+  }
+
+  // 2. Check: Hashing de PII no servidor
+  const serverFiles = ['worker.js', 'meta-dispatcher.js'];
+  const hashCheck = content.includes('crypto.subtle.digest');
+
+  for (const file of serverFiles) {
+    try {
+      const content = await readFile(file);
+
+      if (!hashCheck) {
+        issues.push({
+          platform: 'meta/tiktok/pinterest/reddit',
+          issue: 'PII enviada sem SHA-256 hashing',
+          severity: 'CRITICAL',
+          fix: 'Usar crypto.subtle.digest para email/phone no worker.js',
+          file: file
+        });
+      }
+
+    } catch (error) {
+      console.log(`⚠️ Não foi possível auditar ${file}:`, error.message);
+    }
+  }
+
+  return issues;
+}
+
+// ===========================================
+// FUNÇÕES DE CHECK DE DEPRECIAÇÕES
+// ===========================================
+
+async function checkApiDepreciations(env) {
+  const deprecationSchedule = {
+    meta: {
+      'v20.0': { deprecated: true, cutoff: '2024-01-01', replacement: 'v22.0' },
+      'v21.0': { deprecated: true, cutoff: '2024-06-01', replacement: 'v22.0' }
+    },
+    tiktok: {
+      'v1.2': { deprecated: true, cutoff: '2024-03-01', replacement: 'v1.3' }
+    },
+    pinterest: {
+      'v4': { deprecated: true, cutoff: '2024-01-01', replacement: 'v5' }
+    },
+    reddit: {
+      'v1.0': { deprecated: true, cutoff: '2024-06-01', replacement: 'v2.0' }
+    }
+  };
+
+  const currentVersions = {
+    meta: env.META_API_VERSION || 'unknown',
+    tiktok: env.TIKTOK_API_VERSION || 'unknown',
+    pinterest: env.PINTEREST_API_VERSION || 'unknown',
+    reddit: env.REDDIT_API_VERSION || 'unknown'
+  };
+
+  const issues = [];
+
+  for (const [platform, version] of Object.entries(currentVersions)) {
+    if (deprecationSchedule[platform]?.[version]) {
+      const { deprecated, cutoff, replacement } = deprecationSchedule[platform][version];
+
+      if (deprecated) {
+        issues.push({
+          platform,
+          issue: `API version ${version} está descontinuada`,
+          severity: 'CRITICAL',
+          cutoff_date: cutoff,
+          replacement_version: replacement,
+          fix: `Atualizar para ${replacement}`,
+          action_required: 'IMEDIATO',
+          deadline: cutoff
+        });
+      }
+    }
+  }
+
+  return issues;
+}
+
+// ===========================================
+// FUNÇÕES DE CHECK DE NOVOS PARÂMETROS
+// ===========================================
+
+async function checkNewMatchQualityParams(env) {
+  const platforms = {
+    meta: 'https://developers.facebook.com/docs/marketing-api/conversions-api/parameters',
+    google: 'https://support.google.com/analytics/answer/9267733',
+    tiktok: 'https://ads.tiktok.com/marketing_api/docs?id=1740465605569281'
+  };
+
+  const issues = [];
+
+  for (const [platform, docsUrl] of Object.entries(platforms)) {
+    try {
+      // Em produção, usar WebFetch/MCP para parsing mais preciso
+      const response = await fetch(docsUrl);
+
+      if (!response.ok) {
+        continue;
+      }
+
+      // Placeholder para parsear novos parâmetros
+      // Na implementação real, extrair parâmetros novos da documentação
+      const newParams = extractNewParametersFromDocs(await response.text(), platform);
+
+      if (newParams.length > 0) {
+        issues.push({
+          platform,
+          issue: 'Novos parâmetros de Event Match Quality disponíveis',
+          severity: 'MEDIUM',
+          new_params: newParams,
+          fix: `Adicionar novos parâmetros: ${newParams.join(', ')}`,
+          documentation_url: docsUrl
+        });
+      }
+
+    } catch (error) {
+      console.log(`⚠️ Não foi possível verificar docs de ${platform}:`, error.message);
+    }
+  }
+
+  return issues;
+}
+
+// ===========================================
+// FUNÇÕES DE ALERTA
+// ===========================================
+
+async function dispatchIntelligenceAlert(alertType, data, env) {
+  const alertMessages = {
+    'API_VERSION_CHECK': '🚨 VERIFICAÇÃO DE VERSÃO DE API',
+    'MONTHLY_AUDIT': '🔍 AUDITORIA MENSAL DE PRIVACIDADE',
+    'WEEKLY_CHECK_ERROR': '❌ ERRO NO CHECK SEMANAL',
+    'MONTHLY_AUDIT_ERROR': '❌ ERRO NA AUDITORIA MENSAL'
+  };
+
+  const message = `
+${alertMessages[alertType]}
+
+Timestamp: ${new Date().toISOString()}
+Details: ${JSON.stringify(data, null, 2)}
+
+Ação necessária: Verificar os detalhes acima e implementar correções.
+  `.trim();
+
+  // Enviar via WhatsApp Agent (se configurado)
+  if (env.WA_PHONE_ID && env.ADMIN_PHONE_NUMBER) {
+    await fetch(`https://graph.facebook.com/v22.0/${env.WA_PHONE_ID}/messages`, {
+      method: 'POST',
+      headers: {
+        'Content-Type': 'application/json',
+        'Authorization': `Bearer ${env.WA_ACCESS_TOKEN}`
+      },
+      body: JSON.stringify({
+        messaging_product: 'whatsapp',
+        to: env.ADMIN_PHONE_NUMBER,
+        type: 'text',
+        text: message
+      })
+    });
+  }
+
+  // Fallback para CallMeBot
+  else if (env.ADMIN_PHONE_NUMBER) {
+    await fetch(`https://api.callmebot.com/send.php`, {
+      method: 'POST',
+      body: new URLSearchParams({
+        phone: env.ADMIN_PHONE_NUMBER,
+        text: message
+      })
+    });
+  }
+
+  console.log('📤 Alerta enviado:', alertType);
+}
+
+// ===========================================
+// FUNÇÕES DE LOGGING
+// ===========================================
+
+async function logIntelligenceRun(runType, platforms, issues, env) {
+  if (!env.DB) return;
+
+  await env.DB.prepare(`
+    INSERT INTO intelligence_logs (run_type, platforms_checked, issues_found, created_at)
+    VALUES (?, ?, ?, ?)
+  `).bind(
+    runType,
+    JSON.stringify(platforms),
+    JSON.stringify(issues),
+    new Date().toISOString()
+  ).run();
+}
+```
+
+---
+
+### PASSO 3 — Atualizar Schema D1 (se necessário)
+
+Adicionar ao `server-edge-tracker/schema.sql`:
+
+```sql
+-- TABELA DE LOGS DO INTELLIGENCE AGENT
+CREATE TABLE IF NOT EXISTS intelligence_logs (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  run_type TEXT NOT NULL,              -- 'weekly' | 'monthly' | 'on-demand'
+  platforms_checked TEXT,               -- JSON array de plataformas verificadas
+  issues_found TEXT,                    -- JSON array de issues encontradas
+  issues_count INTEGER DEFAULT 0,
+  created_at TEXT DEFAULT (datetime('now'))
+);
+
+-- ÍNDICE PARA QUERIES EFICIENTES
+CREATE INDEX IF NOT EXISTS idx_intel_logs_type ON intelligence_logs(run_type);
+CREATE INDEX IF NOT EXISTS idx_intel_logs_created ON intelligence_logs(created_at);
+```
+
+---
+
+### PASSO 4 — Atualizar Main Fetch Handler
+
+Adicionar ao handler principal do worker:
+
+```javascript
+export default {
+  async fetch(request, env, ctx) {
+    const url = new URL(request.url);
+
+    // Handler principal de tracking
+    if (url.pathname === '/api/track') {
+      return handleTracking(request, env, ctx);
+    }
+
+    // Handlers de Intelligence Agent (schedulados)
+    if (url.pathname === '/cron/intelligence-weekly') {
+      return await runIntelligenceWeekly(env, ctx);
+    }
+
+    if (url.pathname === '/cron/intelligence-monthly') {
+      return await runIntelligenceMonthly(env, ctx);
+    }
+
+    // Endpoint manual de check on-demand
+    if (url.pathname === '/api/intelligence/check') {
+      return await runIntelligenceWeekly(env, ctx);
+    }
+
+    return new Response('Not Found', { status: 404 });
+  }
+};
+```
+
+---
+
+## 🎯 CRITÉRIOS DE SUCESSO DO SCHEDULING
+
+### Check Semanal (Versões de API)
+
+- [ ] Todas as plataformas configuradas foram verificadas
+- [ ] Endpoints estão respondendo (200 OK)
+- [ ] Versões atuais estão documentadas no Memory Agent
+- [ ] Alertas foram disparados se houver problemas
+- [ ] Log foi salvo no D1 (intelligence_logs)
+
+### Auditoria Mensal (Privacidade + Depreciações)
+
+- [ ] Google Consent Mode v2 foi verificado
+- [ ] Hashing de PII foi verificado em todas as APIs
+- [ ] Depreciações foram verificadas (com cutoff date)
+- [ ] Novos parâmetros de Match Quality foram pesquisados
+- [ ] Todos os issues encontrados foram documentados
+- [ ] Alerta consolidado foi enviado ao admin
+
+### Métricas de Eficiência
+
+O Intelligence Agent deve calcular e reportar:
+
+```json
+{
+  "intelligence_metrics": {
+    "weekly_checks": {
+      "total": 52,
+      "successful": 50,
+      "failed": 2,
+      "issues_detected": 3,
+      "uptime_percentage": "96.15%"
+    },
+    "monthly_audits": {
+      "total": 12,
+      "successful": 12,
+      "failed": 0,
+      "privacy_issues": 0,
+      "deprecation_issues": 1,
+      "compliance_rate": "100%"
+    },
+    "avg_response_time_minutes": 2.3,
+    "alert_sent_rate": "100%"
+  }
+}
+```
+
+---
+
+## 🔧 CONFIGURAÇÃO DE VARIÁVEIS DE AMBIENTE
+
+Adicionar ao `wrangler.toml` ou via `wrangler secret put`:
+
+```bash
+# Secrets necessários para o Intelligence Agent
+wrangler secret put INTELLIGENCE_ENABLED --name server-edge-tracker
+wrangler secret put WA_PHONE_ID --name server-edge-tracker
+wrangler secret put WA_ACCESS_TOKEN --name server-edge-tracker
+wrangler secret put ADMIN_PHONE_NUMBER --name server-edge-tracker
+
+# Valores recomendados:
+# INTELLIGENCE_ENABLED = true
+# WA_PHONE_ID = seu_phone_id_do_whatsapp
+# WA_ACCESS_TOKEN = seu_access_token_da_meta
+# ADMIN_PHONE_NUMBER = +5511999999999
+```
+
+---
+
+## 📈 MONITORAMENTO DOS SCHEDULES
+
+Após implementar, monitorar via Cloudflare Dashboard:
+
+1. **Cron Triggers**: Verificar se os jobs estão rodando nos horários programados
+2. **Success Rate**: Verificar se as chamadas estão terminando com sucesso
+3. **Execution Time**: Monitorar o tempo de execução (deve ser < 5 minutos)
+4. **Error Logs**: Verificar logs do Worker para erros nos handlers de intelligence
+5. **Database Growth**: Monitorar crescimento da tabela `intelligence_logs`
+
+---
+
+## 🚨 REGRAS DE ALERTA
+
+1. **Não Spam**: Não disparar alerta se o mesmo problema já foi reportado nas últimas 24h
+2. **Prioridade Correta**: CRITICAL (agora), HIGH (até 1h), MEDIUM (relatório)
+3. **Informação Útil**: Incluir sempre timestamp, plataforma, e ação necessária
+4. **Backoff de Tentativa**: Se o envio de alerta falhar, tentar novamente em 10 minutos (máximo 3 tentativas)
+5. **Log de Falhas de Alerta**: Se o WhatsApp Agent falhar 3 vezes consecutivas, registrar no D1 e notificar via outro canal
+
+---
+
+## ✅ CHECKLIST DE IMPLEMENTAÇÃO DO SCHEDULING
+
+Antes de considerar o scheduling implementado, verificar:
+
+- [ ] Cron triggers adicionados ao wrangler.toml
+- [ ] Handlers de weekly/monthly adicionados ao worker.js
+- [ ] Schema D1 atualizado com tabela intelligence_logs
+- [ ] Funções de check de versão implementadas
+- [ ] Funções de auditoria de privacidade implementadas
+- [ ] Sistema de alerta (WhatsApp/CallMeBot) integrado
+- [ ] Logs de execução sendo salvos no D1
+- [ ] Memory Agent está sendo atualizado após cada check
+- [ ] Backoff implementado para evitar spam de alertas
+- [ ] Teste manual executado (/api/intelligence/check)
+- [ ] Documentação atualizada com instruções de troubleshooting
+
+---
+
+> 📅 **Objetivo Final:** Garantir que o ecossistema CDP Edge esteja sempre atualizado com as últimas versões de API e em conformidade com LGPD/GDPR/CCPA, sem necessidade de intervenção manual constante.
+
+---
+
+## INPUTS RECEBIDOS
+
+- `wrangler.toml` do Worker (para injetar Cron Triggers)
+- `worker.js` (para injetar handlers de scheduled events)
+- `schema.sql` (para adicionar tabela `intelligence_logs`)
+- Secrets: `WA_PHONE_ID`, `WA_ACCESS_TOKEN`, `ADMIN_PHONE_NUMBER` (para alertas)
+- `contracts/api-versions.json` (fonte de verdade das versões atuais)
+
+## RESPONSABILIDADE
+
+- Configurar Cron Triggers no `wrangler.toml`: semanal (domingo 02:00 UTC) e mensal (dia 1 às 03:00 UTC)
+- Implementar `runIntelligenceWeekly()` e `runIntelligenceMonthly()` no Worker
+- Adicionar tabela `intelligence_logs` ao schema D1
+- Disparar alertas WhatsApp/CallMeBot ao admin apenas quando houver issues críticos
+- Evitar spam: não repetir alerta do mesmo issue em menos de 24h
+- Registrar resultado de cada execução no D1 (`intelligence_logs`)
+
+## SAÍDA
+
+```json
+{
+  "arquivos_modificados": [
+    "wrangler.toml (cron triggers adicionados)",
+    "worker.js (handlers weekly/monthly adicionados)",
+    "schema.sql (tabela intelligence_logs adicionada)"
+  ],
+  "crons_configurados": {
+    "semanal": "0 2 * * 0 (domingo 02:00 UTC — check de versões)",
+    "mensal":  "0 3 1 * * (dia 1 03:00 UTC — auditoria privacidade)"
+  },
+  "endpoint_manual": "GET /api/intelligence/check",
+  "alertas": {
+    "canal_primario": "WhatsApp Meta Cloud API v22.0",
+    "canal_fallback": "CallMeBot",
+    "anti_spam": "24h cooldown por issue"
+  },
+  "d1_tabela": "intelligence_logs",
+  "secrets_necessarios": ["WA_PHONE_ID", "WA_ACCESS_TOKEN", "ADMIN_PHONE_NUMBER"]
+}
+```

package/extracted-skill/tracking-events-generator/agents/linkedin-agent.md

@@ -0,0 +1,62 @@
+# LinkedIn Agent (Insight Navigator) — CDP Edge
+
+Você é o **Arquiteto de Elite de LinkedIn Insight Tag (B2B Full-Funnel)** do CDP Edge.
+A rede B2B não perdoa erros de rastreamento. Sua missão é entregar o código exigido pelo LinkedIn Campaign Manager para obter a **nota máxima de rastreabilidade**, reduzindo o custo absurdo dos cliques do LinkedIn.
+
+---
+
+## 🏢 DOCUMENTAÇÃO E REGRAS DA INSIGHT TAG (TIER 8)
+
+Para garantir que a conta de anúncios não sofra penalizações e cruze dados de executivos correntamente:
+
+1. **Partner ID Mestre (`_pid`)**: A tag global deve ser instalada impecavelmente para iniciar a auditoria de domínios.
+2. **Event-Specific Conversions (Gatilhos Ouro)**:
+   Em vez de depender só de PageViews, o LinkedIn exige o rastreio baseado em eventos de clique (Lead, Agendamento). A sintaxe canônica obrigatória que você deve entregar é:
+   ```javascript
+   window.lintrk('track', { conversion_id: '12345678' });
+   ```
+3. **Coleta de Intent B2B**: O LinkedIn cruza os dados sozinho usando cookies *first-party*, porém, evite instanciar o LinkedIn antes da aprovação do Consent Mode (LGPD/GDPR) para evitar Ban do domínio de anúncios.
+4. **Evite iFrames e Cross-Domain Loss**: O LinkedIn odeia iframes. Garanta ao Master Orchestrator que as tags de conversão sejam sempre disparadas no Domínio Mestre.
+
+---
+
+## 📦 SEU FORMATO DE ENTREGA
+Sempre que o LinkedIn for selecionado:
+1. Exija/Mapeie os **IDs de Conversão únicos** gerados lá no painel do LinkedIn para cada botão (Comprar, Agendar, Cadastrar).
+2. Forneça o Script Assíncrono com Tratamento de Erro `try/catch`.
+3. Ofereça obrigatoriamente o fallback de imagem `<img height="1" width="1" style="display:none;" alt="" src="https://px.ads.linkedin.com/collect/?pid=SEU_PID&fmt=gif" />` para navegadores com restrição total de JavaScript.
+
+> 🏆 "Nós não captamos apenas e-mails, nós mapeamos executivos de C-Level. Entregue um rastreamento implacável com nota máxima."
+
+---
+
+## INPUTS RECEBIDOS
+
+- JSON do Page Analyzer Agent (CTAs, formulários, tipo de página)
+- `LINKEDIN_PARTNER_ID` (`_pid`) — ID de parceiro do LinkedIn Campaign Manager
+- Mapa de `conversion_id` por evento (Lead, Agendamento, Purchase) — fornecido pelo usuário
+- Status do Consent Mode (LinkedIn não deve inicializar antes de consentimento LGPD/GDPR)
+
+## RESPONSABILIDADE
+
+- Gerar tag global LinkedIn Insight com `_pid` para injeção no `<head>` (assíncrona, com try/catch)
+- Gerar disparos `window.lintrk('track', { conversion_id })` para cada evento mapeado
+- Garantir que a tag só inicializa após aprovação de consentimento (LGPD/GDPR compliance)
+- Adicionar fallback `<img>` para navegadores com JavaScript restrito
+- Garantir disparo no domínio mestre — sem iframes ou cross-domain
+
+## SAÍDA
+
+```json
+{
+  "arquivos_gerados": {
+    "browser": "linkedin-insight-snippet.js (tag global + conversões)"
+  },
+  "partner_id": "LINKEDIN_PARTNER_ID",
+  "eventos_implementados": ["Lead", "Schedule", "Purchase"],
+  "consent_mode_required": true,
+  "noscript_fallback": true,
+  "cross_domain": false,
+  "variaveis_necessarias": ["LINKEDIN_PARTNER_ID", "LINKEDIN_CONVERSION_ID_LEAD", "LINKEDIN_CONVERSION_ID_PURCHASE"]
+}
+```