cdp-edge 1.2.0

package/extracted-skill/tracking-events-generator/contracts/api-versions.json

@@ -0,0 +1,368 @@
+{
+  "metadata": {
+    "version": "1.0.0",
+    "created_at": "2026-03-28T14:00:00.000Z",
+    "updated_at": "2026-03-28T14:00:00.000Z",
+    "maintained_by": "Intelligence Agent (CDP Edge Quantum Tier)",
+    "purpose": "Fonte única da verdade para versões de API em todo o ecossistema CDP Edge"
+  },
+
+  "meta": {
+    "platform": "meta",
+    "name": "Meta (Facebook)",
+    "documentation": "https://developers.facebook.com/docs/marketing-api/conversions-api/",
+    "changelog": "https://developers.facebook.com/docs/graph-changelog/",
+
+    "versions": {
+      "pixel": {
+        "current": "v22.0",
+        "minimum_supported": "v21.0",
+        "recommended": "v22.0",
+        "deprecated": ["v20.0", "v21.0"],
+        "deprecated_cutoff": {
+          "v20.0": "2024-01-01T00:00:00.000Z",
+          "v21.0": "2024-06-01T00:00:00.000Z"
+        }
+      },
+
+      "capi": {
+        "current": "v22.0",
+        "minimum_supported": "v21.0",
+        "recommended": "v22.0",
+        "endpoint_pattern": "https://graph.facebook.com/{VERSION}/{PIXEL_ID}/events",
+        "authentication": "Bearer token (META_ACCESS_TOKEN)",
+        "rate_limits": {
+          "requests_per_hour": 200,
+          "events_per_batch": 10,
+          "batches_per_hour": 20
+        }
+      },
+
+      "messenger": {
+        "current": "v22.0",
+        "minimum_supported": "v21.0",
+        "recommended": "v22.0",
+        "whatsapp_cloud_api": "v22.0"
+      }
+    }
+  },
+
+  "google": {
+    "platform": "google",
+    "name": "Google (GA4 + Google Ads)",
+    "versions": {
+      "ga4": {
+        "current": "latest",
+        "minimum_supported": "v2",
+        "recommended": "latest",
+        "endpoint_pattern": "https://www.google-analytics.com/mp/collect?measurement_id={MEASUREMENT_ID}&api_secret={SECRET}",
+        "authentication": "API Secret (GA4_API_SECRET)"
+      },
+      "google_ads": {
+        "current": "latest",
+        "minimum_supported": "v2",
+        "recommended": "latest",
+        "uet_tag": "latest"
+      },
+      "consent_mode": {
+        "current": "v2",
+        "minimum_supported": "v2",
+        "required_parameters": [
+          "ad_storage",
+          "analytics_storage",
+          "ad_user_data",
+          "ad_personalization"
+        ],
+        "default_values": {
+          "ad_storage": "denied",
+          "analytics_storage": "denied",
+          "ad_user_data": "denied",
+          "ad_personalization": "denied"
+        },
+        "flags": {
+          "url_passthrough": true,
+          "wait_for_update": 500
+        }
+      }
+    }
+  },
+
+  "tiktok": {
+    "platform": "tiktok",
+    "name": "TikTok (Pixel + Events API)",
+    "documentation": "https://ads.tiktok.com/marketing_api/docs?id=1740465605569281",
+    "versions": {
+      "pixel": {
+        "current": "v1.3",
+        "minimum_supported": "v1.2",
+        "recommended": "v1.3",
+        "deprecated": [
+          "v1.2"
+        ],
+        "deprecated_cutoff": {
+          "v1.2": "2024-03-01T00:00:00.000Z"
+        },
+        "endpoint_pattern": "https://analytics.tiktok.com/v1/pixel"
+      },
+      "events_api": {
+        "current": "v1.3",
+        "minimum_supported": "v1.2",
+        "recommended": "v1.3",
+        "endpoint_pattern": "https://business-api.tiktok.com/open_api/{VERSION}/event/track/",
+        "authentication": "Bearer token (TIKTOK_ACCESS_TOKEN)",
+        "rate_limits": {
+          "requests_per_minute": 10,
+          "events_per_batch": 5,
+          "batches_per_minute": 2
+        }
+      }
+    }
+  },
+
+  "pinterest": {
+    "platform": "pinterest",
+    "name": "Pinterest (Tag + Conversions API)",
+    "documentation": "https://developers.pinterest.com/docs/conversions/",
+    "versions": {
+      "tag": {
+        "current": "3.0",
+        "minimum_supported": "2.0",
+        "recommended": "3.0",
+        "endpoint_pattern": "https://s.pinimg.com/ct/core.js",
+        "enhanced_match": {
+          "supports_email_hashing": true,
+          "supports_phone_hashing": true,
+          "auto_hash_by_pixel": true
+        }
+      },
+      "conversions_api": {
+        "current": "v5",
+        "minimum_supported": "v4.0",
+        "recommended": "v5",
+        "deprecated": [
+          "v4"
+        ],
+        "deprecated_cutoff": {
+          "v4": "2024-01-01T00:00:00.000Z"
+        },
+        "endpoint_pattern": "https://api.pinterest.com/v5/ad_accounts/{AD_ACCOUNT_ID}/events",
+        "authentication": "Bearer token (PINTEREST_ACCESS_TOKEN)",
+        "rate_limits": {
+          "requests_per_hour": 100,
+          "events_per_batch": 10,
+          "batches_per_hour": 10
+        }
+      }
+    }
+  },
+
+  "reddit": {
+    "platform": "reddit",
+    "name": "Reddit (Pixel + Conversions API)",
+    "documentation": "https://ads.reddit.com/help/article/reddit-pixel",
+    "versions": {
+      "pixel": {
+        "current": "v2",
+        "minimum_supported": "v1.0",
+        "recommended": "v2",
+        "endpoint_pattern": "https://www.redditstatic.com/ads/v2.js",
+        "advanced_matching": {
+          "supports_email_hashing": true,
+          "auto_hash_by_pixel": true,
+          "supports_external_id": true
+        }
+      },
+      "conversions_api": {
+        "current": "v2.0",
+        "minimum_supported": "v1.0",
+        "recommended": "v2.0",
+        "deprecated": [
+          "v1.0"
+        ],
+        "deprecated_cutoff": {
+          "v1.0": "2024-06-01T00:00:00.000Z"
+        },
+        "endpoint_pattern": "https://ads-api.reddit.com/api/{VERSION}/conversions/events/{AD_ACCOUNT_ID}",
+        "authentication": "Bearer token (REDDIT_ACCESS_TOKEN)",
+        "rate_limits": {
+          "requests_per_minute": 5,
+          "events_per_batch": 10,
+          "batches_per_minute": 1
+        }
+      }
+    }
+  },
+
+  "linkedin": {
+    "platform": "linkedin",
+    "name": "LinkedIn (Insight Tag + Conversions API)",
+    "documentation": "https://learn.microsoft.com/en-us/linkedin/marketing/conversions-api/",
+    "versions": {
+      "insight_tag": {
+        "current": "v2",
+        "minimum_supported": "v1",
+        "recommended": "v2",
+        "endpoint_pattern": "https://snap.licdn.com/li.lms-analytics/insight.beta.min.js",
+        "consent_mode_required": true,
+        "data_attributes": [
+          "conversion_id",
+          "text",
+          "currency",
+          "value"
+        ]
+      },
+      "conversions_api": {
+        "current": "v2",
+        "minimum_supported": "v1",
+        "recommended": "v2",
+        "endpoint_pattern": "https://api.linkedin.com/rest/attributionConversions/{VERSION}",
+        "authentication": "Bearer token (LINKEDIN_ACCESS_TOKEN)",
+        "rate_limits": {
+          "requests_per_second": 10,
+          "events_per_batch": 100
+        }
+      }
+    }
+  },
+
+  "bing": {
+    "platform": "bing",
+    "name": "Microsoft Advertising (UET Tag + Clarity)",
+    "documentation": "https://learn.microsoft.com/en-us/advertising/guides/event-tracking",
+    "versions": {
+      "uet_tag": {
+        "current": "latest",
+        "minimum_supported": "v1",
+        "recommended": "latest",
+        "endpoint_pattern": "https://bat.bing.com/bat.js",
+        "enhanced_conversions": {
+          "supports_email_hashing": true,
+          "supports_phone_hashing": true,
+          "requires_sha256": true
+        }
+      },
+      "clarity": {
+        "current": "latest",
+        "minimum_supported": "v1",
+        "recommended": "latest",
+        "endpoint_pattern": "https://clarity.ms/tag/s/{CLARITY_PROJECT_ID}/clarity.js"
+      }
+    }
+  },
+
+  "youtube": {
+    "platform": "youtube",
+    "name": "YouTube Ads (Video Campaigns)",
+    "documentation": "https://developers.google.com/youtube/v3/guides/auth/server-side-web-apps",
+    "versions": {
+      "video_campaigns": {
+        "current": "latest",
+        "minimum_supported": "v1",
+        "recommended": "latest",
+        "campaign_types": ["TrueView In-Stream", "Bumper Ads", "Non-skip In-Stream", "Video Discovery"],
+        "click_ids": ["gclid", "wbraid", "gbraid"],
+        "conversion_window_vtc_days": 7
+      },
+      "iframe_api": {
+        "current": "latest",
+        "endpoint_pattern": "https://www.youtube.com/embed/{VIDEO_ID}?enablejsapi=1",
+        "events": ["video_start", "video_progress", "video_complete"],
+        "milestones_percent": [25, 50, 75, 100]
+      },
+      "customer_match": {
+        "current": "latest",
+        "hash_required": true,
+        "hash_algorithm": "SHA-256",
+        "accepted_fields": ["email", "phone", "first_name", "last_name"]
+      }
+    }
+  },
+
+  "spotify": {
+    "platform": "spotify",
+    "name": "Spotify Ads (Pixel + Conversions API)",
+    "documentation": "https://advertising-api.spotify.com/docs/",
+    "versions": {
+      "pixel": {
+        "current": "v1",
+        "minimum_supported": "v1",
+        "recommended": "v1",
+        "endpoint_pattern": "Spotify Pixel SDK (custom)"
+      },
+      "conversions_api": {
+        "current": "v1",
+        "minimum_supported": "v1",
+        "recommended": "v1",
+        "endpoint_pattern": "https://advertising-api.spotify.com/conversion/v1/accounts/{ACCOUNT_ID}/events",
+        "authentication": "Bearer token (SPOTIFY_ACCESS_TOKEN)",
+        "rate_limits": {
+          "requests_per_minute": 30,
+          "events_per_batch": 10
+        }
+      }
+    }
+  },
+
+  "validation_rules": {
+    "deprecation_policy": "APIs marcadas como deprecated devem ser atualizadas IMEDIATAMENTE",
+    "minimum_version_policy": "Versões abaixo do minimum_supported NÃO são suportadas",
+    "recommended_version_policy": "Usar sempre a recommended version para máxima compatibilidade",
+    "endpoint_validation": "Endpoints devem seguir exatamente o padrão especificado",
+    "authentication_validation": "Tokens devem ser obtidos via wrangler secret (NUNCA hardcoded)",
+    "rate_limit_policy": "Respeitar rate_limits para evitar bloqueios"
+  },
+
+  "migration_guidelines": {
+    "meta_v20_to_v22": {
+      "breaking_changes": [],
+      "new_parameters": [],
+      "deprecated_parameters": [],
+      "migration_steps": [
+        "Atualizar endpoint de /v20.0/ para /v22.0/",
+        "Verificar novos parâmetros obrigatórios",
+        "Testar em ambiente de sandbox"
+      ]
+    },
+
+    "tiktok_v1.2_to_v1.3": {
+      "breaking_changes": [],
+      "new_parameters": [],
+      "deprecated_parameters": [],
+      "migration_steps": [
+        "Atualizar endpoint de /v1.2/ para /v1.3/",
+        "Verificar compatibilidade de event names",
+        "Atualizar rate limits"
+      ]
+    },
+
+    "pinterest_v4_to_v5": {
+      "breaking_changes": ["ad_account_id agora obrigatório na URL"],
+      "new_parameters": ["external_data", "action_source"],
+      "deprecated_parameters": [],
+      "migration_steps": [
+        "Adicionar ad_account_id ao endpoint",
+        "Atualizar estrutura de payload",
+        "Verificar novos campos obrigatórios"
+      ]
+    },
+
+    "reddit_v1.0_to_v2.0": {
+      "breaking_changes": ["URL mudou de /api/v1.0/ para /api/v2.0/"],
+      "new_parameters": ["conversion_type", "ip_address", "user_agent"],
+      "deprecated_parameters": [],
+      "migration_steps": [
+        "Atualizar todos os endpoints para v2.0",
+        "Adicionar novos campos de user data",
+        "Verificar compatibilidade de event names"
+      ]
+    }
+  },
+
+  "last_updated_by": {
+    "agent": "Intelligence Agent",
+    "session_id": "CDP_2026-03-28_sync",
+    "timestamp": "2026-03-28T00:00:00.000Z"
+  },
+
+  "next_review_date": "2026-04-27T00:00:00.000Z"
+}

