Descripción General de Analíticas

MailLand proporciona analíticas en tiempo real impulsadas por ClickHouse para una agregación de alto rendimiento en millones de eventos. Realice un seguimiento de entregas, aperturas, clics, rebotes y quejas con rangos de fechas flexibles y filtrado por tipo de correo electrónico.

Resumen de EventosCopiar enlace de la sección

Obtenga recuentos de eventos agregados para un período:

GET https://api.mail.land/v1/transactional/analytics/events/summary

curl "https://api.mail.land/v1/transactional/analytics/events/summary?from=2026-01-18&to=2026-02-17" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

Parámetros de ConsultaCopiar enlace de la sección

{
  "from": "2026-01-18T00:00:00Z",
  "to": "2026-02-17T23:59:59Z",
  "sent": 142500,
  "delivered": 140325,
  "opened": 44878,
  "clicked": 5843,
  "bounced": 1125,
  "complained": 28,
  "source": "clickhouse",
  "data_source": "clickhouse",
  "is_degraded": false,
  "queryTimeMs": 45
}

Estadísticas DiariasCopiar enlace de la sección

Obtenga desglose de eventos por día para gráficos:

GET https://api.mail.land/v1/transactional/analytics/stats/daily

curl "https://api.mail.land/v1/transactional/analytics/stats/daily?from=2026-01-18&to=2026-02-17" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

[
  {
    "date": "2026-02-17T00:00:00Z",
    "sent": 4750,
    "delivered": 4680,
    "opened": 1498,
    "clicked": 195,
    "bounced": 38
  },
  {
    "date": "2026-02-16T00:00:00Z",
    "sent": 4320,
    "delivered": 4260,
    "opened": 1380,
    "clicked": 175,
    "bounced": 32
  }
]

TasasCopiar enlace de la sección

Obtenga tasas de entrega, apertura y clic calculadas como porcentajes:

GET https://api.mail.land/v1/transactional/analytics/rates

curl "https://api.mail.land/v1/transactional/analytics/rates?from=2026-01-18&to=2026-02-17" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

{
  "from": "2026-01-18T00:00:00Z",
  "to": "2026-02-17T23:59:59Z",
  "deliveryRate": 98.47,
  "openRate": 31.49,
  "clickRate": 13.02
}

Cálculos de tasas:

Las tres consultas de tasas se ejecutan en paralelo para un rendimiento óptimo.

Enlaces PrincipalesCopiar enlace de la sección

Vea los enlaces más clicados en sus correos electrónicos:

GET https://api.mail.land/v1/transactional/analytics/links/top

curl "https://api.mail.land/v1/transactional/analytics/links/top?from=2026-01-18&to=2026-02-17&limit=10" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

[
  {
    "url": "https://your-app.com/orders/track",
    "clicks": 2340,
    "uniqueRecipients": 1890
  },
  {
    "url": "https://your-app.com/dashboard",
    "clicks": 1150,
    "uniqueRecipients": 980
  }
]

Volumen por HoraCopiar enlace de la sección

Realice un seguimiento del volumen de envío por hora, con superposición opcional de línea base para detección de anomalías:

GET https://api.mail.land/v1/transactional/analytics/volume/hourly?days=7

curl "https://api.mail.land/v1/transactional/analytics/volume/hourly?days=7" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

[
  {
    "hour": "2026-02-17T14:00:00Z",
    "sent": 520,
    "baseline": 480.5
  },
  {
    "hour": "2026-02-17T13:00:00Z",
    "sent": 495,
    "baseline": 480.5
  }
]

La baseline es el volumen histórico promedio para esa hora del día, calculado por VolumeAnomalyWorker. Es null si aún no hay datos de referencia disponibles.

CachéCopiar enlace de la sección

Los puntos de conexión de analíticas se almacenan en caché del lado del servidor para minimizar la carga de consultas:

El endpoint events/summary fusiona las solicitudes idénticas simultáneas por servidor: solo una consulta llega a ClickHouse por instancia de la API, y todos los llamantes de esa instancia reciben el mismo resultado. Los demás endpoints de esta página no fusionan solicitudes; cada una lee la caché y luego consulta.

Fuentes de DatosCopiar enlace de la sección

MailLand utiliza ClickHouse como fuente de datos analíticos principal para una agregación rápida sobre miles de millones de eventos.

El campo source en las respuestas indica qué almacén de datos sirvió el resultado. El campo queryTimeMs ayuda a monitorear el rendimiento.

RetenciónCopiar enlace de la sección

Los datos de eventos de analíticas siguen el plan del espacio de trabajo: los registros se conservan 30 días en Free, 90 días en Pro y 180 días en Max.

Pasos SiguientesCopiar enlace de la sección

• Registros de correo electrónico: busque e inspeccione entregas de correo electrónico individuales
• Analíticas avanzadas: analíticas geográficas, por dispositivo y por hora del día
• Descripción general de la entregabilidad: reputación del remitente y tendencias