Manual Completo

1. O que é o Meus Anúncios

O Meus Anúncios é uma rede de anúncios (ad network) que conecta dois lados:

2. Como funciona

3. Quem ganha o quê

Regra financeira central da plataforma (valores configuráveis pelo dono em Administração → Gerenciamento):

• Anunciante paga 100% do custo (CPM ou CPC) de cada evento.
• Publisher recebe 60,0% de cada evento.
• Plataforma (dono) retém 40,0% de cada evento.

No CPM (custo por 1.000 impressões)

No CPC (custo por clique)

4. Dono do site: como ele ganha

O dono deve ter uma conta com papel admin. Ele ganha de duas formas:

4.1 Comissão de 40,0% sobre toda a movimentação de anúncios

A cada impressão ou clique válido, a plataforma retém automaticamente 40,0% do custo pago pelo anunciante. Não depende de aprovação manual: o crédito cai direto na receita da plataforma enquanto o restante vai ao publisher.

4.2 Operação e governança da plataforma

O painel Administração é onde o dono cuida da rede para ela rodar segura e lucrativa:

1. 1 Aprovar publishers

   Em Administração → Publishers você vê quem se cadastrou como publisher e o status de aprovação. Sem ser aprovado ninguém cria zona nem veicula anúncio. Isso protege a rede contra sites de baixa qualidade ou fraudulentos.

2. 2 Verificar anunciantes

   Em Administração → Anunciantes você pode marcar anunciantes como verificados, garantindo fontes de orçamento confiáveis.

3. 3 Aprovar saques dos publishers

   Quando um publisher pede um saque (mínimo R$ 50,00), a transação nasce como pendente e o valor fica reservado no saldo. Em Administração → Transações você aprova (com Mercado Pago configurado, o PIX é enviado para a chave do publisher e a transação vira concluída) ou rejeita (o valor volta ao saldo do publisher). Sem o gateway, a aprovação é simulada.

4. 4 Monitorar receita e relatórios

   Na Visão Geral administrativa e em Relatórios → Financeiro você acompanha impressões, cliques, total movimentado e a receita da plataforma (a diferença entre o que o anunciante pagou e o que foi repassado aos publishers).

5. 5 Controlar anti-fraude

   Em Administração → Anti-Fraude você vê os IPs suspeitos (muitos cliques por hora/dia) e pode bloquear ou desbloquear IPs. IPs bloqueados não recebem anúncios nem geram cobrança.

6. 6 Gerenciar usuários e contas

   Ativar/desativar usuários (toggle) ou removê-los. Um usuário desativado não consegue usar a plataforma.

7. 7 Configurar a comissão, exemplos e limites

   Em Administração → Gerenciamento o dono altera a comissão da plataforma (padrão 40,0% para a plataforma e 60,0% para o publisher), valores mínimo/máximo de saque, os exemplos exibidos no manual e na página inicial, e os limites anti-fraude. Tudo entra em vigor na hora, sem reiniciar o servidor.

5. Anunciante: como divulgar e calcular os custos

O anunciante não ganha dinheiro na plataforma — ele investe para ganhar tráfego, marcas vistas e cliques que viram vendas no próprio negócio. O painel dele mostra exatamente quanto foi gasto e quantas impressões/cliques isso gerou.

Passo a passo

1. 1 Cadastre-se como Anunciante

   No cadastro escolha “Quero Anunciar” e informe o nome da empresa.

2. 2 Adicione saldo

   Em Financeiro → Depósito, escolha o valor e o método (PIX, cartão, boleto). Com o Mercado Pago configurado, o depósito via PIX gera um QR code que você paga no app do banco; o saldo entra automaticamente quando o pagamento é confirmado. Sem o gateway, o depósito é creditado na hora (simulado). Campanhas só rodam com saldo.

3. 3 Crie a campanha

   Em Campanhas → Nova Campanha preencha os campos abaixo. O sistema exige que o orçamento total seja compatível com o saldo e que a data final seja posterior à inicial.

   Campo	O que faz	Exemplo
   name	Nome interno da campanha.	Promo Pizza Bela Inverno
   ad_format	Formato do anúncio. Deve existir uma zona com o mesmo formato para veicular.	banner
   cpm_rate	Quanto você paga a cada 1.000 impressões. Prioridade de entrega do sistema.	R$ 10,00
   cpc_rate	Quanto você paga por clique.	R$ 0,10
   daily_budget	Teto de gasto por dia (não pode ser maior que o total).	R$ 20,00
   total_budget	Teto de gasto total da campanha. Quando spent_total atinge esse valor, a campanha para.	R$ 50,00
   target_countries	Só exibe nestes países (ex: BR). Vazio = todos.	["BR"]
   target_devices	Dispositivos alvo: mobile, desktop, tablet.	["mobile","desktop"]
   image_url	URL da imagem que aparece no anúncio.	https://…/banner-pizza.jpg
   click_url	Para onde o visitante é redirecionado após o clique.	https://pizzabela.com.br/promo
   start_date / end_date	Período de veiculação. Fora disso a campanha não roda.	01/09/2026 a 30/09/2026

