MUGIWARA Platform

Tudo que vocês precisam saber sobre as ferramentas que vão transformar o dia-a-dia de trabalho da equipe.

🔍 Visão Geral

O que é a MUGIWARA Platform e porque ela existe

A MUGIWARA Platform é o sistema interno que automatiza todo o trabalho operacional que antes tomava horas do dia de vocês. Ela cuida de subida de campanhas, troca de criativos moderados, pausa de ad groups ruins e monitoramento de entrega — tudo rodando 24h no servidor, sem precisar de ninguém na frente do computador.

O objetivo é simples: liberar o tempo de vocês para o que realmente importa e o que realmente vai fazer vocês ganharem dinheiro — análise de dados, criação de testes A/B, estratégia de escala e educacional.

🔑 Acesso e Primeiro Login

Cada pessoa tem seu próprio usuário e senha

O sistema tem login individual. Quando você cria uma campanha ou cadastra um componente na Creative Factory, fica registrado quem fez, então cada um usa o seu.

Time de Tráfego Editor

Acesso total a todas as funcionalidades — campanhas, moderação, auto-pause, Creative Factory e Facebook.

Time de Copy Copy

Focado na produção criativa. Ao fazer login, vocês caem direto na Creative Factory. Têm acesso a 3 áreas:

• Creative Factory — Cadastro e gerenciamento de hooks, bodies, CTAs, legendas, avatares e vozes
• FB Intelligence — Relatórios de performance dos criativos no Facebook (ranking de landers, análise por BM, melhores combos)
• Facebook — Visualização das contas e campanhas do Facebook

Primeiro acesso

🚀 Subida de Campanhas

De criativos no ClickUp a campanhas Demand Gen no Google Ads, em minutos

O fluxo passo a passo

Na aba Campanhas, o wizard tem 5 etapas:

1. Selecionar Ads — Escolha a pasta do ClickUp e clique nos criativos que quer subir (ficam com borda laranja quando selecionados)
2. Formato — Shorts (vertical 9:16) e/ou Horizontal (16:9). Pode marcar os dois pra criar ambos
3. Configuração — Conta Google Ads, orçamento diário, setup (ex: 3-3-1 = 3 campanhas × 3 conjuntos × 1 anúncio), sigla do nicho, geo-targeting, superfícies, demographics e logo
4. Revisão — Confira o resumo antes de confirmar
5. Criação — Clique "Criar Campanhas" e acompanhe o progresso em tempo real

Fila de Processamento

As campanhas são processadas em uma fila inteligente no servidor. Isso significa que:

• Você pode adicionar várias campanhas de uma vez — elas entram na fila e processam uma por uma
• O progresso aparece em todas as páginas (canto inferior direito) — não precisa ficar na aba Campanhas
• Se o servidor reiniciar, a fila não se perde — os jobs ficam salvos no banco de dados
• Jobs com erro podem ser retentados com um clique no botão "Retry"
• Jobs aguardando na fila podem ser cancelados clicando em "Cancelar"

Histórico de Campanhas

Na aba Campanhas, o botão Histórico mostra todas as campanhas já criadas pelo sistema: data, quem criou (gestor), conta, formatos e nomes das campanhas. Útil pra saber o que já foi subido e por quem.

🛡 Moderação Automática

O sistema troca criativos moderados pelo Google sem você precisar fazer nada

A aba Moderação mostra todo o histórico de trocas. Os status são:

• Aguardando — Moderação detectada, troca sendo processada
• Resolvido — Vídeo trocado com sucesso
• Erro — Falha na troca (geralmente limite de upload). O sistema tenta de novo automaticamente

Os 4 cards no topo mostram os totais de cada status. A página atualiza sozinha a cada 30 segundos.

⏸ Auto-Pause

Para de queimar dinheiro em ad groups ruins automaticamente

A aba Auto-Pause mostra:

• Histórico de Pausas — Todos os ad groups pausados pelo sistema, com dados de custo, LP clicks, conversões e o motivo da pausa
• Blacklist de Criativos — Criativos que foram pausados em múltiplas contas. Se um criativo aparece aqui repetidamente, é sinal de que precisa ser revisado ou descartado
• Histórico de Escala — Ad groups que tiveram budget aumentado automaticamente por estarem performando bem

📊 Insights de Entrega

Entenda onde seu dinheiro está sendo gasto de verdade

Na aba Campanhas, a seção Entrega por Rede mostra a distribuição de gastos de cada conta entre:

