Shield Growth Studio

01 Introdução

O que o Shield Growth Studio faz e para quem ele foi feito.

O Shield Growth Studio é uma plataforma de gestão de Meta Ads voltada para agências e gestores de tráfego. Ela reúne três frentes que normalmente vivem espalhadas em ferramentas diferentes:

A plataforma é multi-organização: cada agência opera dentro da sua própria organização, com seus próprios membros, contas de anúncio e conexões de CRM — sem visibilidade cruzada entre organizações diferentes.

02 Conceitos-chave

Quatro termos que aparecem em toda a plataforma — vale entender a relação entre eles antes de operar.

03 Primeiros passos

Do acesso ao sistema até a primeira conta de anúncio conectada.

Onde acessar

O dashboard fica em app.shieldfunnels.com. A tela de entrada aceita dois métodos: e-mail e senha, ou magic link (um link de acesso enviado por e-mail, sem senha).

1. Entre com sua conta. Se já tem e-mail e senha (ou recebeu um convite), acesse app.shieldfunnels.com e faça login.
2. Defina sua organização. No primeiro acesso sem nenhuma organização vinculada, você cai automaticamente na tela de onboarding e define o nome — normalmente o nome da agência.
3. Conecte o token de Meta Ads. Em Settings → Token Meta Ads, cole o token de sistema (system user) da sua Business Manager. É esse token que autoriza a plataforma a ler campanhas e enviar criativos.
4. Vincule uma conta de anúncio. Ainda em Settings, em Ad Accounts, adicione a conta de anúncio Meta que você quer gerenciar.
5. Crie um projeto. Em Projetos → Novo Projeto, dê um nome e selecione a conta de anúncio vinculada — isso já habilita os pixels dessa conta no projeto.
6. Explore Insights e Criativos para esse projeto — os dados aparecem assim que a conta de anúncio tiver atividade.

04 Projetos e contas de anúncio

Criar ou editar um projeto

O formulário de projeto tem duas abas:

• Config — nome, status (ativo/pausado/finalizado), orçamento total e diário, CPA alvo, ROAS mínimo, conta de anúncio vinculada e pixel Meta.
• Campanhas — vincula campanhas Meta específicas ao projeto, para métricas filtradas por campanha.

Cor e identificação

Cada projeto recebe uma cor automática, derivada do nome — é só visual, para diferenciar projetos rapidamente na lista e nos gráficos.

05 Insights

Performance agregada da conta de anúncio do projeto atualmente selecionado.

O que a tela mostra

• KPIs principais — investimento, impressões, cliques, CTR, CPC, CPM, alcance, frequência e conversões, com o custo por conversão (CPA) calculado automaticamente.
• Pacing de orçamento — compara o quanto já foi gasto no período contra a projeção do orçamento diário configurado no projeto, com um indicador de "no ritmo", "abaixo do esperado" ou "acima do esperado".
• Gasto por dia — gráfico de série temporal do investimento diário no período selecionado.

Selecionando o período

O seletor de período no topo aceita atalhos comuns (hoje, últimos 7/14/28/30 dias, este mês, mês passado) e um intervalo personalizado.

06 Criativos

Biblioteca de imagens e vídeos de anúncio do projeto atual.

Organização

Criativos podem ser organizados em pastas (barra lateral esquerda da tela) e filtrados por status: pendente, em teste, validado ou reprovado.

Fluxo de um criativo

1. Envie a imagem ou vídeo para uma pasta.
2. Peça uma sugestão de nome por IA, ou renomeie manualmente.
3. Dispare a análise por IA — ela avalia a peça e devolve observações sobre o criativo.
4. Marque o status conforme o resultado em teste (validado/reprovado).
5. Envie o criativo direto para a biblioteca de anúncios do Meta, individualmente ou em lote.

Pré-visualização

Clicar em qualquer peça abre uma pré-visualização ampliada, com acesso rápido para deletar ou renomear sem sair da galeria.

