Skip to main content
A API de Eventos é um endpoint público que permite enviar eventos de rastreamento a partir de qualquer sistema — backends, ferramentas de automação (n8n, Make, Zapier), plataformas de e-commerce ou integrações personalizadas. Não exige autenticação e gera IDs automaticamente quando necessário.

​
Endpoint

POST https://api.metrito.com/v2/public/tracking/events
PropriedadeValor
MétodoPOST
AutenticaçãoNenhuma (endpoint público)
Content-Typeapplication/json

​
Campos Obrigatórios

Toda requisição precisa de apenas dois campos: 
{
  "domain": "sujaloja.com.br",
  "config": {
    "name": "NomeDoEvento"
  }
}
CampoDescrição
domainDomínio do seu contêiner de rastreamento (ex: sujaloja.com.br) ou ID MTC (ex: MTC-5X35GWQ)
config.nameNome do evento para dashboards e relatórios no Metrito

​
Exemplo Rápido

curl -X POST https://api.metrito.com/v2/public/tracking/events \
  -H "Content-Type: application/json" \
  -d '{
    "domain": "sujaloja.com.br",
    "config": {
      "name": "Purchase",
      "facebook": { "name": "Purchase" }
    },
    "data": {
      "value": 99.90,
      "currency": "BRL"
    },
    "lead": {
      "email": "cliente@exemplo.com",
      "phone": "+5511999999999"
    }
  }'
Resposta de sucesso: 
{
  "success": true,
  "eventId": "1758388123_kk78h7u5sf",
  "leadId": "lead_20250920_xyz789",
  "timestamp": 1758388123
}
O eventId e o leadId são gerados automaticamente quando não enviados. Você não precisa gerenciar esses IDs manualmente.

​
config.name vs config.facebook.name

Esses dois campos têm finalidades distintas:
CampoUsado porDescrição
config.nameMetritoNome interno do evento para dashboards. Use qualquer nome que quiser.
config.facebook.nameMeta (Facebook/Instagram)Nome do evento enviado à API de Conversões da Meta. Deve seguir o padrão oficial (ex: Purchase, Lead, PageView).
Se config.facebook for omitido, o evento é registrado no Metrito mas não é enviado para a Meta. Inclua-o sempre que quiser atribuição no Meta Ads.

​
Próximos Passos

Referência de API

Documentação completa de todos os campos, geração de IDs, geolocalização, exemplos de código e FAQ.

Testar a Integração

Verifique se os eventos estão sendo recebidos e processados corretamente.