Uma lista de clientes limpa é um dos ativos de segmentação com maior intenção de compra que você possui. A única coisa entre esse export do CRM e um público de retargeting ou lookalike de alto desempenho é acertar as colunas do CSV.
A especificação de formatação da Meta é a autoridade no assunto, mas está espalhada por várias páginas de ajuda e enterrada sob a interface. Então as pessoas chutam os cabeçalhos, pulam o código do país, fazem upload de uma única coluna de email, e acabam com uma taxa de correspondência fraca ou um erro de upload. Este guia reúne todo o processo em uma única página: o modelo exato de CSV, como preparar e exportar sua lista, como funciona o hashing SHA-256, os passos de upload no Ads Manager, e como aumentar sua taxa de correspondência. É um dos pontos de entrada mais práticos para públicos personalizados, e também serve como a referência de modelo que você pode copiar em segundos.
O que é um público personalizado de lista de clientes
Um público personalizado de lista de clientes é um público de segmentação de anúncios construído a partir de um arquivo de pessoas que você já conhece: compradores, leads, usuários de teste ou assinantes. Você faz upload dos dados de contato deles, a Meta os corresponde a contas do Facebook e Instagram, e o grupo correspondido se torna um público que você pode segmentar ou excluir.
Isso é diferente de um público de site ou engajamento, que a Meta constrói automaticamente a partir da atividade do pixel ou dentro do app. Aqui, você fornece os dados. Três requisitos básicos se aplicam:
- O arquivo precisa ser um CSV ou TXT com uma linha de cabeçalho e um cliente por linha.
- Precisa incluir pelo menos 100 clientes únicos depois de remover duplicatas; listas menores não vão criar um público.
- Precisa conter pelo menos um identificador principal, como um endereço de email ou número de telefone.
Quanto mais limpo e completo o arquivo, mais pessoas a Meta consegue corresponder, e mais utilizável seu público se torna.
O modelo de CSV de público personalizado do Facebook (colunas exatas)
A Meta lê seu arquivo pelos cabeçalhos de coluna na primeira linha. Use os códigos exatos abaixo e ela mapeia seus dados automaticamente. Os cabeçalhos se dividem em três grupos.
Identificadores principais (inclua pelo menos um). Mais de um melhora sua taxa de correspondência.
| Cabeçalho de coluna | Identificador | Notas |
|---|---|---|
email | Endereço de email | Até 3 colunas de email; um endereço por célula |
phone | Número de telefone | Até 3 colunas; precisa incluir o código do país |
madid | ID de anunciante móvel | Apple IDFA ou Google AAID |
appuid | ID de usuário do app do Facebook | ID numérico do SDK do Facebook |
pageuid | ID de usuário da Página do Facebook | ID numérico de pessoas que interagiram com sua Página |
Identificadores adicionais (opcionais, mas aumentam a taxa de correspondência).
| Cabeçalho de coluna | Identificador | Formatação |
|---|---|---|
fn | Primeiro nome | Com ou sem acentos |
ln | Sobrenome | Sobrenome completo |
ct | Cidade | Nome completo da cidade |
st | Estado / região | Nome completo ou abreviação dos EUA (CA) |
country | País | Código ISO de duas letras (US, GB, FR) |
zip | CEP | Formatos dos EUA e internacionais aceitos |
dob | Data de nascimento | Muitos formatos, com ou sem pontuação |
doby | Ano de nascimento | Ano com 4 dígitos (1990) |
gen | Gênero | M ou F |
age | Idade | Numérico |
Campos opcionais.
| Cabeçalho de coluna | Finalidade |
|---|---|
value | Valor do cliente para lookalikes baseados em valor (apenas número, sem símbolo de moeda) |
add_to_messaging_cb_for_wa | Adiciona o cliente à sua base de mensagens do WhatsApp (flag true/false) |
data_processing_options | Use "LDU" para habilitar o Limited Data Use |
data_processing_options_state | Sinal de estado para Limited Data Use |
data_processing_options_country | Sinal de país para Limited Data Use |