07 Webhooks de entrada

Cada webhook é um endpoint público único que recebe leads de uma origem — formulário, landing page, ou plataforma de checkout.

Criar um webhook

Em Novo Webhook, defina:

• LabelNome de referência (ex.: "Kiwify — Produto X"), opcional.
• TipoFunil ou Produto — usado apenas para organização interna dos logs.
• IntegraçãoGenerico (qualquer origem que envie JSON próprio), Kiwify, Elementor ou Hubla; cada um sabe interpretar o formato nativo dessa plataforma.

Ao salvar, a plataforma gera uma URL de webhook única (formato /api/webhooks/inbound/<id>) — é essa URL que você cola na configuração de webhook da origem (Kiwify, Elementor, ou o formulário próprio do seu formulário/landing).

Payload esperado (integração Genérico)

{
  "email": "lead@example.com",
  "name": "Nome do Lead (opcional)",
  "phone": "11999999999 (opcional)",
  "utm_source": "facebook (opcional)",
  "utm_medium": "cpc (opcional)",
  "utm_campaign": "nome_campanha (opcional)",
  "utm_content": "nome_ad (opcional)",
  "utm_term": "nome_adset (opcional)"
}

Apenas email é obrigatório — sem ele, o lead não é processado.

Assinatura HMAC (opcional)

Cada webhook tem um secret próprio. Se a origem enviar o header X-Webhook-Signature: sha256=<hash>, a plataforma valida a assinatura antes de processar — recomendado para origens que suportam isso, como camada extra de segurança contra chamadas forjadas ao endpoint público.

Testar antes de ir ao ar

O botão Testar Webhook envia um payload de exemplo contra o próprio endpoint em modo de teste: mostra como o lead seria lido, sem gravar lead nem venda. O evento de teste da Hubla ("Testar configuração") também é reconhecido e não grava nada.

Trocar o segredo

No detalhe do webhook, o botão de trocar o segredo gera um novo. Depois de trocar, atualize o segredo na origem (na Hubla, o token da aba Autenticação).

Hubla

Com a integração Hubla, o Growth Studio entende estes eventos, cada um numa regra própria do webhook da Hubla:

• Compra aprovadaLead e venda, uma linha por produto (o order bump vem separado), com as UTMs e o identificador do clique.
• Carrinho abandonadoLead na fila de Recuperação.
• Pagamento recusado e fatura expiradaTambém entram na Recuperação, com o motivo.
• Pedido de estorno e estornoRegistro na linha do tempo; o estorno zera a receita da venda e corrige as conversões enviadas ao Meta e ao Google.

Use o modo "Integração recomendada" e marque, em cada regra, todos os produtos e ofertas que o checkout vende. Oferta duplicada na Hubla é uma oferta nova e precisa ser marcada também.

08 Conexões de CRM

Toda organização pode conectar quantas conexões de CRM precisar — não é preciso usar uma ferramenta específica.

Uma lista só, qualquer CRM

Em Settings → Integrações → Conexões de CRM, todas as conexões aparecem juntas na mesma lista — ChatFunnel não tem tratamento especial nem vem pré-configurado. Cada linha mostra o nome, o tipo (ChatFunnel ou Webhook) e se está ativa.

Adicionar uma conexão

Clicar em Adicionar conexão abre um seletor com as duas modalidades disponíveis:

• ChatFunnelPede a API key da conta. A plataforma valida a chave antes de salvar — permissões necessárias: SEARCH_CONTACT, CREATE_CONTACT, MANAGE_ACCOUNT, MANAGE_KANBAN.
• Outro CRM (webhook)Pede um nome de referência, a URL do webhook de entrada do CRM de destino e, opcionalmente, um header Authorization. Os dados do lead são encaminhados via POST para essa URL.

09 Ações pós-webhook

