Guia de Uso Completo

AdsEngine — Manual da Ferramenta

Tudo o que você precisa para configurar, importar, interpretar e tomar decisão com base nos dados.

1. Como começar — Passo a Passo

1
Escolha o canal
Na barra lateral, selecione Mercado Livre ou Shopee. Cada canal tem seu próprio dashboard e parser de relatório.
2
Baixe o relatório na plataforma de origem
Veja a seção Onde baixar os relatórios para o passo a passo de cada canal.
3
Faça upload do arquivo
Arraste o arquivo (.xlsx ou .csv) para a área de upload do dashboard. O parser identifica automaticamente as colunas e calcula as métricas.
4
Analise o Dashboard
Veja o resumo de investimento, receita, ROAS, ACOS e a distribuição em quadrantes (Escala, Competitividade, Déficit, Estável).
5
Use a Análise Tática por Anúncio
Liste os anúncios para Pausar (CVR baixo), Revisar Títulos/Fotos (CTR baixo) e Orgânicos para Ativar. Baixe a lista em Excel pelo botão de download ao lado de cada frente.
6
Compare períodos e acompanhe histórico
Use a aba Comparativa para ver evolução entre dois períodos e a aba Histórico para acompanhar tendências ao longo do tempo.
7
Aplique no painel de Ads e monitore por 7–14 dias
O algoritmo precisa de tempo para aprender. Não altere tudo todo dia.

2. Configurações da Sidebar (faça ANTES de importar)

A sidebar à esquerda concentra o Motor de Regras do AdsEngine. São os parâmetros que classificam cada anúncio em Escalar, Otimizar, Pausar ou Revisar. Se você não ajustar para a realidade do seu nicho e da sua margem, o diagnóstico fica genérico — e você pode acabar pausando anúncios saudáveis ou escalando anúncios deficitários.

🎯 Meta de ROAS e Rentabilidade

Define o ROAS Mínimo (ponto de equilíbrio) calculado por100 ÷ Margem de Contribuição.

• Margem de Contribuição (%): sua margem real depois de custo do produto, impostos, taxa do marketplace e frete (sem contar Ads).
• Ex.: margem 40% → ROAS mínimo 2,5x. Abaixo disso, Ads consome todo o lucro.
• Interfere em: classificação Déficit, frente "Pausar", e barra de TACOS.

📊 Filtros de Regras (Orgânico → Ads)

Define quando um produto orgânico tem tração suficiente para virar anúncio, e quando uma campanha deve ser pausada.

• Visitas mín / Conversão mín: gargalo de entrada — produto só entra na frente "Ativar em Ads" se passar nesses dois.
• Pausar: Investimento mín + CVR Max: gasto mínimo acumulado para considerar uma campanha "queimando dinheiro" sem converter.
• Interfere em: frente "Orgânicos para Ativar" e frente "Pausar Campanha".

⚙️ Regras por Anúncio (ADS)

Filtros de volume que definem se um anúncio tem dados estatisticamente relevantes para receber diagnóstico.

• Impressões mín / Cliques mín: abaixo disso o anúncio é "imaturo" — ainda não há dado suficiente para decidir.
• CTR mín / CVR mín: pisos de qualidade. Abaixo → vai para frente "Revisar Título/Foto" (CTR) ou "Pausar" (CVR).
• Invest. mín para pausar: trava de segurança — não pausa anúncio que mal gastou.
• Interfere em: as 3 frentes táticas (Pausar, Revisar, Ativar) e ranking de anúncios.

💡 Como calibrar para o seu nicho

• Margem baixa (eletrônicos, 15–25%): ROAS mínimo sobe (4x–7x). Seja mais rígido em pausa.
• Margem alta (acessórios, moda, 50%+): ROAS mínimo cai (≤ 2x). Tolere mais aprendizado.
• Ticket alto / poucas vendas: reduza Visitas mín e Cliques mín — senão nada entra nas frentes.
• Ticket baixo / muitas vendas: aumente os mínimos para focar em produtos com volume real.
• Reveja os parâmetros a cada nova importação grande ou mudança de mix.

Atalhos da sidebar

• Modo Claro/Escuro: alterna o tema da interface.
• Exportar Excel: baixa o resultado atual (campanhas, anúncios e orgânico) em planilha.
• Gerar Snapshot: salva um JSON da análise atual + regras aplicadas, para versionar ou compartilhar.
• As configurações ficam salvas no navegador — você não precisa reconfigurar a cada uso.

3. Onde baixar os relatórios

Mercado Livre — 3 relatórios

1. Relatório de Campanhas

Acesse Mercado Livre > Publicidade > Relatórios.
Tipo de Relatório: Campanhas (Padrão).
Selecione o período (recomendado: últimos 14 ou 30 dias).
Agrupamento de Dados: Total do Período.
Clique em Baixar relatório > Excel (.xlsx).