Um modelo mínimo funcional se parece com isto:
email,phone,fn,ln,country
emily@example.com,+14155552671,Emily,Stone,US
john@example.com,+447911123456,John,Doe,GB
helen@example.com,+12025550143,Helen,Park,US
Duas regras são as que mais costumam pegar as pessoas de surpresa. Primeiro, coloque cada identificador na sua própria coluna. Não use uma coluna para o nome completo; divida em fn e ln. Segundo, sempre inclua o código do país nos números de telefone e um código de país ISO na coluna country, mesmo quando todos os clientes estão no mesmo país, porque a Meta faz a correspondência em escala global. A Meta também hospeda um arquivo de exemplo de lista de clientes para download que você pode usar como ponto de partida.
Como preparar e exportar sua lista
Seus dados quase sempre começam em outro lugar: uma plataforma de ecommerce, uma planilha, ou um CRM. O trabalho é exportá-los e remodelá-los para corresponder aos cabeçalhos acima.
- Exporte a lista bruta. Extraia os contatos que você quer segmentar para um CSV.
- Mapeie os campos para os cabeçalhos da Meta. Renomeie suas colunas para
email,phone,fn, e assim por diante. Divida campos combinados, como uma única coluna "Nome completo", emfneln. - Limpe os dados. Remova espaços no início e no fim, deixe os endereços de email em minúsculas, e remova símbolos de moeda de qualquer coluna
valuepara que ela contenha só números. - Adicione a coluna de país. Dê a cada linha um código
countryISO de duas letras, e garanta que os números de telefone tragam seu código de país. - Remova informações proibidas. Nunca faça upload de dados sensíveis. A Meta proíbe identificadores como documentos de identidade governamentais, dados de contas financeiras, informações de saúde, e qualquer dado sobre crianças menores de 13 anos. Confira as diretrizes de formatação da Meta se não tiver certeza se um campo é permitido.
Se sua lista vive em um CRM como HubSpot, Mailchimp ou Salesforce, você pode exportá-la para CSV e seguir o mesmo mapeamento, ou sincronizá-la automaticamente. A mecânica de conectar um CRM à Meta está coberta no nosso guia sobre integração de CRM com Facebook lead ads, então este artigo permanece focado no arquivo em si.
Lance mais. Clique menos.
Suba centenas de criativos de uma vez, combine thumbnails com vídeos automaticamente e exporte direto para o Meta Ads Manager.
Teste Ads Uploader grátisNão precisa de cartão de crédito • Teste grátis de 7 dias
Como funcionam o hashing e a normalização SHA-256
Dados de clientes são sensíveis, então a Meta nunca corresponde emails ou números de telefone brutos. Ela corresponde hashes: impressões digitais cifradas e de mão única de cada identificador, produzidas com o algoritmo SHA-256. Duas entradas idênticas sempre produzem o mesmo hash, e é isso que permite à Meta comparar sua lista com os usuários dela sem nunca ler os valores subjacentes.
Existem dois caminhos, e qual deles se aplica decide se você algum dia vai precisar mexer no hashing você mesmo.
- Upload direto no Ads Manager. Quando você faz upload de um arquivo ou cola valores diretamente, a Meta faz o hash dos identificadores no seu navegador com SHA-256 antes de qualquer coisa ser enviada. Os dados brutos nunca saem da sua máquina em forma legível, e você não precisa fazer nada a mais.
- Upload via Marketing API ou parceiro. Se você envia a lista pela API ou por uma plataforma conectada, você mesmo normaliza e faz o hash de cada identificador antes de enviá-lo.
Quando você faz o hash dos dados você mesmo, a normalização vem primeiro, porque o matching depende de entradas consistentes:
- Converta o texto para minúsculas.
- Remova espaços no início e no fim.
- Remova a pontuação onde a Meta espera que seja removida.
- Formate os números de telefone como apenas dígitos com o código do país incluído: remova espaços, hífens, parênteses e o sinal de mais, e retire qualquer zero à esquerda, por exemplo
14155552671.
Depois faça o hash de cada valor normalizado com SHA-256 puro e sem salt; um hash com salt nunca vai corresponder aos registros da Meta.

