MailLandDocs
Analíticas

Analíticas Avanzadas

Analíticas geográficas, por dispositivo, cliente de correo electrónico y hora del día con exportación de datos

MailLand proporciona endpoints de analíticas avanzadas para obtener información más profunda sobre dónde, cuándo y cómo los destinatarios interactúan con sus correos electrónicos. Todos los datos provienen de ClickHouse y se almacenan en caché durante 5 minutos.

Las aperturas y los clics incluyen actividad de máquinas, la precarga de Apple Mail Privacy Protection y los escáneres de enlaces de seguridad, que MailLand no filtra hoy en día. Toda métrica de esta página derivada de aperturas o clics (geográfica, de dispositivo, de cliente de correo, de hora del día) es un límite superior del compromiso humano, no un recuento exacto.

Para eventType=bounced y eventType=complained, los endpoints geográficos y de dispositivo excluyen las filas sin country_code o sin device_type: dado que los eventos de rebote y de queja no incluyen esos datos, ambos endpoints normalmente devuelven un array vacío para esos tipos de evento. El endpoint de hora del día no tiene ese filtro y devuelve recuentos reales para cualquier tipo de evento.

Analíticas Geográficas

Vea dónde interactúan sus destinatarios, desglosado por país y ciudad:

GET https://api.mail.land/v1/transactional/analytics/advanced/geographic
Get geographic analytics
curl "https://api.mail.land/v1/transactional/analytics/advanced/geographic" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."
ParámetroTipoPredeterminadoDescripción
fromdatetimeHace 30 díasFecha de inicio
todatetimeAhoraFecha de fin
eventTypestringopenedEvento a analizar: opened, clicked, bounced, complained
Geographic analytics response
[
  {
    "countryCode": "US",
    "city": "San Francisco",
    "eventCount": 3420,
    "uniqueUsers": 2850
  },
  {
    "countryCode": "DE",
    "city": "Berlin",
    "eventCount": 1280,
    "uniqueUsers": 1100
  },
  {
    "countryCode": "GB",
    "city": "London",
    "eventCount": 950,
    "uniqueUsers": 820
  }
]

Analíticas por Dispositivo

Vea qué dispositivos y navegadores usan sus destinatarios:

GET https://api.mail.land/v1/transactional/analytics/advanced/devices
Get device analytics
curl "https://api.mail.land/v1/transactional/analytics/advanced/devices" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."
ParámetroTipoPredeterminadoDescripción
fromdatetimeHace 30 díasFecha de inicio
todatetimeAhoraFecha de fin
eventTypestringopenedEvento a analizar: opened, clicked, bounced, complained
Device analytics response
[
  {
    "deviceType": "desktop",
    "browser": "Chrome",
    "emailClient": "Gmail",
    "eventCount": 5200,
    "uniqueUsers": 4100
  },
  {
    "deviceType": "mobile",
    "browser": "Safari",
    "emailClient": "Apple Mail",
    "eventCount": 3800,
    "uniqueUsers": 3200
  },
  {
    "deviceType": "desktop",
    "browser": "Firefox",
    "emailClient": "Thunderbird",
    "eventCount": 420,
    "uniqueUsers": 380
  }
]

Hora del Día

Descubra cuándo los destinatarios interactúan más, desglosado por hora y día de la semana:

GET https://api.mail.land/v1/transactional/analytics/advanced/time-of-day
Get time of day analytics
curl "https://api.mail.land/v1/transactional/analytics/advanced/time-of-day" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."
ParámetroTipoPredeterminadoDescripción
fromdatetimeHace 30 díasFecha de inicio
todatetimeAhoraFecha de fin
eventTypestringopenedEvento a analizar: opened, clicked, bounced, complained
Time of day response
[
  { "hour": 9, "dayOfWeek": 1, "eventCount": 1240 },
  { "hour": 10, "dayOfWeek": 1, "eventCount": 1580 },
  { "hour": 14, "dayOfWeek": 2, "eventCount": 1120 },
  { "hour": 9, "dayOfWeek": 3, "eventCount": 1350 }
]
CampoDescripción
hourHora del día (0–23, UTC)
dayOfWeekDía de la semana (0 = Domingo, 6 = Sábado)
eventCountNúmero de eventos en este intervalo de tiempo