4. 4 Acompanhe e otimize

   Veja em Visão Geral e nas páginas da campanha: impressões, cliques, CTR (cliques ÷ impressões × 100) e gasto total. Quanto maior o CTR, melhor seu anúncio e mais barato fica o custo por clique efetivo.

5. 5 Pause, edite ou encerre

   A qualquer momento você pode editar lances e orçamento, pausar, retomar ou encerrar a campanha (status ended).

Exemplo numérico de configuração

Digamos que a Pizza Bela deposite R$ 100,00 e crie uma campanha com CPM R$ 10,00 e CPC R$ 0,10.

• Com R$ 50,00 de orçamento total só em impressões: R$ 50,00 ÷ R$ 0,01 por impressão = 5.000 impressões.
• Se essas 5.000 impressões gerarem 200 cliques (CTR de 200 ÷ 5.000 × 100): + 200 × R$ 0,10 = R$ 4,00. Como o orçamento total é R$ 50,00, a campanha para assim que o spent_total (impressões + cliques) atinge R$ 50,00 — o gasto nunca estoura o teto.
• No extrato do anunciante aparece a transação ad_spend "Custo do anúncio" com valor igual ao total pago.

6. Publisher: como monetizar seu site

O publisher ganha 60,0% de cada impressão e clique válidos gerados nas zonas dele. O pagamento é automático e em tempo real.

Passo a passo

1. 1 Cadastre-se como Publisher

   Escolha “Quero Monetizar”, informe o nome e a URL do seu site.

2. 2 Aguarde a aprovação do admin

   Só depois de aprovado (status is_approved = true) você pode criar zonas. Acompanhe no Perfil.

3. 3 Crie uma Zona

   Em Zonas → Nova Zona (tamanho até 2000×2000 px): dê um nome, escolha o formato (deve casar com o formato das campanhas) e o tamanho (largura × altura). Exemplo: banner 728×90 no topo, ou retângulo 300×250 no meio do artigo.

4. 4 Copie o código da zona

   Clique em Código na zona. O sistema gera um bloco HTML + JS (via /api/v1/zone/{id}/script). Cole onde quiser no HTML do site. O script carrega o anúncio e os pixels de rastreio.

   <!-- Meus Anúncios - Zone ID -->
   <div id="ad-zone-ID" style="width: 300px; height: 250px; display: inline-block;"></div>
   <script src="SEU_SITE/api/v1/zone/ID/script" async></script>

5. 5 Ganhe com impressões e cliques

   Cada visita que exibe a zona conta uma impressão; cada clique conta um clique. Seu saldo cresce 60,0% de cada custo. Fraudes (score ≥ 0,8) não são pagas e não cobram o anunciante.

6. 6 Acompanhe seus ganhos

   Em Visão Geral, Zonas e Relatórios você vê impressões, cliques, CTR e ganhos. O Financeiro mostra o extrato; cada ganho aparece como transação ad_earning “Ganho com anúncio”.

7. 7 Saque seu dinheiro

   Em Financeiro → Sacar, informe o valor (mínimo R$ 50,00), sua chave PIX e o CPF/CNPJ do titular da chave (apenas números). O saque fica pendente (o valor é reservado no saldo) até o admin aprovar — com Mercado Pago configurado, o PIX é enviado para a sua chave e a transação vira concluída. Se o admin rejeitar, o valor volta ao saldo.

Exemplo numérico de ganho

O blog "Cozinha Fácil" cria uma zona de banner 728×90 no topo do site, que recebe 2.000 visitas por mês. Supondo anúncios com CPM R$ 10,00 sendo exibidos:

7. Exemplo completo do ciclo do dinheiro

Cenário com uma campanha de CPM R$ 10,00 gerando 1.000 impressões em uma zona do blog:

Perceba: R$ 10,00 saem do anunciante, R$ 6,00 vão ao publisher e R$ 4,00 ficam com a plataforma. A soma fecha certinho porque a divisão é automática e registrada a cada evento.

8. Regras técnicas que valem para todo mundo

• Campanha só veicula se: status active, o mesmo ad_format da zona, saldo do anunciante > 0, total_budget > spent_total, daily_budget > spent_today e dentro das datas start/end.
• Orçamento diário e total são medidos em tempo real. Ao atingir qualquer um deles, a campanha para automaticamente.
• Anti-fraude: limites configuráveis (padrão de 30 cliques/IP/hora e 200 cliques/IP/dia); user-agents de bots (crawler, bot, curl, python-requests etc.) são sinalizados; IPs com score ≥ 0,8 têm eventos descartados (sem cobrança e sem pagamento) e podem ser bloqueados pelo admin.
• Mínimo para saque: R$ 50,00. Máximo por saque: R$ 300,00.
• Zona: largura/altura devem ser > 0 e ≤ 2000 px, e o formato dela precisa existir em alguma campanha ativa para ter o que exibir.
• Cache de veiculação: o anúncio de cada zona fica em cache por até 30s para resposta rápida; tokens de rastreio de impressão/clique expiram em 5 minutos.

9. Perguntas frequentes