Preparar uma Lista do Customer Match do Google Ads no Planilhas

A API avisa o que está em jogo

A própria documentação para desenvolvedores do Google diz com todas as letras: "If the contact information is not correctly formatted before hashing, the API still accepts the hashed information, but it can't be matched with a customer." Sem erro, sem aviso – apenas uma lista que silenciosamente não corresponde a ninguém. Por isso o fluxo abaixo é quase todo formatação, e o hash é uma etapa perto do fim.

Etapa 1 – um identificador por coluna, texto simples primeiro

Monte a planilha com cada identificador na própria coluna – e-mail, telefone, campos de nome, país e CEP quando aplicável – e defina as colunas de telefone e CEP como texto simples antes de colar (Formato → Número → Texto simples), ou zeros à esquerda e números longos serão destruídos em silêncio já na chegada.

Etapa 2 – normalize segundo as regras documentadas pelo Google

Para os campos com hash, a documentação de formato de arquivo do Google é específica:

• Tudo em minúsculas, sem espaços nas pontas.
• E-mail, regra só para Gmail: para endereços gmail.com e googlemail.com, remova os pontos do nome de usuário e tudo a partir de um + – Jane.Doe+Shopping@googlemail.com vira janedoe@googlemail.com. Documentado apenas para esses dois domínios; não aplique a outros.
• Telefone: E.164 – "Include the country code and '+' sign." A passagem completa de formatação está no nosso guia de E.164; a versão curta é: só dígitos, código do país, + na frente.

Etapa 3 – aplique o hash, ou deixe o Google aplicar

Dois caminhos documentados:

• Enviar em texto puro e o Google aplica o hash do lado dele antes da correspondência.
• Aplicar o hash você mesmo – SHA-256, saída hexadecimal (nas palavras do Google: "Use hex SHA256") – de modo que dados brutos de clientes nunca saiam da sua planilha em forma legível. É o caminho que times atentos a compliance seguem, e a razão de esse fluxo existir no Planilhas: o Google Planilhas não tem função de hash embutida, então a etapa de hash exige Apps Script ou um complemento.

Etapa 4 – verifique antes de enviar

Duas conferências de dez segundos que pegam a maioria das falhas silenciosas:

• Conferência de comprimento: um digest SHA-256 em hexadecimal tem exatamente 64 caracteres – =LEN(B2)=64 sinaliza truncamento e hash duplo de uma vez.
• Amostragem: aplique hash em um valor que você normalizou à mão e confirme que o digest muda quando a caixa da entrada muda. Se John@ e john@ derem o mesmo digest, algo antes está pré-processando seus dados.

Etapa 5 – envie e calibre as expectativas

Envie o arquivo para a sua lista de clientes no Google Ads. O processamento não é instantâneo, e o tamanho correspondido será menor que a sua contagem de linhas – a correspondência acontece contra contas Google conectadas, e nenhuma disciplina de formatação muda isso. O que a disciplina de formatação muda é se uma linha correspondível de fato corresponde. Se a taxa parecer errada, nosso guia de diagnóstico percorre as causas em ordem.

Onde o Hash Data se encaixa

O Hash Data coloca a etapa de hash dentro da planilha: vários algoritmos como fórmulas e o =HASHPHONE() normalizando um número para E.164 e aplicando o hash em uma única etapa – as duas etapas mais sujeitas a erro acima, reduzidas a uma.

Fontes

• Ajuda do Google Ads – Formatar o arquivo de dados do cliente – lido em 20/08/2026
• Google Ads API – Get started with Customer Match – lido em 20/08/2026
• Lista de funções do Google Planilhas – lido em 20/08/2026