Código de erro 400 no Google Ads: resolver e evitar

Vamos ser diretos. O código de erro 400 no Google Ads costuma dar a sensação de que “algo está errado”, sem mostrar logo o quê. E em campanhas onde tempo é dinheiro, não queres mistério, queres método. Neste guia, vamos ver juntos o que um “400” normalmente significa no contexto do Google Ads e como o diagnosticar em pouco tempo. Mantemo-nos práticos: primeiro afinas o problema, depois testas de forma direcionada e, por fim, crias prevenção para que a tua equipa não tenha de recomeçar sempre do zero.

Antes de mais, atenção: “Google Ads 400” é usado na prática em vários sítios. Às vezes aparece na interface do Google Ads, outras vezes no import, no tracking ou numa integração ou ligação. Por isso, este guia começa com uma pergunta simples: onde vês exatamente o 400?

O que significa normalmente “Google Ads 400” e por onde começa o diagnóstico?

Em muitos sistemas, o código HTTP 400 significa “Bad Request”. Em essência: o pedido que o teu sistema envia não está correto (ou não é aceite) porque falta algo, há algo inválido ou está fora das regras. Na Google Ads API, este tipo de problema também costuma estar ligado a “invalid argument” e a problemas de validação semelhantes, em que os detalhes da mensagem de erro indicam qual o parâmetro ou valor que não está certo. (developers.google.com)

Passo 1: identifica a origem do erro

Usa esta divisão para não perderes tempo no caminho errado.

Na interface do Google Ads: o erro aparece ao guardar, alterar ou ativar anúncios, campanhas, públicos ou assets.
Durante upload, importação ou ficheiro em massa: o erro aparece numa execução de upload ou ao carregar um feed ou asset.
Em tracking ou processamento da landing page: o erro surge durante o processamento de tags, importação de conversões ou ligação de parâmetros de URL.
Via integração ou API: o erro aparece no teu connector, no teu script, no teu fluxo de automation ou nos logs dos teus analytics ou pipelines de dados de ads.

Passo 2: junta os detalhes de que precisas

Não fiques apenas pelo “400”. Garante que tens uma captura de ecrã ou uma linha de log com:

o texto exato do erro
o momento em que acontece (por exemplo, ao guardar ou ao importar)
o objeto (anúncio, campanha, público, asset, item do feed)
o valor que pode estar a causar o problema (por exemplo, URL, ID, parâmetro, nome de campo)

Em erros de API, muitas vezes vês na estrutura do erro os “details” que mostram quais os argumentos ou campos problemáticos. Isso não é um extra simpático, é o teu mapa. (developers.google.com)

Principais causas do código de erro 400 no Google Ads e como excluí-las rapidamente

Vamos às causas mais comuns, por ordem de “mais vistas na prática” e “mais rápidas de testar”. Esta não é uma lista mágica, mas sim uma triagem prática que usamos muitas vezes em SEA e em projetos de otimização de conversão.

1) Campos ou valores inválidos em ligações, integrações, API e scripts

Se vês um 400 nos logs de uma ligação, é muito provável que tenha falhado uma validação. Isso pode acontecer por:

um campo que não existe ou que tem outro nome
um valor fora do formato ou do intervalo permitido
um campo “vazio” onde era esperado um campo obrigatório
uma incompatibilidade de tipo (por exemplo, texto onde era esperado um número)

Na Google Ads API, é recomendado olhar explicitamente para os detalhes do erro, porque normalmente indicam qual o argumento que não está correto. (developers.google.com)

Teste rápido: volta a tua alteração para a versão anterior e tenta de novo. Se funcionar, sabes que a causa está na última alteração, e não em toda a configuração.

2) Problemas de URL ou da landing page em tracking de conversões e importação de conversões

Parece simples, mas vemos isto muitas vezes: o erro não acontece porque o teu anúncio está “errado”, mas porque a tua landing page ou os componentes de tracking não processam de forma consistente o que o Ads espera.

Pensa nisto:

parâmetros de URL que não estão bem codificados em URL
cadeias de redirect com formatos de URL inesperados
tags de conversão que disparam, mas não correspondem à definição da conversão

Teste rápido: passa uma campanha ou um anúncio por um cenário “limpo”. Ou seja, uma única URL principal sem parâmetros extra, e confirma se a tag de conversão continua correta. Se o 400 desaparecer, encontraste um candidato consistente.

3) Problemas em uploads, imports ou processos do tipo feed

Os ficheiros em massa e os feeds são úteis… até que uma coluna tenha um nome ligeiramente diferente do que o import espera. Aí surgem erros de validação que voltam como 400.

Causas frequentes:

falta uma coluna obrigatória
a coluna existe, mas contém valores vazios
são ultrapassados limites de comprimento ou de formato