Este arquivo traz o resumo consolidado das suas campanhas.

2. Anúncios Patrocinados

Acesse Mercado Livre > Publicidade > Relatórios.
Tipo de Relatório: Anúncios (Padrão).
Selecione o período (recomendado: últimos 14 ou 30 dias).
Agrupamento de Dados: Total do Período.
Clique em Baixar relatório > Excel (.xlsx).

Este arquivo detalha a performance de cada anúncio dentro do Ads.

3. Desempenho de Anúncios

Acesse Mercado Livre > Métricas.
Selecione o período.
Desça até a sessão Desempenho de anúncios.
Clique em Baixar relatório.

Baixe o relatório "Desempenho dos seus anúncios".

Formato esperado: planilhas com colunas de Campanha, Anúncio (MLB), Investimento, Receita, Cliques, Impressões, CVR, CTR, ROAS, ACOS, Impressões perdidas por orçamento e por classificação.

Shopee — 2 relatórios

1. Dados Gerais de Anúncios

Acesse o painel do vendedor (Central do Vendedor) e clique em Shopee Ads ou Anúncios.
Vá para o painel de anúncios (lista de campanhas/anúncios de busca).
No topo, selecione o período que quer analisar (ex.: 07/03/2026 a 07/04/2026).
Clique em Exportar dados ou Exportar relatório.
Escolha Dados Gerais de Anúncios.
Confirme; o Shopee vai gerar o arquivo e iniciar o download em CSV/Excel.

2. Dados em nível de palavra-chave e performance

Acesse o painel do vendedor (Central do Vendedor) e clique em Shopee Ads ou Anúncios.
Vá para o painel de anúncios (lista de campanhas/anúncios de busca).
No topo, selecione o período que quer analisar.
Clique em Exportar dados ou Exportar relatório.
Escolha Dados em nível de palavra-chave e performance.
Confirme; o Shopee vai gerar o arquivo e iniciar o download em CSV/Excel.

Formato esperado: planilhas Shopee com colunas de Campanha, GMV, Despesa, Conversões, ROAS, ACOS, CTR, CVR, Taxa de cumprimento e ROAS Alvo.

Dica: baixe sempre o mesmo período em ambos os canais para poder comparar performance lado a lado na aba Comparativa.

4. Metodologia usada

O AdsEngine não inventa métricas — usa as colunas oficiais de cada plataforma e aplica regras de classificação consistentes. Período padrão de análise: 14 dias (janela mínima para o algoritmo de leilão estabilizar).

Mercado Livre

Janela de atribuição: Conversões em até 30 dias após o clique (padrão ML).
ROAS Real: Receita ÷ Investimento
ACOS: Investimento ÷ Receita × 100
TACOS: Investimento Ads ÷ Receita Total da loja × 100
Quadrantes: Cruzamento de ROAS Real vs ROAS Alvo + Impressões perdidas (orçamento e classificação).
Período recomendado: Últimos 14 a 30 dias

Shopee

Janela de atribuição: Compra em até 7 dias após o clique no anúncio.
ROAS Direto: Vendas Diretas ÷ Despesa
ACOS Direto: Despesa ÷ Vendas Diretas × 100
CVR: Conversões ÷ Cliques × 100
Quadrantes: ROAS vs ROAS Alvo da campanha + Taxa de cumprimento + sinais de orçamento.
Período recomendado: Últimos 7 a 14 dias

Regras de classificação por quadrante

• ESCALA: ROAS ≥ alvo (≥ 7x para Rentabilidade) e Impressões perdidas por orçamento ≥ 40%.
• COMPETITIVIDADE: Impressões perdidas por classificação ≥ 50% com ROAS saudável.
• DÉFICIT: ROAS < 3x ou ACOS > 30% acima da meta.
• ESTÁVEL: dentro da meta, sem alavancas críticas.

5. Indicadores da ferramenta

Cada métrica que aparece no Dashboard, na Análise Tática e nos relatórios em Excel.

