Lista de clientes no Meta Ads: como subir CSV ou Excel e criar público semelhante por valor
Por Matheus Mello, fundador do Ads Editor e dono da YEP Agência · Publicado em · 10 min de leitura
Lista de clientes no Meta Ads é o público personalizado feito com os contatos que você já tem: e-mail, telefone e nome de quem comprou ou se cadastrou. Ela serve para três coisas: falar de novo com quem já é cliente, tirar essas pessoas das campanhas de aquisição e ser a semente do público semelhante.
Resposta rápida
Para subir lista de clientes no Meta Ads, salve a planilha em CSV ou TXT com e-mail, telefone com DDI e nome em colunas separadas e crie um público personalizado de Lista de clientes no Gerenciador. No Ads Editor, a mesma lista entra em XLSX, CSV ou TXT, recebe hash no servidor e vira semelhante com um clique.
Resumo
- Lista de clientes é público personalizado: serve para remarketing da base, exclusão de compradores e semente de semelhante.
- Cada identificador em coluna própria. Telefone só com dígitos e DDI (5511999998888), e-mail em minúsculas e sem espaços.
- Pela API, a Meta exige hash SHA-256 dos dados e aceita no máximo 10 mil pessoas por envio; ID externo vai sem hash.
- Com uma coluna de valor do cliente, a lista nasce como público baseado em valor, a semente do semelhante por valor.
- No Ads Editor, a lista entra em XLSX, CSV ou TXT até 10 MB e 100 mil linhas, em qualquer conta conectada. No Google, ainda não.

O que é público por lista de clientes, e para que ele serve?
É um público personalizado que a Meta monta casando os dados da sua planilha com contas do Facebook e do Instagram. Quem é encontrado entra no público; quem não é fica de fora. Você nunca vê quem casou, só o tamanho do público.
Os usos que pagam a conta:
- Remarketing da base. Oferta de recompra, lançamento ou upgrade para quem já comprou.
- Exclusão. Tirar compradores das campanhas de aquisição, para não pagar de novo por quem já é cliente. Quem excluir de cada campanha está em público semelhante e exclusão.
- Semente de semelhante. A lista de compradores é a origem mais perto do dinheiro que existe na conta.
- Semelhante por valor. Com uma coluna de valor por cliente, a Meta procura gente parecida com quem vale mais, não com o cliente médio.
Como formatar a lista de clientes para a Meta encontrar as pessoas?
A Meta só encontra quem estiver escrito do jeito que ela espera. Antes de subir, deixe cada identificador numa coluna e no formato abaixo. As regras de e-mail, telefone, hash e lote são as da documentação de públicos personalizados da API da Meta, consultada em 17/10/2026.
| Coluna | Formato | Exemplo |
|---|---|---|
| Minúsculas, sem espaço antes ou depois | [email protected] | |
| Telefone | Só dígitos, sem símbolos, com o código do país na frente | 5511999998888 |
| Nome e sobrenome | Em duas colunas, nunca juntos | maria | silva |
| Cidade, estado, CEP | Uma coluna cada | são paulo | sp | 01310100 |
| País | Código de duas letras, mesmo que todos sejam do Brasil | br |
| ID externo | O código do cliente no seu sistema, enviado sem hash | CLI-10432 |
| Valor do cliente | Só número, zero ou positivo, sem R$ nem ponto de milhar | 1200.50 |
O que é o hash, e por que ele importa
Hash é uma impressão digital do dado: o e-mail vira uma sequência de letras e números que não dá para desfazer. Pela API, a Meta só aceita os dados com hash SHA-256, e a correspondência é feita entre hashes. Por isso o formato importa tanto: "[email protected] " e "[email protected]" geram hashes diferentes, e o primeiro não casa com ninguém. ID externo e ID de anúncio mobile são as exceções e vão sem hash.
Quanto mais identificadores por pessoa, maior a chance de encontrar. Para quem vende pelo WhatsApp, o telefone com DDI costuma ser o identificador mais completo da base.
Como subir a lista de clientes no Gerenciador de Anúncios?
- Abra Públicos no Gerenciador de Anúncios e clique em Criar público, depois em Público personalizado.
- Escolha Lista de clientes como origem. Na primeira vez em cada conta, a Meta pede que você aceite os termos de público personalizado.
- Diga se a lista tem coluna de valor do cliente. Se tiver, ela vira público baseado em valor.
- Envie o arquivo em CSV ou TXT, ou cole os dados.
- Confira o mapeamento de cada coluna para o identificador certo e corrija o que a Meta não reconheceu.
- Importe, dê nome ao público e espere a correspondência: o tamanho pode levar horas para aparecer.
O nome dos botões muda com as versões do Gerenciador, mas o caminho é sempre o mesmo: Públicos, Criar público, Público personalizado, Lista de clientes. O trabalho que não escala é o resto: exportar CSV da planilha do cliente, repetir conta por conta e refazer a lista quando ela fica velha.
Como subir a lista de clientes no Ads Editor?
Desde 13/10/2026, a aba Meta da tela Públicos tem a seção Lista de clientes (arquivo). Ela faz o mesmo que o Gerenciador, com três diferenças: aceita o Excel direto, reconhece as colunas pelo cabeçalho e funciona em qualquer conta conectada, sem trocar de Business Manager.
- Escolha a conta e abra Lista de clientes (arquivo), na aba Meta da tela Públicos.
- Dê nome ao público ou marque Usar o nome do arquivo. O rótulo é opcional e é o nativo da Meta: são 15, como Leads qualificados, Clientes de alto valor, Compradores recentes e Abandono de carrinho. Ele organiza o público no Gerenciador de Públicos.
- Diga se há coluna de valor. Responda Sim quando a planilha tiver valor gasto ou LTV e mapeie essa coluna como Valor do cliente. A Meta pede que você aceite os termos de valor uma vez, e a tela mostra o link quando falta.
- Escolha o país dos telefones sem DDI. Brasil (+55) acrescenta 55 a números de 10 ou 11 dígitos. Não adicionar DDI serve para lista internacional ou para números que já trazem o código.
- Envie o arquivo: XLSX, CSV ou TXT, até 10 MB e 100 mil linhas. CSV separado por ponto e vírgula, o padrão do Excel no Brasil, também é lido. Numa planilha com várias abas, vale a primeira cujo cabeçalho a tela reconhece.
- Confirme as colunas. A tela mostra cada coluna com um exemplo e sugere o campo pelo cabeçalho (E-mail, Telefone, Nome, Cidade, CEP, Valor). É preciso mapear pelo menos e-mail, telefone, ID externo ou ID de anúncio mobile.
- Clique em Criar público da lista. Ao terminar, aparecem os botões Usar em Lookalike, que leva a lista para a criação do semelhante, e Abrir no Meta.