É aqui que você define o que acontece automaticamente quando um lead novo chega por este webhook.

O botão Adicionar só aparece quando existe pelo menos uma conexão de CRM ativa na organização (ChatFunnel conectado, ou uma conexão genérica cadastrada). Cada webhook pode ter várias ações, executadas em ordem.

Variáveis de template

Nos campos de texto livre (como o comentário do card de CRM), use variáveis entre chaves duplas para inserir dados do lead automaticamente:

{{name}}  {{email}}  {{phone}}
{{utm_source}}  {{utm_medium}}  {{utm_campaign}}  {{utm_content}}  {{utm_term}}
{{sale_value}}  {{payment_method}}  {{offer_number}}

Ativar e desativar sem perder a configuração

Cada ação tem um interruptor independente — desativar uma ação preserva toda a configuração para reativar depois, sem precisar reconfigurar do zero.

10 Configurações da organização

Geral

Nome da organização e slug (o slug não pode ser alterado depois de criado).

Token Meta Ads

O token de sistema (system user) da Business Manager — é ele que autoriza toda leitura de campanhas e todo envio de criativos para o Meta.

Ad Accounts

Lista das contas de anúncio vinculadas à organização — cada uma pode ser usada por um ou mais projetos.

11 Membros e permissões

Convidar alguém

Em Convidar membro, informe o e-mail e o papel (owner, admin, member ou viewer).

• Se o e-mail ainda não tem conta, a pessoa recebe um e-mail com um link de acesso.
• Se o e-mail já tem conta (em outra organização, por exemplo), ela é adicionada diretamente — nenhum e-mail é enviado, porque a conta já existe.

Papéis

12 Logs e diagnóstico

Todo webhook recebido e toda ação executada geram um registro — mesmo quando algo dá errado.

A aba de Logs mostra, por evento: status (sucesso/erro), duração, e-mail do lead, se era um lead novo ou já existente, e o payload completo recebido. Use-a como primeira parada ao investigar por que um lead não apareceu no CRM esperado.

13 Leads, vendas e funil

Todo lead que chega por webhook vira um registro com origem, estágio, linha do tempo e vendas. É a base de tudo o que vem depois: a leitura dos anúncios, a recuperação e as conversões enviadas ao Meta e ao Google.

Página Leads

Lista paginada com nome, e-mail, telefone, origem (UTMs) e estágio. Ao abrir um lead você vê:

• EstágioO pipeline é configurável por organização (padrão de 5 estágios). Uma venda move o lead para ganho; um estorno, para perdido.
• Linha do tempoLead criado, venda registrada, carrinho abandonado, pedido de estorno, estorno, notas e mudanças de estágio, na ordem em que aconteceram.
• VendasCada produto da venda é uma linha (o order bump aparece separado), com valor e valor estornado.

Funil do produto e receita atribuída

No Insights, o cartão Funil do produto mostra quem iniciou o checkout, quem comprou, quem pediu estorno e quem estornou, com a conversão entre as etapas e a receita bruta, estornada e líquida. O cartão Receita atribuída liga essa receita à campanha e ao anúncio de origem (pelo utm_campaign e pelo utm_content), o que dá o ROAS real, com vendas confirmadas pelo checkout.

Regras de follow-up

Em Settings, as regras reagem a um evento do lead (por exemplo, carrinho abandonado) ou a um lead parado num estágio há N horas, e executam uma ação: nota, mudança de estágio ou as ações de webhook e CRM.

Conversões offline (Meta e Google)

Com o módulo Conversões offline ligado, cada venda volta para as plataformas de anúncio, para o lance automático aprender com quem compra de verdade:

• MetaEvento de compra pela API de Conversões, com e-mail e telefone criptografados e o identificador do clique (fbclid) quando houver.
• GoogleConversão de clique com o identificador do clique (gclid, ou gbraid e wbraid no iPhone), o valor e os dados criptografados. Estorno vira ajuste da conversão.