Para a grande maioria dos anunciantes que fazem um upload manual, essa é uma notícia tranquilizadora: você prepara um CSV limpo e a Meta cuida do hashing.
Como fazer upload da sua lista e criar o público
Com um arquivo formatado pronto, o fluxo de criação no app de navegador do Ads Uploader ou diretamente no Ads Manager leva alguns minutos.
- Abra Públicos no Ads Manager.
- Selecione Criar público e depois Público personalizado.
- Escolha Lista de clientes e depois Avançar.
- Preparar lista: confirme que seu arquivo segue a especificação de formatação, depois continue.
- Adicionar lista: escolha Fazer upload de um arquivo ou Colar valores separados por vírgula. Informe à Meta se seu arquivo inclui uma coluna
value, depois defina um nome para o público, um rótulo opcional e uma descrição, e aceite os termos de público personalizado. - Corresponder colunas: a Meta mapeia cada coluna para um identificador. Um check verde significa que uma coluna está mapeada e pronta para o hash. Um ponto de exclamação significa que uma coluna precisa de atenção ou ficou de fora; corrija isso antes de continuar para proteger sua taxa de correspondência.
- Selecione Fazer upload e criar.
Seu público primeiro aparece como Gerando enquanto a Meta o processa e corresponde, depois muda para Pronto. Fique de olho em um status Desatualizado mais tarde: significa que a lista não é atualizada há mais de 30 dias, o que pode enfraquecer a entrega. Reenvie uma versão nova usando Atualizar lista para mantê-la em dia.

