Guia de administração

Administração da plataforma

Ferramentas para gerir marketplace, moderação, house creatives e monitorizar a plataforma.

1. Admin Marketplace

O painel de administração do marketplace permite monitorizar handshakes em review há mais de 24h, deals activos com menos de 100 impressões/24h, e executar force transitions com motivo obrigatório (mínimo 8 caracteres). Inclui viewability slice por deal/tenant e curadoria cross-tenant de ads-âncora.

2. Admin House

Gestão de house creatives — o fallback garantido que assegura que nenhum slot fica vazio. CRUD de criativos house por formato e dimensão. O refresher worker usa distribuição CDF O(log N). O kill switch HOUSE_ADMIN_ENABLED mantém o fallback 300×250 hard-coded quando desactivado.

3. Moderação

Revisão e aprovação de anúncios submetidos. Anúncios em estado in_review aparecem para avaliação. O moderador pode aprovar, rejeitar ou pedir alterações. O criador não pode aprovar o seu próprio criativo.

Painel de moderação de anúncios — Moderação — revisão de criativos

4. Transparência (ads.txt / sellers.json)

Os endpoints de transparência IAB são gerados automaticamente pela API: /ads.txt, /app-ads.txt e /sellers.json. São servidos sem autenticação, com cache de 5 minutos, e incluem todos os sellers opt-in.

Os ficheiros de transparência são servidos pela API Go, não pelo frontend. O nginx faz proxy para o backend — crawlers de DSPs e ad exchanges recebem a resposta directamente.

5. Performance

Latência p50 ~6ms, p95 ~10ms, p99 ~15ms. O endpoint /serve nunca toca em Postgres — usa snapshots Redis e in-process. Disponibilidade 100% fill garantida pelo fallback HOUSE. Observabilidade via Prometheus + Grafana + Tempo + Loki.