14 Teste de criativos

Para testar vídeos com um conjunto de anúncios por vídeo. A página cruza os números do Meta com as vendas do checkout de cada anúncio e diz, com um semáforo, o que manter e o que pausar.

Escolher a campanha

O seletor lista as campanhas da conta de anúncios separadas em Com o pixel deste projeto e Com outro pixel, com as ativas primeiro. Se nenhuma campanha usar o pixel do projeto, nada vem escolhido e a página explica o motivo: escolha a campanha e confira o pixel em Projetos.

Ao lado ficam o período (desde o início, hoje, ontem, 3 ou 7 dias, ou desde um marco, com data e hora), o valor do produto, o orçamento do teste por conjunto (opcional) e o ROAS mínimo.

Leitura por anúncio e semáforo

Cada linha é um anúncio, com gasto, CTR, CPC, visitas, clique em comprar, checkout, compras, order bump, estorno, conversão da página, receita líquida e ROAS. A linha inteira ganha a cor do semáforo:

• AguardandoAinda não gastou o ponto de decisão (o valor de uma venda, ou 30% do orçamento do teste por conjunto). A barra Rumo à decisão mostra quanto falta. Antes disso, "bom sinal" e "atenção" vêm só do CTR.
• ManterVendeu com ROAS acima do mínimo.
• ObservarSem sinal claro para um lado ou outro; o motivo aparece embaixo do selo.
• PausarGastou o valor de duas vendas sem vender, ou a página converte menos de 1% mesmo com a margem de erro. Também recomenda pausar antes, pelo clique: depois de gastar metade do ponto de decisão, se o CTR estiver abaixo dos outros vídeos com segurança estatística.

O CTR mostra o intervalo de confiança, se está acima ou abaixo dos outros vídeos e a chance de ser o melhor do teste. A tabela é ordenada pelo desempenho (CTR enquanto não há venda, ROAS depois), com o selo de líder. A faixa no topo resume quantos estão se destacando, com atenção, para pausar e sem sinal.

Clique no nome do anúncio para ver o vídeo da biblioteca ligado a ele, a análise do vídeo (gancho, argumento, chamada, promessa, pontos fortes e riscos) e o link de teste, que simula o clique real; a compra feita por ele chega marcada como teste e fica fora da leitura.

Os botões de cada linha registram a decisão (validado ou reprovado) no histórico de criativos e pausam ou ativam o conjunto do anúncio.

Antes de publicar

A checagem aponta erro de montagem antes de gastar: orçamento da campanha em vez de por conjunto, evento diferente de compra, mais de um anúncio por conjunto, vídeo repetido, UTM ausente ou errada, Instagram desligado, aprimoramentos automáticos ligados, página de destino sem o script de rastreamento, anúncio parado por erro e falta de permissão de anunciante na Página.

Funil e linha do tempo

O cartão do funil mostra do clique à compra onde as pessoas estão saindo, com a etapa a investigar em destaque, e separa os posicionamentos (o Audience Network costuma trazer clique acidental e fica fora do CTR).

A Linha do tempo da campanha registra sozinha pausas, ativações, pausa automática e anúncio parado por erro. Mudanças de página, criativo ou posicionamento você registra à mão. Cada evento tem Medir a partir daqui, que muda o período para depois daquela mudança.

Acompanhamento e pausa automática

Com a campanha acompanhada, o Growth Studio confere de hora em hora e avisa (ver capítulo 16): mudança de semáforo, anúncio reprovado ou parado, campanha que parou de gastar, venda e estorno, além de um resumo diário. A pausa automática vem desligada; ligada, avisa antes e pausa na verificação seguinte se o anúncio continuar em "Pausar". Ela só pausa, nunca ativa, e aceita exceção por anúncio.

Criar o teste em lote e importar vídeos