Entender e melhorar sua taxa de correspondência
A taxa de correspondência é a fração dos seus registros enviados que a Meta consegue vincular com sucesso a uma conta do Facebook ou Instagram. É o número que decide quanto da sua lista realmente se torna segmentável, e varia bastante conforme o tipo de lista.
- Listas de consumidores bem formatadas costumam corresponder na faixa de 30 a 60 por cento, porque consumidores tendem a usar endereços de email pessoais vinculados às suas contas, e arquivos limpos com vários identificadores podem passar de 60 por cento.
- Listas de email B2B costumam render menos, em torno de 20 a 40 por cento, já que emails corporativos têm menos chance de estar vinculados a um perfil pessoal.
Algumas alavancas movem a taxa para cima de forma confiável:
- Inclua mais identificadores. Uma lista com email, telefone, nome e localização dá à Meta mais formas de encontrar cada pessoa do que só o email.
- Formate corretamente. Códigos de país nos telefones, códigos ISO na coluna de país, e emails em minúsculas, tudo isso ajuda.
- Mantenha ela atualizada. Dados recentes correspondem melhor do que uma lista que já tem um ano.
- Faça upload de um arquivo maior e mais limpo. Mais linhas válidas significa mais gente correspondida, mesmo na mesma porcentagem.
Depois que seu público está correspondido e Pronto, ele se torna a fonte para lookalikes baseados em valor e padrão, que estendem seu alcance a pessoas parecidas com seus melhores clientes. Quando você construir esses, lembre de suprimir as pessoas que já estão na sua lista para não pagar para alcançar clientes existentes duas vezes. Nosso guia sobre exclusões de público personalizado cobre como lidar com sobreposição e supressão de forma limpa.
Economize horas em testes criativos
Pare de subir anúncios um por um. Processe criativos ilimitados em massa com correspondência automática de mídia e publicação direta via API.
Teste Ads Uploader grátisNão precisa de cartão de crédito • Teste grátis de 7 dias
Fazendo isso em escala: uploads de CSV repetíveis
Uma lista é uma tarefa de cinco minutos. O problema começa quando isso vira uma rotina semanal em muitos públicos e várias contas de anúncios, que é a realidade para agências e equipes de alto volume. Você está reexportando, remapeando colunas, reconferindo códigos de país, e clicando pelo mesmo fluxo de criação repetidas vezes, e cada passagem manual é uma chance de enviar um arquivo malformado.
A solução é padronizar: fixe um único modelo de colunas, valide os cabeçalhos antes de cada upload, e agrupe o trabalho em lotes em vez de fazer um público de cada vez. Essa mesma disciplina de padronizar e agrupar em lotes é exatamente o que separa as equipes que lançam campanhas rápido das equipes que ficam presas brigando com planilhas. Se os workflows de listas e anúncios em volume são seu gargalo, vale a pena dar uma olhada no panorama mais amplo de opções no nosso resumo das melhores ferramentas de lançamento de anúncios em massa para Meta ads.
Perguntas frequentes
Que formato um CSV de público personalizado do Facebook precisa ter? Um arquivo CSV ou TXT com uma linha de cabeçalho e um cliente por linha. A primeira linha traz os códigos de coluna reconhecidos pela Meta, e cada identificador fica na sua própria coluna. O arquivo precisa ter pelo menos 100 clientes únicos depois de remover duplicatas.
Quais colunas e cabeçalhos entram no CSV da lista de clientes? Pelo menos um identificador principal (email, phone, madid, appuid ou pageuid), mais identificadores opcionais que aumentam a taxa de correspondência como fn, ln, ct, st, country, zip, dob, doby, gen e age. Colunas opcionais incluem value, o campo de mensagens do WhatsApp e os campos de Limited Data Use.
Qual é o tamanho mínimo da lista de clientes? Você precisa de pelo menos 100 clientes únicos no arquivo depois da deduplicação, ou a Meta não vai criar o público. O antigo mínimo de 20 é uma orientação ultrapassada, e listas maiores e mais limpas te dão mais alcance utilizável.
Preciso fazer o hash da minha lista de clientes eu mesmo? Não para um upload padrão no Ads Manager. A Meta faz o hash dos identificadores com SHA-256 no seu navegador antes do envio. Você só faz o hash dos dados você mesmo quando faz upload pela Marketing API ou por uma integração de parceiro, depois de normalizá-los.
O que é uma boa taxa de correspondência para um público personalizado? Listas bem formatadas costumam corresponder na faixa de 30 a 60 por cento, e arquivos limpos podem passar de 60 por cento, enquanto listas B2B rendem menos, cerca de 20 a 40 por cento. Mais identificadores e formatação limpa aumentam a taxa.
Por que meu público personalizado aparece como Desatualizado? A lista não é atualizada há mais de 30 dias, o que pode afetar a entrega. Reenvie uma versão atualizada com a opção Atualizar lista.
Posso colar uma lista em vez de fazer upload de um arquivo CSV? Sim. O passo Adicionar lista inclui uma opção para colar valores separados por vírgula. É conveniente para listas pequenas, mas um CSV formatado é mais rápido e mais seguro para qualquer coisa de tamanho considerável.
Juntando tudo
Um público personalizado de lista de clientes é tão forte quanto o arquivo por trás dele. Acerte as colunas, dê a cada identificador sua própria coluna, adicione códigos de país e deixe seus emails em minúsculas, e inclua mais de um identificador para que a Meta tenha mais com que fazer a correspondência. Faça upload no Ads Manager, deixe fazer o hash e gerar, e atualize antes que fique Desatualizado. Depois transforme esse grupo correspondido em lookalikes e listas de supressão.
Faça isso uma vez e é uma tarefa rápida. Faça toda semana em várias contas e a verdadeira vitória está em padronizar o modelo e agrupar os uploads em lotes, para que uma lista limpa sempre se transforme em um público funcional em vez de uma dor de cabeça de formatação.