Em “common errors” da Google Ads API, encontras por exemplo tipos como “string mais longa do que o limite”. (developers.google.com)

Teste rápido: importa um conjunto mínimo de linhas (por exemplo, 1 campanha ou 10 itens). Se isso funcionar, avança passo a passo até ao ponto em que falha. Não estás à procura “do ficheiro inteiro”, mas sim da linha ou parâmetro específico.

4) Validação relacionada com conta ou acesso (por vezes visível, por vezes não)

Nem todo o 400 é apenas “o teu input está errado”. Em algumas integrações, o acesso, os scopes ou as permissões também podem gerar um problema de validação que regressa como erro de pedido. A Google Ads API documenta este tipo de tratamento de erro como parte dos “common errors” e de como os resolver. (developers.google.com)

Teste rápido: verifica se o connector está a usar o mesmo utilizador, o mesmo nível de conta e a mesma permissão da última execução que funcionou. Se ajustaste permissões recentemente, começa por aí.

Checklist prática de troubleshooting, de 0 a funcionar numa só sessão

Esta é a nossa abordagem “profissional com café”. Curta, concreta e pensada para não te deixar bloqueado.

Checklist A: diagnóstico em 15 minutos

Regista onde vês o 400 (interface, import, tracking, logs da API).
Guarda o texto do erro que aparece, incluindo detalhes, se existirem. Em erros de API, esses detalhes costumam estar na estrutura do erro. (developers.google.com)
Identifica o objeto (campanha, anúncio, asset, item do feed).
Percebe o que mudou há pouco (parâmetro, template, script, coluna do feed, URL com tagging).
Faz rollback: repõe a última alteração ou desativa uma integração de cada vez.

Checklist B: resolução dirigida por cenário

Escolhe o que se aplica.

Cenário 1: erro na API ou na integração

Segue esta lógica:

Procura nos logs qual o parâmetro ou campo indicado pelos detalhes do erro.
Confirma o tipo e o formato. Garante que números não estão como texto e que o nome exato do campo está certo.
Valida limites. Se o erro indicar que uma string é demasiado longa, corrige esse comprimento e encurta o input.
Depois, volta a executar com um único objeto pequeno, e não com todo o lote.

A Google recomenda explicitamente que se olhem os detalhes e que se ajuste o pedido com base neles. (developers.google.com)

Cenário 2: erro no upload ou na importação

Cria um “small test file” com os mesmos nomes de colunas e exatamente os mesmos tipos de dados.
Atualiza uma linha de cada vez até o upload voltar a falhar; assim ficas perto da causa.
Confirma campos obrigatórios e células vazias. Em contexto de API, vê-se que campos vazios podem levar a problemas de validação. (ads-developers.googleblog.com)

Cenário 3: erro em tracking ou na landing page

Testa uma variante da landing page sem parâmetros extra de URL.
Confirma se a tag ou script dispara mesmo na página onde esperas a conversão.
Verifica se a cadeia de redirect não gera uma URL inesperada (por exemplo, com parâmetros em falta).

Checklist C: evita a repetição com uma melhoria estrutural

Se isto acontece com frequência, normalmente não é “azar pontual”. É um problema de processo. Por isso, torna o processo robusto.

Validação de input antes da ligação: verifica comprimento de campos, formato e campos obrigatórios no teu próprio processo.
Gestão de versões para templates de URL e feeds: se alguém alterar um parâmetro, sabes logo qual a execução que falhou.
Ambiente de teste ou lote de prova: começa sempre por 1 ou 10 objetos antes de colocares uma campanha ou feed inteiro em live.
Logging claro: guarda os detalhes do erro, não apenas o código.

Como isto afeta o desempenho em SEA e o que deves medir

Vamos colocar isto em termos comerciais. Um código de erro 400 não trava apenas a alteração. Dependendo da causa, também pode afetar:

delivery de anúncios (se assets ou campanhas não forem guardados ou ativados corretamente)
tracking de conversões (se atualizações a tags ou conversões falharem)
qualidade dos dados (levando-te a otimizar com base em sinais errados)

Por isso, depois da correção, tens de confirmar se a tua métrica está certa.

O que deves verificar de imediato

Conversas ou conversões: o volume está certo e coincide com o padrão esperado?
Cost Per Acquisition (CPA), tendo em atenção qual a definição que vocês usam (por aquisição ou por ação): o CPA sobe ou desce de forma lógica depois da correção?
Conversion Rate (CVR): o CVR mexe de forma consistente ou há uma falha de dados?
Click Through Rate (CTR): o CTR muda se os ads ou assets tiverem sido guardados de novo?

Dica da prática: trata o diagnóstico como CRO (Conversion Rate Optimization) para o teu tracking e para a governação das campanhas. Não é sexy, mas é eficiente. Se os teus dados estão errados, estás a otimizar no vazio.

