O que são eventos offline no Meta Ads

Em outras palavras: o Meta sabe que João Silva clicou em um anúncio na sexta-feira. Quando você carrega um CSV informando que João Silva (mesmo e-mail) fez uma compra na loja no sábado, o Meta conecta os dois pontos e registra a venda como resultado da campanha.

Quem deve usar — setores e casos de uso reais

O problema real que os eventos offline resolvem

Sem eventos offline, o Meta Ads vê apenas uma fração da sua realidade de conversão. Isso causa três problemas sérios:

• ! ROAS subestimado: o painel mostra R$0,80 de retorno para cada R$1 investido, mas a realidade (incluindo vendas offline) é R$4,50. Você corta uma campanha que estava funcionando
• ! Algoritmo mal calibrado: o Meta otimiza para o perfil de usuários que converte online — que pode ser diferente do perfil de quem realmente compra na sua loja ou fecha contrato presencialmente
• ! Decisões erradas de escala: sem visibilidade do impacto real das campanhas nas vendas offline, você não sabe qual campanha merece mais budget — e toma decisões baseadas em dados incompletos

import hashlib

def hash_sha256(value):
    # normalizar: minúsculas e sem espaços nas bordas
    normalized = value.lower().strip()
    return hashlib.sha256(normalized.encode('utf-8')).hexdigest()

# Exemplos de uso:
hash_sha256("joao@email.com")       # → hash do e-mail
hash_sha256("+5511999999999")      # → hash do telefone
hash_sha256("joao")               # → hash do primeiro nome

match_keys.email,match_keys.phone,event_time,event_name,value,currency,order_id
a665a45920422f9d417e4867efdc4fb8a04a1f3fff1fa07e998e86f7f7a27ae3,b3a8e0e1f9ab1bfe3a36f231f676f78bb28a2d5d3b0b9a30bd285e6e29b9f7c3,1746612000,Purchase,297.00,BRL,ORD-2026-001

API de Conversões Offline — envio automático em tempo real

O upload manual de CSV funciona, mas tem limitações: é um processo manual, sujeito a esquecimento, e os dados chegam com atraso de horas ou dias. A solução profissional é a API de Conversões da Meta, que desde 2023 suporta tanto eventos online quanto offline numa única integração.

Com a API, cada vez que uma venda offline ocorre no seu sistema (PDV, CRM ou ERP), os dados são enviados automaticamente ao Meta em segundos.

import requests, hashlib, time

# Configurações
PIXEL_ID     = "SEU_PIXEL_ID"          # Dataset ID
ACCESS_TOKEN = "SEU_SYSTEM_USER_TOKEN"

def sha256(v):
    return hashlib.sha256(v.lower().strip().encode()).hexdigest()

# Dados da venda offline
payload = {
  "data": [{
    "event_name":       "Purchase",
    "event_time":       int(time.time()),      # timestamp agora
    "action_source":    "physical_store",   # CHAVE: indica offline
    "user_data": {
      "em": sha256("joao@email.com"),
      "ph": sha256("+5511999999999"),
      "fn": sha256("joao"),
      "ln": sha256("silva"),
    },
    "custom_data": {
      "value":    297.00,
      "currency": "BRL",
      "order_id": "ORD-2026-001"
    }
  }],
  "access_token": ACCESS_TOKEN
}

response = requests.post(
  f"https://graph.facebook.com/v25.0/{PIXEL_ID}/events",
  json=payload
)
print(response.json())

Automação com n8n e Make.com — o fluxo ideal

Para equipes sem desenvolvedores, n8n e Make.com permitem configurar o envio automático de eventos offline sem escrever código:

Pontuação de qualidade de dados offline

O Meta avalia a qualidade dos dados enviados com uma pontuação de 0 a 10. Quanto maior a pontuação, melhor a taxa de correspondência e mais eficiente o uso dos dados para otimização.

• ✓ Envie sempre o e-mail + telefone + nome — cada identificador extra aumenta significativamente a chance de correspondência
• ✓ Normalize antes do hash: e-mail em minúsculas, telefone com +55 e DDD, nome sem acentos e em minúsculas
• ✓ Inclua o order_id para evitar contagem duplicada caso o mesmo evento seja enviado mais de uma vez
• ✓ Envie dados frescos: eventos de menos de 7 dias têm melhor taxa de correspondência do que eventos antigos
• ! Não envie dados de pessoas que não consentiram: em conformidade com a LGPD, certifique-se de que os clientes cuja compra você envia ao Meta consentiram com o uso de seus dados para fins de marketing

Perguntas frequentes (FAQ)