• YouTube — Gastos em youtube.com, canais e vídeos do YouTube (onde a gente quer que apareça)
• Sites parceiros — Gastos em sites da rede de display que participam do leilão de vídeo
• Outros — Gastos que não puderam ser atribuídos a placements específicos

Esses dados vêm direto da Google Ads API e mostram os placements reais onde seus anúncios rodaram. Se você vê uma conta com muito gasto em "Outros" ou "Sites", é um sinal de que a entrega pode não estar saudável e vale investigar.

🔗 Painel OAuth

Gerenciamento de contas Google conectadas

A página principal é o gerenciador de contas OAuth. Cada conta Google conectada aqui alimenta todo o sistema — campanhas, moderação, auto-pause e delivery.

• Gerar Link OAuth — Cria um link para conectar uma nova conta Google. Abra no navegador da conta que deseja conectar
• Tipo de conta — Defina se é Ads, YouTube ou Ambos. Contas YouTube/Ambos entram no pool rotativo de upload de vídeos
• Customer ID — O ID da conta Google Ads. Clique "Detectar" para buscar automaticamente
• Status — Mostra se a conta está ativa ou suspensa. Contas suspensas são puladas automaticamente pelo auto-pause e delivery

🎨 Creative Factory

Pipeline de produção criativa em massa — componentes, montagem e performance

A Creative Factory é o coração da produção de criativos. Aqui o time de copy cadastra e gerencia todos os componentes que formam os anúncios. O sistema combina esses componentes para gerar criativos em escala.

A página tem 8 abas:

1. Hooks

Os primeiros segundos do vídeo — a parte que prende a atenção. Cada hook tem um tipo:

• A (Avatar) — Hook com pessoa falando direto pra câmera
• V (Visual) — Hook visual, sem avatar (b-roll, motion graphics)
• T (Texto) — Hook baseado em texto na tela

Cadastre o nome, tipo e o texto do hook. Marque como ativo, fatigado ou aposentado conforme a performance.

2. Bodies

O corpo do criativo — a argumentação que vem depois do hook. Cadastre nome e conteúdo. Cada body pode ser combinado com diferentes hooks.

3. CTAs

Call-to-Action — o fechamento do criativo. O texto que incentiva a ação (clicar, comprar, etc). Cadastre variações para testar qual converte melhor.

4. Legendas

Textos das legendas que aparecem no vídeo. Podem ser editadas em lote — o sistema mostra todas para ajuste rápido.

5. Avatares

As pessoas que aparecem nos criativos. Cadastre nome, foto e informações do avatar. Isso ajuda a rastrear qual avatar performa melhor.

6. Vozes

As vozes usadas na narração dos criativos. Cadastre nome e características da voz para controle de variações.

7. Montagem

Aqui é onde os componentes são combinados para gerar criativos completos. O sistema monta Hook + Body + CTA em diferentes combinações.

8. Performance

Painel de métricas que mostra como cada componente está performando. Veja quais hooks, copies e avatares estão gerando melhores resultados para direcionar a produção.

🧠 FB Intelligence

Relatórios automáticos de performance dos criativos no Facebook

O FB Intelligence analisa automaticamente os dados do Facebook a cada 30 minutos e gera sugestões inteligentes. Ele mostra:

• Ranking de Landers — Quais landing pages estão com melhor IC (custo por clique no link) e CPA (custo por venda)
• Análise por BM — Performance detalhada de cada Business Manager
• Melhores Combos — Combinações de criativo + lander que estão funcionando
• Novos Performers — Criativos novos que estão mostrando potencial
• Comparação de Períodos — Como os resultados mudaram entre semanas
• Desperdício de Budget — Onde o dinheiro está sendo gasto sem retorno

Cada sugestão pode ser descartada se não for relevante. O sistema aprende e continua gerando novos insights nos próximos ciclos.

📦 Widget da Fila

Acompanhe o processamento de qualquer página

No canto inferior direito de todas as páginas aparece o widget da fila. Ele mostra:

• Quantos jobs estão rodando e na fila
• O progresso de cada job com barra e logs em tempo real
• Botão Cancelar para jobs que estão esperando na fila
• Botão Retry para jobs que falharam

Você não precisa ficar preso na aba Campanhas — pode navegar livremente pelo sistema e o processamento continua no servidor.

MUGIWARA Platform — Grupo Chapéus de Palha
Dúvidas? Fale com a Sarah.