Em Criativos, o botão Teste de criativos copia um conjunto modelo uma vez por vídeo e cria o anúncio com o mesmo texto do modelo, trocando só o vídeo. Tudo nasce pausado, depois de uma pré-visualização que só lê o Meta. Em Criativos também fica o Importar da Fábrica: um token por projeto para receber vídeos de fora, que já chegam enviados ao Meta e analisados.

O botão Analisar vídeos deixa escolher quais vídeos a IA analisa, e o Relatório gera um PDF igual ao painel.

15 Rastreamento das vendas

Para cada venda chegar ligada ao anúncio que a trouxe, três peças precisam estar certas: as UTMs do anúncio, o script na página de vendas e o webhook do checkout.

1. UTMs do anúncio. No Meta, o padrão é utm_content={{ad.name}}__{{ad.id}}: a leitura liga pelo ID, então renomear o anúncio não quebra nada. No Google, o Growth Studio padroniza na conta inteira a marcação automática e o sufixo com utm_term={keyword}, que vale para campanhas atuais e futuras.
2. Script na página de vendas. O cartão mostra o código para colar na página. Ele repassa as UTMs e os identificadores de clique (fbclid, gclid, gbraid, wbraid) ao link do checkout (Hubla, Kiwify, Hotmart, Cakto e outros) e guarda o clique por 30 dias, para quem volta depois sem as UTMs.
3. Webhook do checkout. Ver capítulo 7.

O Growth Studio avisa quando algo não bate: compra que o Meta viu e não chegou do checkout, venda com anúncio que não está na campanha acompanhada e muitas vendas sem anúncio.

16 Avisos

Todo evento importante fica registrado no sino e na página Avisos. Cada pessoa escolhe o que também chega no celular ou no e-mail.

• CanaisTelegram (conectado por um código enviado ao bot) e e-mail. As escolhas são por pessoa, não por organização.
• TiposVenda (com destaque para a primeira venda de um anúncio), estorno e pedido de estorno, mudança de semáforo, anúncio reprovado, anúncio ou campanha que parou de veicular, avisos da pausa automática, resumo diário, problema no rastreamento das vendas e conexão com Google Ads ou Meta caída.
• SilêncioDas 22h às 7h, só os avisos urgentes chegam.

17 Recuperação

Fila de quem quase comprou: abandonou o checkout, teve o pagamento recusado ou deixou o PIX ou o boleto vencer.

Cada linha mostra o motivo, o anúncio de origem, há quanto tempo foi e o status do contato. O botão abre o seu WhatsApp com a mensagem pronta; nada é enviado sozinho. Quem compra depois sai da fila e conta como recuperado. A mensagem e o link do checkout são editáveis.

18 Pesquisa Google

Campanhas da rede de pesquisa do Google: criar, ler cada palavra-chave com as vendas do checkout e entender o que impede a campanha de aparecer. Beta

Conectar

1. Ligue o módulo Google Ads em Settings.
2. No cartão Google Ads, conecte a conta Google que administra a conta de anúncios (pela conta gerente, se houver) e informe a ação de conversão de compra.
3. Na conta de anúncios do Google, ligue Conversões otimizadas para leads em Metas, Conversões, Configurações. Ligue na própria conta de anúncios, e não só na conta gerente.

Se a conexão cair, o Growth Studio avisa, e avisa de novo quando ela voltar.

Diagnóstico da campanha

Mostra, do mais grave ao mais leve, o que impede a campanha de aparecer ou de render, cada item com o que fazer: anúncio reprovado ou em análise, palavras raramente exibidas ou com 10 buscas por mês ou menos, nota de qualidade baixa com a parte abaixo da média, lance por conversão sem nenhuma conversão ainda e impressões perdidas por orçamento ou por classificação. Uma campanha ativa que passa 6 horas sem aparecer, de dia, gera aviso.

O diagnóstico também oferece a troca de lance, com confirmação: para Maximizar cliques com teto quando a campanha ainda não tem conversão, e para Maximizar conversões a partir de 5 conversões.