Investimento: Total gasto em Ads no período analisado.
Receita: Vendas atribuídas aos anúncios na janela de atribuição da plataforma.
ROAS Real: Retorno sobre investimento em Ads. Fórmula: Receita ÷ Investimento.
ROAS Alvo: Meta de ROAS definida na campanha (ML) ou no leilão (Shopee).
ACOS: Custo de publicidade sobre vendas. Fórmula: Investimento ÷ Receita × 100.
TACOS: Custo de Ads sobre a receita TOTAL da loja (orgânico + ads).
CTR: Taxa de cliques. Fórmula: Cliques ÷ Impressões × 100.
CVR: Taxa de conversão. Fórmula: Conversões ÷ Cliques × 100.
Custo por Conversão: Quanto custou em média cada venda. Fórmula: Despesa ÷ Conversões.
Impressões Perdidas (Orçamento): % de oportunidades perdidas porque o orçamento acabou. Sinaliza ESCALA.
Impressões Perdidas (Classificação): % perdidas porque o lance/qualidade está baixo. Sinaliza COMPETITIVIDADE.
Taxa de Cumprimento (Shopee): Quanto da demanda da campanha está sendo atendida. Abaixo de 60% indica orçamento ou lance baixo.
Diagnóstico de Anúncios (Shopee): Avaliação multifatorial nativa da Shopee. Visível em "Editar" do anúncio.

6. Funcionalidades do app

Upload + Dashboard

Arraste o relatório e veja KPIs, distribuição por quadrante e ranking de campanhas em segundos.

Análise por Quadrantes

Escala, Competitividade, Déficit e Estável — cada campanha recebe um diagnóstico automático.

Análise Tática por Anúncio

3 frentes acionáveis: Pausar (CVR baixo), Revisar Títulos/Fotos (CTR baixo) e Orgânicos para ativar.

Download em Excel

Cada uma das 3 frentes táticas tem botão de download com o MLB do produto incluso.

AdsEngine (Motor de decisão)

Smart Budget Reallocation, Motor de Aquecimento e Filtro de Combustível para sugestões de realocação.

Comparativa entre períodos

Compare dois períodos lado a lado — descubra o que cresceu, o que caiu e onde realocar verba.

Histórico

Acompanhe a evolução das métricas ao longo do tempo, salvando cada análise importada.

Integração com Notion

Sincroniza relatórios e diagnósticos com o seu workspace Notion.

7. Boas práticas

Frequência de análise

• Importe relatórios 1x por semana (toda segunda-feira).
• Use janela de 7 a 14 dias para decisões táticas.
• Use janela de 30+ dias para decisões estratégicas (mix de portfólio).

Escala e ajustes

• Algoritmo leva 7–14 dias para aprender — não altere todo dia.
• Suba orçamento 10% a 20% por dia. Nunca dobre de uma vez.
• Em ESCALA confirmada por 7 dias, suba 50% e reavalie.

Estrutura de campanhas

• Não misture campeões com testes na mesma campanha.
• Máximo de 15 produtos em campanhas pequenas.
• Separe campanhas por objetivo: Rentabilidade, Visibilidade e Novos Produtos.

Antes de culpar o Ads

• Ads não salva produto ruim. Checklist: preço competitivo, Full, reputação verde, foto profissional, título com palavra-chave, avaliações ≥ 4.5, estoque saudável.
• CTR baixo = problema de imagem/título.
• CVR baixo = problema de oferta (preço, frete, ficha, reputação).

Tipos de campanha (segmentação)

Rentabilidade

ROAS alvo: 8x – 12x
ACOS alvo: 8% – 12%
TACOS: 3% – 6%
Foco: Best sellers, lucro

Visibilidade

ROAS alvo: 5x – 7x
ACOS alvo: 15% – 20%
TACOS: 10% – 20%
Foco: Ganhar topo de busca

Novos Produtos

ROAS alvo: 1x – 2.5x
ACOS alvo: 40% – 100%
TACOS: irrelevante no início
Foco: Validação

Diagnóstico rápido por sintoma

• Tem clique e não vende: oferta — preço, frete (Full ajuda muito), reputação, fotos, ficha técnica.
• Sem clique (CTR baixo): imagem ou título — troque a foto principal, melhore o título com palavra-chave.
• ACOS alto: pause produtos ruins, separe campanhas, ajuste orçamento.
• TACOS alto: dependência de Ads — fortaleça orgânico (SEO + reputação).

Apêndice — Glossário oficial Shopee Ads

Definições oficiais da Shopee usadas pelo AdsEngine.

Diagnóstico de Anúncios: Avaliação multifatorial do anúncio feita pela Shopee. Visível clicando em "Editar" ou "Detalhes".
Custo por Conversão: Despesa ÷ Conversões.
Conversões Diretas: Compras feitas em até 7 dias após o clique no anúncio.
Taxa de Conversão (CVR): Conversões ÷ Cliques × 100%.
CTR: Cliques ÷ Impressões × 100%.
ROAS Direto: Vendas Diretas ÷ Despesa.
ACOS Direto: Despesa ÷ Vendas Diretas × 100%.

Lembrete final

• Decisão tomada hoje, resultado medido em 7–14 dias.
• Importe o relatório semanalmente e versione o histórico.
• Ads é amplificador — produto ruim com Ads = prejuízo amplificado.