package/extracted-skill/tracking-events-generator/docs/guia-cloudflare-iniciante.md

@@ -0,0 +1,107 @@
+# Guia Cloudflare Supreme — CDP Edge
+## 100% Server-Side, 100% Native, 100% Grátis.
+
+> **O que você vai construir:**
+> Um servidor de tracking de elite que recebe os dados do seu site e os envia para Meta, Google, TikTok — com banco de dados D1 nativo. Tudo na Cloudflare, sem custos operacionais e com performance enterprise.
+
+---
+
+## ENTENDENDO O SISTEMA (Quantum Tier)
+
+Imagine que você tem uma operação de alta performance. Quando um cliente entra, você quer anotar:
+- De onde ele veio (Instagram, Google, etc.)
+- O que ele fez (clicou no botão, preencheu o formulário, comprou)
+- Para poder otimizar suas campanhas com dados reais
+
+**Sem servidor:** o pixel fica no browser, vulnerável a AdBlockers e iOS 14+. Você perde até 40% das conversões.
+
+**Com servidor (Cloudflare Workers):** seu site avisa seu servidor na Cloudflare. O servidor anota tudo no banco de dados (D1) e manda para Facebook, Google, TikTok via API. É invisível, furtivo e resiliente.
+
+**Custo:** zero. A Cloudflare oferece 100.000 requisições grátis por dia.
+
+---
+
+## O QUE VOCÊ VAI PRECISAR
+
+- [ ] Um computador (Windows, Mac ou Linux)
+- [ ] Uma conta Cloudflare ativa
+- [ ] IDs dos seus pixels (Meta, GA4, TikTok)
+- [ ] 15 minutos para o setup inicial
+
+---
+
+## PASSO A PASSO RESUMIDO
+
+### 1. Criar o Banco D1
+No terminal do seu projeto:
+```bash
+wrangler d1 create meu-tracking-db
+```
+
+### 2. Configurar o wrangler.toml
+Adicione o `database_id` retornado e seus pixels.
+
+### 3. Criar o Schema
+```bash
+wrangler d1 execute meu-tracking-db --file=schema.sql
+```
+
+### 4. Deploy e Secrets
+```bash
+wrangler secret put META_ACCESS_TOKEN
+wrangler secret put GA4_API_SECRET
+wrangler deploy
+```
+
+---
+
+## VISÃO GERAL COMPLETA DO SISTEMA
+
+```
+SITE DO CLIENTE
+     │
+     │  POST /track (Same-Domain)
+     ▼
+CLOUDFLARE WORKER (Supreme Edge)
+     │
+     ├──→ META CAPI v22.0 ──────── Atribuição de Meta Ads
+     ├──→ TikTok Events API ────── Atribuição de TikTok Ads
+     ├──→ GA4 Measurement Protocol ─ Relatórios Google
+     └──→ D1 Database ───────────── Atribuição e Identity Graph
+```
+
+**Benefícios do Padrão Quantum Tier:**
+- **Zero Latência:** Processamento na borda, a milisegundos do usuário.
+- **Furtividade:** Rastreamento invisível para bloqueadores.
+- **Identity Resolution:** Cruzamento de e-mails e cliques para 100% de precisão.
+- **Custo Zero:** Sem servidores legados (VPS/N8N) para manter.
+
+---
+
+> Use o comando `/setup` do CDP Edge para gerar o código sob medida para seu projeto.
+    │  │
+│  └──────┬───────┘  └──────┬───────┘  └────────┬─────────┘  │
+│         └─────────────────┴──────────────────┘             │
+│                            │                                 │
+│                 ┌──────────▼──────────┐                     │
+│                 │  Processa e distribui│                     │
+│                 └──────────┬──────────┘                     │
+└────────────────────────────┼────────────────────────────────┘
+                             │
+          ┌──────────────────┼──────────────────────┐
+          │                  │                       │
+          ▼                  ▼                       ▼
+┌─────────────────┐ ┌───────────────┐ ┌─────────────────────┐
+│   META CAPI     │ │  CLOUDFLARE   │ │  CLOUDFLARE QUEUES  │
+│   v22.0         │ │  D1 DATABASE  │ │ (Async Processes)   │
+│                 │ │               │ │                     │
+│ Facebook Ads ✅ │ │ leads         │ │ Retries & Logging   │
+│ Instagram Ads ✅│ │ user_profiles │ │ High Resilience     │
+└─────────────────┘ └───────────────┘ └─────────────────────┘
+          │
+          ├──→ TIKTOK EVENTS API /v1.3/event/track/ ✅
+          └──→ GA4 MEASUREMENT PROTOCOL ✅
+```
+
+**Custo total: R$ 0,00/mês** ✅
+>>>>>>> ef28f8c (feat: Purga Total de Sistemas Legados (Sheets, VPS, N8N) - Arquitetura 100% Cloudflare Quantum Tier)