Clientes de Correo Electrónico

Vea qué clientes de correo electrónico usan sus destinatarios para aperturas y clics:

GET https://api.mail.land/v1/transactional/analytics/advanced/email-clients
Get email clients
curl "https://api.mail.land/v1/transactional/analytics/advanced/email-clients" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."
ParámetroTipoPredeterminadoDescripción
fromdatetimeHace 30 díasFecha de inicio
todatetimeAhoraFecha de fin
Email clients response
[
  {
    "emailClient": "Gmail",
    "opens": 15200,
    "clicks": 1980,
    "uniqueUsers": 12500
  },
  {
    "emailClient": "Apple Mail",
    "opens": 8400,
    "clicks": 1100,
    "uniqueUsers": 7200
  },
  {
    "emailClient": "Outlook",
    "opens": 6800,
    "clicks": 850,
    "uniqueUsers": 5900
  }
]

Mapa de Calor de Interacción

Obtenga un mapa de calor combinado de aperturas + clics por hora y día de la semana, ideal para visualizar los tiempos de envío óptimos:

GET https://api.mail.land/v1/transactional/analytics/advanced/engagement-heatmap
Get engagement heatmap
curl "https://api.mail.land/v1/transactional/analytics/advanced/engagement-heatmap" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."
ParámetroTipoPredeterminadoDescripción
fromdatetimeHace 30 díasFecha de inicio
todatetimeAhoraFecha de fin
Engagement heatmap response
[
  { "hour": 9, "dayOfWeek": 1, "opens": 1240, "clicks": 160 },
  { "hour": 10, "dayOfWeek": 1, "opens": 1580, "clicks": 205 },
  { "hour": 14, "dayOfWeek": 2, "opens": 1120, "clicks": 145 },
  { "hour": 9, "dayOfWeek": 3, "opens": 1350, "clicks": 175 }
]

Esto proporciona 168 puntos de datos (24 horas x 7 días) cuando hay datos disponibles para una semana completa.

Exportar Datos

Descargue informes de analíticas como Excel o PDF:

Exportación a Excel

GET https://api.mail.land/v1/transactional/analytics/advanced/export/excel
ParámetroTipoPredeterminadoDescripción
fromdatetimeHace 30 díasFecha de inicio
todatetimeAhoraFecha de fin

Devuelve un archivo .xlsx con tipo de contenido application/vnd.openxmlformats-officedocument.spreadsheetml.sheet. El nombre del archivo sigue el formato MailLand_Analytics_{from}_{to}.xlsx.

Exportación a PDF

GET https://api.mail.land/v1/transactional/analytics/advanced/export/pdf
ParámetroTipoPredeterminadoDescripción
fromdatetimeHace 30 díasFecha de inicio
todatetimeAhoraFecha de fin

Devuelve un archivo .pdf con tipo de contenido application/pdf. El nombre del archivo sigue el formato MailLand_Analytics_{from}_{to}.pdf.

Download Excel report
curl -o analytics.xlsx \
  "https://api.mail.land/v1/transactional/analytics/advanced/export/excel?from=2026-01-01&to=2026-02-01" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

Almacenamiento en Caché

Todos los endpoints de analíticas avanzadas se almacenan en caché durante 5 minutos. Las claves de caché incluyen el ID del tenant, el rango de fechas y el filtro de tipo de evento, por lo que las diferentes consultas se almacenan en caché de forma independiente.

Próximos Pasos

Registros de Correo Electrónico

Busque, filtre e inspeccione registros detallados de entrega para cada correo electrónico enviado a través de Mail.Land

Autenticación

Autentíquese con la API de Mail.Land usando tokens Bearer o claves API

En esta página

Analíticas GeográficasAnalíticas por DispositivoHora del DíaClientes de Correo ElectrónicoMapa de Calor de InteracciónExportar DatosExportación a ExcelExportación a PDFAlmacenamiento en CachéPróximos Pasos