Saltar al contenido
Esc
↑↓navegar↵abrir⌘Jvista previa
En esta página

Analíticas

Estadísticas de entrega pocos segundos después de cada evento, en el panel y con GET /emails/metrics.

Cada resultado (entregado, rebotado, queja, abierto, clic, baja) se cuenta pocos segundos después de producirse. La página Analíticas del panel y GET /emails/metrics leen los mismos números.

En el panel, Analíticas muestra las tasas de entrega, apertura, clics, rebote y quejas, y un gráfico de eventos por hora. Puedes filtrar por intervalo de tiempo (7, 15 o 30 días), zona horaria, marca (dominio de envío), envío masivo y dominio del destinatario.

Las estadísticas se guardan por hora durante 13 meses. El historial de un envío masivo no se corta a los 13 meses. Si el servicio de estadísticas no responde, el endpoint devuelve 503 service_unavailable y el envío no se ve afectado. Las listas de emails, las exportaciones y los eventos de un email no son estadísticas; consulta Registros.

Pide los números

GET /emails/metrics necesita una clave de API de acceso total. Los SDK la llaman como emails.metrics().

curl "https://api.billionsend.com/emails/metrics?start_date=2026-11-01&end_date=2026-11-14&granularity=daily&metrics=sent&metrics=delivered&metrics=open_rate&dimensions=period" \
  -H "Authorization: Bearer bs_..."
Parámetro Qué hace
start_date, end_date El intervalo. Las estadísticas se leen en horas UTC completas, y la respuesta indica el inicio que usó.
timezone Un nombre de zona IANA, como Europe/Berlin (no se acepta un desfase UTC como +05:00). Los periodos se cortan en esa zona.
granularity hourly, daily, weekly o monthly: el tamaño de un periodo cuando dimensions incluye period. Un intervalo puede abarcar como máximo 10.000 periodos.
metrics Repítelo por cada métrica que quieras (consulta más abajo).
dimensions Repítelo por cada desglose: period, domain, email o broadcast. email y broadcast no se pueden combinar.
domain_id, email_id, broadcast_id Filtros. Repite cada uno hasta 100 veces.

La respuesta incluye totals para todo el intervalo y, cuando pides dimensiones, una fila por combinación en data.

Métricas

Métrica Cuenta
received Destinatarios aceptados para el envío. No pertenece a ningún dominio, envío masivo ni email, así que una respuesta filtrada o desglosada por alguno de ellos la deja fuera.
sent, delivered, delivery_delayed, failed, suppressed Destinatarios, según el resultado del envío.
bounced, bounced_permanent, bounced_transient, bounced_undetermined Rebotes y las tres clases de rebote.
complained, unsubscribed Quejas de spam y destinatarios que se dieron de baja con el enlace de baja.
opened, clicked Cada apertura y cada clic.
unique_opened, unique_clicked Emails abiertos o con clic al menos una vez.
delivery_rate delivered ÷ sent
bounce_rate bounced ÷ sent
open_rate, click_rate unique_opened o unique_clicked ÷ delivered
complaint_rate, unsubscribe_rate complained o unsubscribed ÷ delivered

Las tasas son porcentajes con un decimal, y valen 0 cuando no hay nada que dividir. Las aperturas y los clics hechos por máquinas, como los proxies de privacidad y los escáneres de seguridad, no se cuentan como aperturas ni clics.

Con la dimensión email y sin email_id, la respuesta lista hasta 1000 emails creados en el intervalo.

Clics por enlace

GET /emails/metrics/links (una extensión de BillionSend, clave de acceso total) lista los enlaces en los que se hizo clic en un intervalo, del más al menos clicado:

curl "https://api.billionsend.com/emails/metrics/links?start_date=2026-11-01&end_date=2026-11-14&limit=10" \
  -H "Authorization: Bearer bs_..."
{
  "object": "list",
  "start_date": "2026-11-01T00:00:00.000Z",
  "end_date": "2026-11-14T23:59:59.999Z",
  "has_more": false,
  "data": [
    { "link": "https://shop.example.com/sale", "clicked": 412, "bot_clicked": 37 }
  ]
}
  • Un enlace se cuenta por su esquema, host y ruta. La query string y el fragmento se descartan, así que un enlace personalizado para cada destinatario es una sola fila y no se guarda ningún dato del destinatario.
  • clicked cuenta personas; bot_clicked cuenta las descargas hechas por máquinas, como escáneres de seguridad y vistas previas de enlaces.
  • Acepta start_date, end_date, domain_id, broadcast_id (separados por comas) y limit (de 1 a 100, 20 por defecto), y cubre horas UTC completas, igual que GET /emails/metrics. Los clics se cuentan por enlace desde el 16 de noviembre de 2026.

Aperturas y clics por país y cliente de correo

GET /emails/metrics/countries lista las aperturas y los clics de las personas según el país desde el que llegaron, y GET /emails/metrics/clients lista las aperturas según el cliente de correo que cargó las imágenes (ambas son extensiones de BillionSend, clave de acceso total), de mayor a menor interacción:

curl "https://api.billionsend.com/emails/metrics/countries?start_date=2026-11-16&end_date=2026-11-30" \
  -H "Authorization: Bearer bs_..."
{
  "object": "list",
  "start_date": "2026-11-16T00:00:00.000Z",
  "end_date": "2026-11-30T23:59:59.999Z",
  "has_more": false,
  "data": [
    { "country": "BR", "opened": 1840, "unique_opened": 1203, "bot_opened": 95, "clicked": 311, "unique_clicked": 240, "bot_clicked": 22 },
    { "country": "unknown", "opened": 960, "unique_opened": 702, "bot_opened": 410, "clicked": 12, "unique_clicked": 9, "bot_clicked": 3 }
  ]
}
  • country es el código ISO 3166-1 alfa-2 del país donde está registrada la dirección del lector. Vale unknown cuando la dirección no se puede ubicar, y en las aperturas a través de los proxies de imágenes de Gmail y Yahoo o de Apple Mail Privacy Protection: esas llegan desde la dirección del proveedor, no desde la del lector.
  • client es uno de gmail, apple_mail, outlook, yahoo, thunderbird, other (un navegador web: el webmail y los clientes que no se identifican se ven igual) o unknown (sin user agent). Los clics no se cuentan por cliente, porque un clic llega desde el navegador al que el cliente de correo entrega el enlace.
  • Para las estadísticas solo se guardan el país y el cliente, nunca la dirección ni el user agent.
  • unique_opened y unique_clicked cuentan los emails cuya primera apertura o clic vino de ese país o cliente. Las personas y las máquinas se cuentan por separado, como en GET /emails/metrics.
  • Ambas aceptan start_date, end_date, domain_id y broadcast_id (separados por comas), cubren horas UTC completas y devuelven todas las filas (los países y los clientes son una lista acotada). Las aperturas y los clics se cuentan por país y cliente desde el 16 de noviembre de 2026.
  • Geolocalización de IP de DB-IP, con licencia CC BY 4.0.

Relacionado

Insights de entregabilidad puntúa cada email y tu cuenta. Para reaccionar a un resultado en el momento en que ocurre, en lugar de contarlo después, usa webhooks.

¿Te ha resultado útil esta página?