# Instalação: CDP Edge (Quantum Tier)

O **CDP Edge** é um sistema de tracking digital completo que opera de forma nativa na Cloudflare. Ele analisa os arquivos do seu projeto, identifica formulários e botões automaticamente, e gera todo o código de tracking para Meta, Google, TikTok e mais — incluindo servidor na borda e banco de dados D1, garantindo alta precisão e soberania total de dados.

---

## 🚀 PASSO A PASSO DA INSTALAÇÃO

### 1. Preparação da Conta Cloudflare
- Acesse [cloudflare.com](https://cloudflare.com).
- Ative o banco de dados **D1**.
- Crie um **Worker** para processamento de eventos.

### 2. Implantação do SDK (Site)
- Adicione o script `cdpTrack.js` ao `<head>` do seu site.
- Configure os IDs (Meta, TikTok, GA4) no `cdpConfig.js`.

### 3. Configuração do Servidor (Worker)
- Faça o deploy do código gerado pelo **Server Agent**.
- Conecte o banco D1 ao seu Worker via `wrangler.toml`.
- Configure as Variáveis de Ambiente (Tokens de API).

---

## ⚡ ARQUITETURA TÉCNICA (Quantum Tier SUPREME)
| Componente | Função | Vantagem |
|---|---|---|
| **cdpTrack.js** | SDK do Site | Envio direto via Fetch para o Worker |
| **Workers** | Processamento | Execução na borda com baixa latência |
| **D1 Database** | Persistência | Armazenamento seguro de leads e eventos |
| **CAPI v25.0** | Despacho | Atribuição de alta qualidade via servidor |

### Plataformas Suportadas (Server-Side)
| Plataforma | Status | Protocolo |
|---|---|---|
| Meta / Facebook Pixel | ✅ | ✅ CAPI v25.0 |
| Google Analytics 4 | ✅ | ✅ Measurement Protocol |
| Google Ads | ✅ | ✅ Conversão + User-provided Data |
| TikTok Pixel | ✅ | ✅ Events API v1.3 |
| Pinterest Tag | ✅ | — |
| Bing / Microsoft Ads | ✅ | — |

### Tipos de página reconhecidos automaticamente
| Tipo | Quando usa |
|---|---|
| Captura de Lead | Formulário com email/nome/telefone |
| Lead + Evento Externo | Formulário + compra em plataforma externa (Hotmart/Kiwify) |
| Tráfego Direto | Página de vendas sem formulário → checkout externo |
| Checkout Próprio | Cartão/Stripe/MercadoPago na página |
| Página de Obrigado | Thank-you page pós-compra |

---

## 🏁 INICIANDO O SETUP
Para começar, utilize o comando:
> "/setup"

O CDP Edge irá analisar seu site e gerar a infraestrutura necessária automaticamente.
