trizup blog Testar grátis

Início→Blog→Rastrear

gclid, gbraid e wbraid: a diferença e quando cada um vale

A importação offline do Google aceita a venda e descarta em silêncio. Veja o que cada identificador faz e onde a conversão se perde.

Compartilhar
SF Sylas Filho · 9 min de leitura

Você sobe a planilha, o Google diz que a importação foi concluída e, uma semana depois, a coluna de conversões da campanha continua parada. Nenhum erro na tela. A venda foi aceita e não foi contada.

A resposta que mais se repete é "use o gclid". Está incompleta. O gclid resolve uma parte dos cliques, e é a parte que vem encolhendo desde 2021. O resto do problema mora em três lugares: qual identificador a venda carrega, quantos dias o clique tem e se alguém abriu o relatório de diagnóstico depois do envio.

Por que a importação aceita e não conta

Resposta curta: o envio valida o formato da linha, não a atribuição. A documentação da API do Google avisa que uma resposta de sucesso na importação "não significa necessariamente que as conversões foram atribuídas" (tradução livre). O Google confere se a linha está bem formada. Casar aquela linha com um clique que ele ainda guarda acontece depois, e é aí que a venda some sem barulho.

Três situações respondem pela maior parte dessas perdas:

  1. A linha chegou sem identificador de clique utilizável. O campo está vazio, o valor veio cortado, ou o identificador é de um tipo e foi parar na coluna de outro.
  2. O clique é velho demais. O Google guarda o gclid por 90 dias. Passou disso, o erro é "identificadores ou parâmetros de URL do iOS muito antigos".
  3. A conversão chegou cedo demais. Clique com menos de 6 horas dá "clique recente demais", e o Google pede para reenviar depois. Com gbraid ou wbraid, o próprio Google diz que o processamento pode levar até 72 horas.

O primeiro item é o que derruba mais gente, e ele depende de entender os três identificadores.

O que cada identificador é

Os três são parâmetros que o Google acrescenta ao endereço da página de destino quando a marcação automática está ligada. O que muda é o tipo de clique que cada um acompanha.

identificadoro que a documentação da API do Google diz
gclidCapturado da URL quando alguém clica no anúncio e navega até o seu site. É o identificador clássico.
gbraidPresente quando o usuário clica num anúncio na web e é direcionado para o seu app iOS.
wbraidPresente quando o usuário clica num anúncio dentro de um app iOS e é direcionado para a sua página web.

Fonte das duas últimas linhas: documentação de upload de cliques da API do Google Ads. É a definição mais específica que encontrei.

Uma ressalva. Outras páginas do Google e muitos textos de terceiros descrevem os dois braid de outro jeito (um como "conversão de app", o outro como "conversão de web"). Eu fico com a definição da API e sugiro conferir o texto atual do Google antes de repetir essa distinção para o cliente. O que aparece igual em todas as fontes:

  • gbraid e wbraid surgiram em 2021 por causa das políticas da Apple para o iOS 14, para o Google continuar medindo conversão sem depender do gclid;
  • desde 26 de abril de 2021 o Google deixou de enviar o gclid para tráfego de iOS 14 vindo de anúncios em alguns apps do Google, e ele mesmo avisa que isso pode reduzir as conversões offline importadas por clique;
  • na importação, cada identificador tem o seu campo.

Para quem anuncia para WhatsApp, o ponto prático é este: o lead que clicou pelo iPhone, num anúncio dentro de um app, pode não ter gclid. Se o seu processo só sabe guardar gclid, esse lead é uma venda que vai ser descartada, com todo o resto certo.

Um identificador por venda, e quem tem prioridade

Aqui existe uma divergência que pouca gente conta.

Quando implementamos o envio offline para rodar em produção, tratamos os três como mutuamente exclusivos: a venda sobe com um identificador só, na ordem gclid, depois gbraid, depois wbraid. Foi a leitura que fizemos da orientação do Google, e funciona.

A documentação atual da API é mais flexível. Ela diz que aceita qualquer combinação dos três no mesmo registro, pede que você inclua todos os que capturou e define a precedência quando mais de um aparece: gclid, depois wbraid, depois gbraid. Repare na ordem: wbraid antes de gbraid, o contrário do que usamos. Na prática o mesmo clique raramente traz os dois braid, então a diferença quase nunca aparece. Se a sua ferramenta ou a sua planilha escolhe entre eles, confira a ordem que ela segue.

Duas consequências da regra de precedência, ambas da documentação:

  • Se a linha leva só wbraid ou gbraid, sem gclid, o Google ignora os dados de usuário (telefone ou e-mail com hash) enviados junto. Completar a linha com telefone não ajuda quando o clique é de iPhone.
  • Se você tem o gclid, mande-o mesmo quando também envia dados de usuário. O Google recomenda isso de forma explícita.

Do clique à venda: o caminho que o identificador precisa sobreviver

