Aprenda como extrair insights poderosos dos seus dados de rastreamento usando nossa API avançada
Acompanhe interações dos visitantes com suas páginas
Monitore cliques, envio de formulários e eventos customizados
Meça compras, leads e conclusões de objetivos
Entenda fontes de tráfego e performance de campanhas
Faça suas requisições POST para:
https://api.metrito.com.br/v3/data-provider/query{
"project_id": "ID_DO_SEU_PROJETO",
"source_key": "tracking",
"fields": ["CAMPOS_QUE_VOCE_QUER"],
"interval_start": "DATA_INICIO",
"interval_end": "DATA_FIM",
"time_dimension": "event_time"
}source_key deve sempre ser "tracking" para consultas de dados de rastreamento.Content-Type: application/jsonAuthorization: Bearer SEU_TOKENPOSTTodas as consultas devem usar o método POST
Métricas são valores numéricos calculados baseados nos seus dados de rastreamento. Elas representam contagens, somas ou médias de eventos específicos que ocorreram no seu site.
event_countTotal de eventos registradosunique_event_countEventos únicos (baseado no ID do lead)unique_pageviewsVisualizações de página únicas (baseado no ID do lead)pageviewsTotal de eventos de visualização de páginacontent_viewsinitiate_checkoutadd_to_cartpurchaseleadcustom_eventsDimensões são atributos descritivos dos seus dados que permitem segmentar e filtrar informações. Elas fornecem contexto sobre quando, onde e como os eventos ocorreram.
idevent_idevent_nameevent_timecreateddomainurlreferrerutm_campaignutm_mediumutm_contentutm_termga_cookiefbp_cookiegcl_au_cookiemeta_page_titlemeta_page_faviconmeta_page_languagemeta_page_descriptionmeta_sourcemeta_request_headersmeta_geolocationVeja exemplos práticos de como usar a API para extrair insights valiosos dos seus dados
{
"project_id": "SEU_PROJECT_ID",
"source_key": "tracking",
"fields": [
"unique_pageviews",
"pageviews",
"url",
"meta_page_title",
"domain"
],
"interval_start": "2025-01-01",
"interval_end": "2025-01-31",
"time_dimension": "event_time"
}{
"project_id": "SEU_PROJECT_ID",
"source_key": "tracking",
"fields": [
"event_count",
"unique_event_count",
"utm_campaign",
"utm_medium",
"utm_content",
"utm_term",
"referrer"
],
"interval_start": "2025-01-01",
"interval_end": "2025-01-31",
"time_dimension": "event_time"
}{
"project_id": "SEU_PROJECT_ID",
"source_key": "tracking",
"fields": [
"content_views",
"add_to_cart",
"initiate_checkout",
"purchase",
"lead",
"event_name",
"url"
],
"interval_start": "2025-01-01",
"interval_end": "2025-01-31",
"time_dimension": "event_time"
}| Operador | Descrição | Exemplo de Uso |
|---|---|---|
EQUAL | Exatamente igual | Filtrar evento específico |
NOT_EQUAL | Diferente de | Excluir eventos específicos |
CONTAINS | Contém texto | URLs que contêm "/blog/" |
NOT_CONTAINS | Não contém | URLs sem "/admin/" |
STARTS_WITH | Começa com | URLs que começam com "https://" |
ENDS_WITH | Termina com | URLs que terminam com ".html" |
IN | Em uma lista | Múltiplos valores |
NOT_IN | Não está na lista | Excluir múltiplos valores |
{
"project_id": "SEU_PROJECT_ID",
"source_key": "tracking",
"fields": [
"event_count",
"event_name",
"url",
"meta_page_title",
"utm_campaign"
],
"filters": [
{
"field": "event_name",
"operator": "IN",
"value": ["Purchase", "Lead", "AddToCart"]
},
{
"field": "utm_campaign",
"operator": "NOT_EQUAL",
"value": [null]
}
],
"interval_start": "2025-01-01",
"interval_end": "2025-01-31",
"time_dimension": "event_time"
}Exemplos de implementações mais complexas para casos específicos
{
"project_id": "SEU_PROJECT_ID",
"source_key": "tracking",
"fields": [
"event_count",
"unique_event_count",
"unique_pageviews",
"pageviews",
"content_views",
"add_to_cart",
"purchase",
"lead"
],
"interval_start": "2025-01-01",
"interval_end": "2025-01-31",
"time_dimension": "event_time"
}{
"project_id": "SEU_PROJECT_ID",
"source_key": "tracking",
"fields": [
"purchase",
"lead",
"add_to_cart",
"utm_campaign",
"utm_medium",
"utm_content",
"utm_term"
],
"filters": [{
"field": "utm_campaign",
"operator": "NOT_EQUAL",
"value": [null]
}],
"interval_start": "2025-01-01",
"interval_end": "2025-01-31",
"time_dimension": "event_time"
}async function obterDadosTrackingCompleto() {
const apiUrl = 'https://api.metrito.com.br/v3/data-provider/query';
const requisicao = {
project_id: "SEU_PROJECT_ID",
source_key: "tracking",
fields: [
"event_count",
"unique_event_count",
"unique_pageviews",
"purchase",
"lead",
"url",
"meta_page_title",
"utm_campaign",
"utm_medium",
"event_name"
],
filters: [
{
field: "event_name",
operator: "IN",
value: ["PageView", "Purchase", "Lead"]
}
],
interval_start: "2025-01-01",
interval_end: "2025-01-31",
time_dimension: "event_time"
};
try {
const response = await fetch(apiUrl, {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'Authorization': 'Bearer SEU_TOKEN_AQUI'
},
body: JSON.stringify(requisicao)
});
if (!response.ok) {
throw new Error(`Erro HTTP: ${response.status}`);
}
const dados = await response.json();
console.log('✅ Dados de tracking obtidos com sucesso:', dados);
// Processar dados por tipo de evento
const dadosAgrupados = dados.reduce((acc, item) => {
const evento = item.event_name;
if (!acc[evento]) {
acc[evento] = [];
}
acc[evento].push(item);
return acc;
}, {});
// Exibir resultados organizados
Object.keys(dadosAgrupados).forEach(evento => {
console.log(`\n📊 === ${evento} ===`);
dadosAgrupados[evento].forEach(item => {
console.log(`🔗 URL: ${item.url}`);
console.log(`📄 Título: ${item.meta_page_title}`);
console.log(`📈 Eventos: ${item.event_count}`);
console.log(`🎯 Campanha: ${item.utm_campaign || 'N/A'}`);
console.log('---');
});
});
return dados;
} catch (erro) {
console.error('❌ Erro ao buscar dados:', erro);
throw erro;
}
}
// Executar a função
obterDadosTrackingCompleto()
.then(dados => {
console.log('🎉 Processo finalizado! Total de registros:', dados.length);
})
.catch(erro => {
console.error('💥 Falha na execução:', erro.message);
});