Anúncios (Meta, TikTok e Google Ads)

Estes nós leem o desempenho das suas campanhas e mexem nelas: pausam, ativam e ajustam orçamento. Aparecem na paleta do editor em Integrações, sob Meta Ads, TikTok Ads e Google Ads.

Com eles você monta automações como: consolidar o gasto das três plataformas numa planilha toda manhã, pausar a campanha que passou do custo por lead combinado, ou subir o orçamento do que está performando bem. No Google Ads o caminho também vai de volta — quando o lead vira venda, o fluxo conta isso ao Google, e a campanha passa a otimizar pelo que fecha negócio.

Antes de começar: cada plataforma exige uma liberação

Este é o ponto em que a maioria das integrações de anúncio trava, e vale conhecer antes de montar o fluxo.

Nada disso é feito aqui — é tudo na plataforma de origem. Depois de pronto, você cadastra a credencial e os nós funcionam.

O que vale para todos

• Escolha a credencial no topo do nó.
• Todo campo de texto aceita {{ … }} com dados do item.
• Todos têm uma saída (main).
• Os nós de relatório e listagem emitem um item por linha do resultado.
• Os nós de ação devolvem o item acrescido de _meta_ads ou _tiktok_ads.
• Na aba Config ficam Timeout (segundos) (padrão 60) e Saída do nó (Mesclar item ou Substituir item) — veja Ajustes do nó.

Números diferentes dos painéis são normais nas primeiras horas. As três plataformas continuam ajustando os números de um dia por vários dias depois dele — relatório "fechado" só bem depois do fim do período.

Os nós

Meta Ads

Meta Ads — Insights (relatório)

O nó de métricas. Escolha o Nível (Conta, Campanha, Conjunto de anúncios ou Anúncio) e as Métricas, separadas por vírgula — o padrão já traz gasto, impressões, cliques, custo por clique, custo por mil e taxa de cliques.

O Período aceita atalhos (Hoje, Ontem, Últimos 7 dias, Últimos 14 dias, Últimos 30 dias, Este mês, Mês passado, Máximo disponível) ou Personalizado, e aí você preenche Desde e Até no formato AAAA-MM-DD.

Dois campos abrem o relatório:

Emite um item por linha do relatório.

Períodos muito longos combinados com muitas métricas e segmentações são recusados pela Meta. Se acontecer, reduza o período, tire segmentações ou peça menos métricas por vez.

Meta Ads — Listar campanhas

Em O que listar, escolha Campanhas, Conjuntos de anúncios ou Anúncios. Em Campos, os dados que devem vir de cada registro (o padrão já traz nome, situação, objetivo e orçamento). Filtrar por situação recorta a lista — por exemplo, ACTIVE para trazer só o que está veiculando.

Emite um item por registro.

Meta Ads — Pausar/Ativar

Informe o ID do objeto (da campanha, do conjunto ou do anúncio) e a Situação: Ativar ou Pausar.

Sai o item com _meta_ads.

Meta Ads — Ajustar orçamento

Informe o ID do objeto, o Tipo de orçamento (Diário ou Total) e o Valor.

O valor vai em centavos. R$ 500,00 se escreve 50000. Mandar 500 cria um orçamento de cinco reais — este é o erro mais caro desta página. A Meta também recusa orçamentos abaixo do mínimo da moeda da conta.

Sai o item com _meta_ads.

Para cadastrar a credencial Meta Ads

Prefira gerar o token sem expiração. Ele ainda assim deixa de valer se o usuário do sistema for removido, se o aplicativo perder o acesso à conta ou se a permissão for revogada — nesses casos, a saída é gerar um novo e atualizar a credencial.

TikTok Ads

Os quatro nós usam a conta de anúncio da credencial por padrão; o campo Advertiser ID de cada nó permite apontar outra conta, se o mesmo acesso cobrir várias.

TikTok Ads — Relatório

Escolha o Nível (Conta, Campanha, Grupo de anúncios ou Anúncio), as Dimensões e as Métricas (separadas por vírgula ou uma por linha), e as datas inicial e final no formato AAAA-MM-DD.

A dimensão de tempo é o que define a granularidade: incluir stat_time_day gera uma linha por dia; sem ela, o período sai consolidado.

Emite um item por linha, com as métricas já convertidas para número.

As datas seguem o fuso da conta do anunciante, definido no painel do TikTok e impossível de mudar depois. Se a conta está num fuso diferente do seu, "ontem" para ela pode não ser "ontem" para você — vale conferir antes de agendar o fluxo para a madrugada.

TikTok Ads — Listar

Escolha a Entidade (Campanhas, Grupos de anúncios ou Anúncios) e, se quiser, um Filtro (JSON). Registros por página controla o volume (padrão 100).

Emite um item por registro.

TikTok Ads — Ligar/Desligar

Escolha a Entidade, informe os Ids (um ou vários, separados por vírgula) e a Operação: Ativar ou Pausar.

Sai o item com _tiktok_ads.status.

TikTok Ads — Orçamento

Escolha a Entidade (Grupos de anúncios ou Campanhas), informe os Ids e o Orçamento.