O gestor que roda campanha para WhatsApp tem um problema de distância. O clique acontece numa página (ou num link), e a venda acontece dias depois, dentro de uma conversa. O identificador precisa atravessar esse intervalo. O mecanismo que funciona tem quatro peças:

  1. Captura no clique. A página de destino, ou o link que leva ao WhatsApp, lê gclid, gbraid e wbraid da URL e guarda os três junto com o horário do clique. Guardar só o gclid deixa o iPhone do exemplo sem rastro.
  2. Limpeza do valor. Placeholder de anúncio que não foi substituído (o texto literal entre chaves, como {gclid}) tem que ser descartado. Senão a linha entra como preenchida e falha na importação.
  3. Casamento com a conversa. Quando a mensagem chega, ela é ligada ao clique mais recente do mesmo visitante, numa janela curta. No nosso caso, 30 minutos. Passou disso, é outra conversa.
  4. Decisão no momento da venda. Só aqui se escolhe o que enviar.

A quarta peça é onde os fluxos improvisados falham: não decidem nada, mandam tudo e deixam o Google descartar. Um fluxo que decide faz três perguntas, nesta ordem.

Há algum identificador? Se não há, a venda não sobe. Testamos o caminho do telefone com hash sem clique em 27 de outubro de 2026: foram 62 conversões enviadas, só 2 com gclid, e o Google respondeu "No user-provided data matches" nas outras 60. Sem clique não há o que atribuir, e mandar dado pessoal a terceiro à toa é risco sem retorno.

O clique ainda está na janela? O limite documentado é de 90 dias, e a idade que conta é a do clique, não a da venda. Quem fecha no dia 85 já está perto da borda. No dia 91, perdeu. Por isso o Google recomenda enviar ao menos uma vez por dia.

A consulta ao clique funcionou? Essa é sutil. "Não achei o clique" e "deu erro ao procurar o clique" são situações diferentes. A primeira é definitiva. A segunda tem que ser reenviada. Fluxo que trata as duas como "sem clique" perde venda por falha de infraestrutura e ainda registra o lead como se nunca tivesse vindo do Google.

Um detalhe sobre data: às vezes o identificador existe e o horário do clique não foi gravado. Nesse caso usamos a data da primeira mensagem do lead como aproximação. É escolha de cautela nossa, não regra do Google.

Também aplicamos um limite menor, de 7 dias, para gclid que começa com "EAIa", que tratamos como clique de iPhone. Não encontrei essa regra na documentação do Google, que fala só em 90 dias. Trate como cautela empírica nossa, não como fato.

Como saber se a venda foi contada

Não confie na tela de "importação concluída". Use o que a própria documentação do Google indica:

  1. O relatório de diagnóstico de importações. Mostra a saúde das importações recentes, e é onde a perda silenciosa aparece.
  2. O envio com falha parcial ligado. Na API, o parâmetro partial_failure precisa estar true: as linhas válidas entram e os erros de cada linha voltam à parte. Ignorar o campo de erro da resposta é ignorar exatamente as linhas que não contaram.
  3. A data e a ação de conversão. A data da conversão tem que ser posterior à do clique e trazer o fuso. E a ação de conversão precisa existir na conta que recebe o envio, com o mesmo nome usado na linha.

Mais um aviso, para quem escreve o próprio integrador: o Google anunciou em março de 2026 mudanças na infraestrutura de importação offline, incluindo a possibilidade de atribuir alguns gclids expirados, com menos erros de clique fora da janela. Resultado medido no início do ano pode não valer mais. Meça de novo antes de culpar o identificador.

Se a conversão não apareceu, comece por aqui

Antes de mexer em lance ou em ação de conversão, separe as vendas que não contaram em três pilhas e olhe a idade de cada clique:

  • Sem identificador nenhum. Quase sempre é lead que chegou sem passar pela página ou pelo link que lê a URL. Anúncio de busca para WhatsApp sem página no meio não entrega o gclid na conversa: o Google não faz isso. O identificador só existe se algo na frente da conversa o capturou.
  • Com identificador e fora dos 90 dias. Não tem conserto. A saída é enviar mais cedo, em vez de enviar tudo no fim do mês.
  • Com identificador, dentro da janela e mesmo assim sem contar. Aqui o relatório de diagnóstico manda. Veja o erro por linha, a ação de conversão e a data.

A divisão em pilhas costuma mostrar que o problema não é uniforme. Em geral uma das três concentra quase tudo, e é ela que merece o seu dia de trabalho. Quanto pesa cada uma varia por conta e por tipo de negócio, e eu não tenho um número geral para dar.

O que levar daqui

A pergunta certa não é "qual identificador usar". É "qual identificador esse clique gerou". O gclid cobre o clique comum. Os dois braid cobrem o que o iOS passou a esconder do gclid, e guardar só o primeiro é perder parte dos cliques de iPhone logo de saída.

O erro mais caro dessa cadeia é o que não faz barulho: a linha aceita, o identificador errado, o clique vencido. O Google não avisa. Quem avisa é o relatório de diagnóstico, e só se você abrir. Quem chegou a este texto pelo meio, sem ter montado a campanha ainda, pode começar pelo Tráfego pago para WhatsApp: guia para gestores, que vai do clique à medição.