Tracking de opens y clicks

El tracking de opens y clicks es una funcionalidad automática disponible en campañas (bulk). Al enviar una campaña con contenido HTML, MailerDash inyecta un pixel de seguimiento y reescribe los links para capturar interacciones de los destinatarios.

El tracking no aplica a envíos transaccionales (POST /v1/mail/send).

Cómo funciona

Tracking de opens (pixel)

Al momento del envío, MailerDash inserta un pixel invisible de 1×1px al final del <body> del HTML (o al final del contenido si no hay <body>):

<img src="https://track.mailerdash.com/o/<token>" width="1" height="1"
     alt="" style="display:none;border:0;width:1px;height:1px;">

Cuando el cliente de correo carga la imagen, se registra una apertura asociada a ese envío y contacto.

Tracking de clicks (reescritura de links)

Todos los <a href="..."> del HTML que apunten a URLs http:// o https:// son reescritos para pasar por el dominio de tracking:

<!-- Antes -->
<a href="https://mi-app.com/promo">Ver oferta</a>

<!-- Después del envío -->
<a href="https://track.mailerdash.com/c/<token>">Ver oferta</a>

El redirect captura el clic y redirige al destinatario a la URL original en menos de un segundo.

Links que no se reescriben:

mailto:, tel:, javascript:, anchors (#sección)
Placeholders no resueltos ({{variable}})
El link de desuscripción de List-Unsubscribe y One-Click
URLs que ya apuntan al dominio de tracking

Dónde ver los analytics

Analytics de una campaña

GET /v1/bulk/campaigns/{id}/analytics
Authorization: Bearer $MAILERDASH_API_KEY

Respuesta (resumen):

{
  "campaign_id": "camp_abc123",
  "delivered": 1250,
  "opens_unique": 342,
  "opens_total": 489,
  "clicks_unique": 118,
  "clicks_total": 201,
  "bounces": 12,
  "complaints": 2,
  "unsubs": 5,
  "rates": {
    "open": 0.2736,
    "ctr": 0.0944,
    "ctor": 0.3450,
    "bounce": 0.0096,
    "complaint": 0.0016,
    "unsub": 0.0040
  },
  "top_links": [...],
  "timeline": [...],
  "detail_window_days": 90
}

Agrega también ?format=csv para exportar el detalle por destinatario con columnas email, status, sent_at, first_opened_at, first_clicked_at.

Tasas agregadas entre campañas

GET /v1/bulk/analytics/rates?period=7d

period acepta 24h, 7d o 30d. Devuelve métricas consolidadas para todas las campañas de tu key en esa ventana.

Engagement de un contacto

GET /v1/bulk/contacts/{email}/engagement

Retorna el historial de interacciones (opens, clicks, bounces, quejas, desuscripciones) de un contacto específico, útil para segmentación y diagnóstico de deliverability.

Unique vs. total

Métrica	Significado
`opens_unique`	Cantidad de contactos distintos que abrieron al menos una vez
`opens_total`	Total de aperturas (incluye múltiples aperturas del mismo contacto)
`clicks_unique`	Contactos distintos que hicieron clic en al menos un link
`clicks_total`	Total de clics (incluye clics repetidos y en múltiples links)

Para calcular tasas de apertura usa siempre opens_unique / delivered; opens_total sirve para medir engagement profundo (si un contacto abre el correo varias veces).

Retención de datos

El campo detail_window_days: 90 indica que los eventos de open/click individuales (timeline detallado por recipient) se conservan por 90 días. Los contadores agregados de la campaña permanecen indefinidamente.

Ver referencia completa de endpoints bulk en /reference/bulk/.