Trade-offs que deves conhecer

Uma correção rápida pode perturbar temporariamente o tracking: se fizeres “hotfixes”, confirma sempre depois as definições de conversão.
O rollback pode ter impacto no budget: repõe o que alteraste, mas tem atenção ao planeamento, aos lances e ao timing.
Mais logging significa mais overhead: queres detalhes, mas não à custa de velocidade ou stability no teu workflow.

Prevenção na prática: cria um workflow à prova de Google Ads 400

Não queres ser detetive todos os trimestres. Por isso, vamos organizar a prevenção para que a tua equipa veja os erros mais cedo e os corrija mais depressa.

Passo de prevenção 1: padroniza os teus assets de SEA e a nomenclatura

Muitos erros de input nascem da inconsistência. Não por má intenção, mas porque “cada um preenche de maneira diferente”. Padroniza:

final URLs dos anúncios e conjuntos de parâmetros
convenções de nomenclatura dos assets
nomes de colunas do feed e tipos de dados

Se mantiveres isto alinhado, reduces problemas de validação e poupas horas de debugging.

Passo de prevenção 2: cria uma pequena “preflight check”

Antes de entrares em live com bulk ou integrações, corre uma preflight check. Pensa em:

cada campo obrigatório existe?
comprimentos e formatos estão corretos?
os parâmetros de URL estão bem formatados?

O motivo é simples: na validação de pedidos, a diferença entre funcionar e não funcionar é muitas vezes muito precisa. A Google descreve este tipo de erros guiados por validação e como evitá-los usando os detalhes. (developers.google.com)

Passo de prevenção 3: faz do SEO e do SEA o apoio um do outro

É aqui que tornamos a equipa realmente mais forte. Se o SEA mudar algo, o SEO pode ajudar na consistência da landing page, na estrutura e no matching de conteúdo. Se o SEO mudar algo, o SEA pode ajudar com tráfego e material de teste. Não precisas de tornar isto “complexo”, mas vais ganhar ciclos de feedback mais rápidos.

Queres organizar isto de forma mais inteligente? Lê também: Seo sea: colaboração inteligente entre SEO e SEA.

Passo de prevenção 4: escolhe apoio com profundidade técnica

Às vezes, o problema não está na tua execução, mas na tua configuração de implementação. Nessa altura, vale a pena envolver alguém que perceba tanto de ads como de tracking.

Se estás a pensar nisso, ajuda perceber no que deves reparar, vê: Contratar um especialista em Google AdWords: no que prestar atenção.

Para casos de uso específicos, atenção extra

Dependendo do teu tipo de campanha, os erros 400 podem tornar-se mais típicos em feeds ou templates de página.

Se fazes e-commerce, confirma a estrutura do feed e as ligações do tipo Merchant. Também útil: Google Ads Shopping: publicidade e-commerce otimizada.
Se anuncias hotéis, presta atenção extra ao routing de URL e ao destino. Vê: Google Hotel Ads: reservar hotéis através do Google. Prático.

Qual é o próximo passo se hoje quiseres mesmo resolver esse 400?

Nada de checklist final vaga, mas sim um plano concreto para amanhã.

Responde a uma pergunta: onde vês exatamente “google ads 400” (interface, upload/import, tracking, integração/API)?
Recolhe os detalhes do erro e liga-os ao objeto (anúncio, campanha, asset, item do feed).
Faz um rollback ou um teste mínimo: um cenário pequeno, uma URL, uma execução. Assim encontras a causa mais depressa.
Valida o tracking e as definições de conversão antes de voltares a otimizar os teus KPI’s.
Faz da prevenção parte do teu workflow, e não uma verificação solta. Uma preflight check e um logging claro poupam muitas repetições.

E se reparares que o teu âmbito cresce logo para lá de uma única mensagem de erro, isso é sinal de que tens de apertar a governação em torno das alterações em ads, das landing pages e do tracking de conversões. Isso também encaixa numa abordagem de crescimento mais ampla, por exemplo quando tratas SEO, SEA e CRO em conjunto, vê: Agência de webdesign: crescer com SEO, SEA e CRO.

Conclusão: resolver o Google Ads 400 é, acima de tudo, diagnosticar bem

O código de erro 400 no Google Ads é, na maioria dos casos, menos um mistério e mais um problema de validação. O caminho mais rápido é este: onde vês o erro, que objeto está envolvido e que detalhes te dão direção. Depois ajustas o input ou a configuração, testas em pequeno e confirmas os teus dados de conversão para que a otimização não corra com sinais errados.

Quando montas este processo uma vez, ficas com um workflow que apanha os erros mais cedo e te rouba menos tempo. E, sinceramente, isso é tão bom como um café bem tirado, só que para as tuas margens.