Palavras-chave e termos de pesquisa

Cada palavra-chave tem buscas por mês, números do Google e as vendas do checkout (pelo utm_term), com o mesmo semáforo do teste de criativos. Os termos que as pessoas digitaram aparecem com sugestão de palavra negativa (grátis, pdf, emprego, ou termo que gastou sem vender); Negativar põe o termo como negativa da campanha.

Nova campanha de pesquisa

Só rede de pesquisa do Google, Brasil e português, com UTMs automáticas. Cada grupo tem palavras-chave ([exata], "frase" ou ampla), títulos e descrições com contador de caracteres, e o botão Ver volume de busca, que mostra buscas por mês, concorrência e custo do clique pelo planejador do Google, com ideias de palavras com mais busca.

O lance começa em Maximizar cliques com teto (R$ 1,50 por padrão): em conta sem vendas no Google, Maximizar conversões costuma dar lances baixos e a campanha quase não aparece. Primeiro o Google confere tudo; depois a campanha é criada pausada.

Linha do tempo

Tudo o que mudou na campanha nos últimos 30 dias, com quem mudou (o Growth Studio, você na tela do Google Ads ou o próprio Google): lance, orçamento, palavras, negativas, anúncios, ativação e pausa.

19 O que vem a seguir

Recursos em desenvolvimento — sujeitos a mudança, sem data comprometida.

Alguns recursos futuros vão nascer com o selo Beta e poderão ser ativados individualmente por organização, em uma seção própria de Settings — nenhum recurso novo é ligado automaticamente para todo mundo.

• WhatsApp para avisos e para a recuperação de carrinho, hoje feita pelo seu WhatsApp com a mensagem pronta.
• Agenda e assistente de vendas: agendamento, propostas e acompanhamento do lead pela equipe comercial.
• Analista de IA e previsão: leitura automática das campanhas e projeção de resultado.
• Novos canais de anúncio além do Meta e da pesquisa do Google.

O CRM com pipeline, as conversões offline para Meta e Google e a pesquisa do Google, que estavam nesta lista, já fazem parte da plataforma (capítulos 13 e 18).

20 Glossário

• CPACusto por aquisição — investimento dividido pelo número de conversões.
• ROASRetorno sobre investimento em anúncios — receita gerada dividida pelo investimento.
• PacingRitmo de consumo do orçamento ao longo do período, comparado à projeção esperada.
• UTMParâmetro de rastreamento na URL que identifica a origem, mídia e campanha de um clique.
• HMACAssinatura criptográfica usada para confirmar que um payload de webhook realmente veio da origem esperada.
• PixelCódigo de rastreamento do Meta instalado no site do cliente final, usado para medir conversões dos anúncios.
• CTRTaxa de cliques: cliques no link divididos pelas impressões.
• CPCCusto por clique.
• utm_content e utm_termUTMs que identificam o anúncio (Meta) e a palavra-chave (Google). É por elas que a venda volta ao anúncio de origem.
• fbclid, gclid, gbraid, wbraidIdentificadores do clique no anúncio (Meta e Google). Enviados de volta com a venda, ligam a compra ao clique exato.
• Ponto de decisãoQuanto cada conjunto precisa gastar antes de o semáforo decidir: o valor de uma venda, ou uma parte do orçamento do teste.
• Intervalo de confiançaFaixa onde o número verdadeiro provavelmente está; com pouca amostra, a faixa é larga e a decisão espera.
• Conversão offlineVenda confirmada pelo checkout enviada de volta ao Meta ou ao Google, para o lance automático aprender.
• Palavra negativaTermo que impede o anúncio do Google de aparecer em buscas que não vendem.
• Parcela de impressõesQuantas vezes o anúncio apareceu, das vezes em que poderia aparecer; o resto se perde por orçamento ou por classificação.