Aqui o valor vai na moeda da conta, e não em centavos — 500.00 são quinhentos. O TikTok valida o mínimo permitido para a moeda e recusa valores abaixo dele.

Sai o item com _tiktok_ads.orcamento.

Para cadastrar a credencial TikTok Ads

O acesso não expira sozinho, mas acaba se o anunciante desautorizar o aplicativo. Quando tudo passa a ser recusado de uma vez, é isso: refaça a autorização e atualize a credencial.

Google Ads

Google Ads — Consulta (GAQL)

No Google Ads toda leitura passa por uma consulta — não existe uma listagem pronta. Escreva a Consulta GAQL e cada linha vira um item:

SELECT campaign.name, metrics.clicks, metrics.impressions, metrics.cost_micros
FROM campaign
WHERE segments.date BETWEEN '2026-07-01' AND '2026-07-31'

Três coisas a saber ao escrever:

• Os nomes de campo vão em minúsculas com sublinhado, como no exemplo.
• As datas vão no formato AAAA-MM-DD.
• O Google devolve dinheiro multiplicado por um milhão, em campos terminados em _micros. Com Converter valores em micros para reais ligado — como já vem —, cada um desses campos ganha uma cópia pronta ao lado: metrics.cost_micros com 25500000 vira metrics.cost_reais igual a 25,50. Use direto o campo em reais; o original continua vindo, para quem precisar dele.

O Limite de registros (padrão 1000) é o teto do que o nó traz percorrendo as páginas do resultado.

O campo Conta (customer id) vale para os sete nós do Google Ads: em branco usa a conta padrão da credencial. Escreva só dígitos, sem hífens.

Google Ads — Listar campanhas

Traz as campanhas da conta sem você escrever consulta nenhuma. Escolha o Status (Ativas, Pausadas ou Todas, exceto removidas), as Métricas do período (Sem métricas, Últimos 7 dias, Últimos 30 dias, Este mês ou Mês passado) e o Limite de registros (padrão 1000).

Emite um item por campanha, com nome, situação, tipo, orçamento e as métricas do período — já com os valores em reais ao lado dos originais. É por onde começar quando você ainda não conhece a GAQL.

Google Ads — Pausar/ativar campanha

Informe o ID da campanha (o número que a consulta devolve em campaign.id) e o Novo status: Pausar ou Ativar.

Google Ads — Ajustar orçamento

Informe o Orçamento — o identificador do orçamento, que a consulta devolve em campaign.campaign_budget — e o Valor diário em reais, como 25,50. A conversão para o formato que o Google espera é feita pelo nó.

Note que o orçamento é um registro à parte da campanha: se várias campanhas compartilham o mesmo orçamento, alterá-lo afeta todas elas.

Google Ads — Enviar conversão

Fecha o outro lado da conta: conta ao Google a venda que aconteceu depois do clique, mesmo que ela tenha sido fechada por telefone, no balcão ou semanas depois. É com isso que o Google aprende quais anúncios trazem cliente de verdade, e não só clique.

Em Operação você escolhe entre Enviar conversão nova e Corrigir conversão já enviada — corrigir serve para mudar o valor (a venda foi maior), anular (o negócio caiu) ou completar os identificadores.

O identificador do clique precisa ter sido capturado lá na origem. Ele chega na URL quando a pessoa vem do anúncio e some se o seu formulário não o gravar junto do lead — sem ele (e sem e-mail ou telefone), não há a que casar a venda, e o item sai marcado com o motivo, sem consumir sua cota. Guardar o identificador no cadastro do lead é o passo que faz esse nó valer.

O nó envia tudo de uma vez, num lote só, e devolve o desfecho de cada item na posição dele — o que falhou vem dito, e o restante segue.

Google Ads — Público (Customer Match)

Monta uma lista de público a partir dos e-mails e telefones de todos os itens que chegaram: para mostrar anúncio a quem já é seu cliente, ou para tirar das campanhas de captação quem já comprou.

Os dados saem sempre embaralhados. Duas coisas para não esperar resultado imediato: o casamento com os usuários do Google leva algumas horas, e a lista só fica utilizável em campanha com alguns milhares de pessoas — o Google recomenda ao menos 5.000.

Google Ads — Chamada de API

A saída para o que os demais nós não cobrem: criar campanha, palavra-chave negativa, ação de conversão. Informe o Método (GET ou POST), o Caminho e, no POST, o Corpo (JSON).

O caminho é só o trecho depois da versão da API, que o nó já acrescenta. Escreva {customer_id} onde entra a conta escolhida no nó:

customers/{customer_id}/campaignCriteria:mutate

Nos dois campos valem {{ … }} com dados do item. Corpo que não seja JSON válido é recusado com o aviso, antes de a chamada sair.

Para cadastrar a credencial Google Ads

Preencher o campo do MCC quando ele não é necessário — ou deixá-lo vazio quando é — resulta em acesso negado, com a credencial correta. É a causa mais comum de "não consigo conectar" no Google Ads.

O nível inicial do token de desenvolvedor permite poucos milhares de chamadas por dia. Um fluxo agendado de minuto em minuto consome isso antes do fim do dia: comece com execuções espaçadas e solicite o nível seguinte se precisar de mais.

Veja também: Credenciais, Metabase e Ajustes do nó.