O que acontece com os dados da lista no Ads Editor
Telefones perdem espaços e símbolos, e-mails vão para minúsculas e cada identificador recebe hash SHA-256 no servidor antes de seguir para a Meta, em lotes de até 10 mil linhas, como a documentação exige. O valor do cliente vai sem hash, no formato que a plataforma pede. O arquivo fica guardado cifrado por até 1 hora, só para quem o enviou, e é descartado quando o público é criado.
Pelo chat também dá: o MCP do Ads Editor tem a ferramenta de criar público por lista de clientes, que recebe o arquivo por um endereço (file_url). Como conectar está em MCP de Meta Ads e Google Ads no Claude e no ChatGPT.
Gerenciador, API ou Ads Editor: qual usar para lista de clientes?
| Gerenciador da Meta | API de Marketing | Ads Editor | |
|---|---|---|---|
| Formato do arquivo | CSV ou TXT | O que você programar | XLSX, CSV ou TXT |
| Hash SHA-256 | Automático na importação | Por sua conta, antes do envio | No servidor do Ads Editor, antes do envio |
| Coluna reconhecida | Mapeamento na tela | No código | Pelo cabeçalho, com exemplo de cada coluna |
| Várias contas de cliente | Uma conta por vez, trocando de Business Manager | Sim, com programação | Qualquer conta conectada, na mesma tela |
| Lista com valor do cliente | Sim | Sim | Sim, com aviso dos termos de valor |
| Limite | Repetir tudo em cada conta | Exige programador e manutenção | 10 MB e 100 mil linhas por arquivo; só Meta |
Para criar dezenas de públicos de envolvimento, vídeo e site de uma vez, junto com a lista, veja públicos personalizados e lookalike em massa.
Como criar público semelhante por valor a partir da lista?
O semelhante por valor sai de uma lista com a coluna de valor do cliente. A documentação da Meta diz que o valor pode ser qualquer número inteiro ou decimal não negativo, e que o público precisa ter pelo menos 100 pessoas encontradas para servir de origem do semelhante. Ela também avisa que um público baseado em valor não pode ser substituído por um comum, nem o contrário: decida antes de subir.
- Suba a lista com a coluna de valor mapeada como Valor do cliente.
- Espere o público ter tamanho no Gerenciador de Públicos.
- No Ads Editor, clique em Usar em Lookalike: a lista vira a origem na seção Lookalike, onde você marca as porcentagens (1%, 2%, 3%, 5% e 10%) e o país.
- Cada combinação de origem e porcentagem vira um público, com nome no padrão Lookalike, nome da origem e porcentagem.
Vale a pena quando o valor varia entre clientes: ticket diferente, recompra, plano. Se todo mundo paga o mesmo, a coluna não diferencia ninguém e o semelhante comum de compradores faz o mesmo papel. A escolha da semente e da porcentagem está em público semelhante e exclusão.
Quanto tempo a Meta leva para mostrar o tamanho do público?
Não é instantâneo. Depois do envio, a Meta faz a correspondência e o tamanho pode levar horas para aparecer. Enquanto isso, o público já existe na conta. Se depois de um dia o tamanho continuar baixo demais, o problema quase sempre está no formato da lista, não na Meta.
Quais erros derrubam a correspondência da lista?
- Telefone sem o código do país. 11999998888 não é o mesmo que 5511999998888 para a Meta.
- Nome e sobrenome na mesma coluna. Separe antes de subir.
- E-mail com espaço ou letra maiúscula num envio feito por código, sem normalizar.
- Coluna de valor com texto. "R$ 1.200,00" não é número; deixe só 1200.
- Lista velha. Base de dois anos atrás tem e-mail abandonado e telefone trocado. Atualize a lista em vez de criar outra com o mesmo nome.
E no Google Ads, dá para subir lista de clientes?
Dá, no próprio Google Ads, onde o recurso se chama Customer Match. No Ads Editor ainda não: no Google, os públicos disponíveis são remarketing de site, segmento personalizado e combinação de listas. Quem opera as duas plataformas sobe a lista do Google pelo Google Ads e a da Meta pelo Ads Editor.
Perguntas frequentes
Dá para subir lista de clientes em Excel no Meta Ads?
No Gerenciador, a Meta pede CSV ou TXT, então é preciso salvar a planilha nesse formato. No Ads Editor, o arquivo XLSX entra direto, até 10 MB e 100 mil linhas.
Qual o tamanho mínimo da lista para criar público semelhante?
Segundo a documentação da Meta, o público precisa ter pelo menos 100 pessoas encontradas para servir de origem do semelhante. Como nem todo contato é encontrado, a lista enviada precisa ser maior que isso.
A Meta vê os e-mails e telefones da minha lista?
Pela API, os dados chegam com hash SHA-256, e a correspondência é feita entre hashes. No Ads Editor, o hash é feito no servidor antes do envio e o arquivo é descartado quando o público é criado.
Como colocar o telefone na lista de clientes?
Só com dígitos e com o código do país na frente: 5511999998888. No Ads Editor, a opção Brasil (+55) acrescenta o 55 a números de 10 ou 11 dígitos que vierem sem ele.
O que é público baseado em valor?
É a lista de clientes com uma coluna de valor por pessoa, como valor gasto ou LTV. Ela é a origem do semelhante por valor, que procura gente parecida com os clientes que valem mais.
Glossário
- Lista de clientes
- Público personalizado da Meta criado a partir de contatos seus, como e-mail e telefone.
- Hash SHA-256
- Transformação do dado numa sequência que não dá para desfazer; é como a Meta recebe os identificadores pela API.
- Público baseado em valor
- Lista de clientes com uma coluna de valor por pessoa, usada como origem do semelhante por valor.
- ID externo
- Código do cliente no seu próprio sistema, enviado à Meta sem hash.
Referências
- Custom Audiences, API de Marketing da Meta (consultada em 17/10/2026). Sustenta: Os dados precisam de hash SHA-256; e-mail em minúsculas e sem espaços nas pontas; telefone sem símbolos, letras e zeros à esquerda, com código do país quando não há coluna de país; até 10 mil pessoas por envio; ID externo e ID de anúncio mobile sem hash; público baseado em valor não pode ser substituído por um comum.
- Value-based lookalike audiences, API de Marketing da Meta (consultada em 17/10/2026). Sustenta: O valor do cliente vai no campo LOOKALIKE_VALUE, pode ser qualquer número inteiro ou decimal não negativo, e o público precisa de pelo menos 100 pessoas para servir de origem do semelhante.
A afirmação sustentada por cada fonte está indicada acima.
Sobre o autor
Matheus Mello, fundador do Ads Editor e dono da YEP Agência. Opera contas de clientes na YEP Agência e construiu o Ads Editor para a própria agência parar de subir anúncio um por um. Os números de uso citados no blog saem do registro de atividade do produto. Instagram: @theusm


