DocumentacionTracking de aperturas y clics

Tracking de aperturas y clics

Pixel de tracking y redirect de enlaces para metricas de engagement.

Con el tracking activo en un envio, MailingCore reescribe enlaces e inyecta un pixel transparente. Los destinatarios llaman a endpoints publicos track; no hace falta API key (el token logId es opaco).

Endpoints

TipoMetodoEndpointComportamiento
AperturaGET/track/o/:logIdDevuelve GIF 1×1; registra apertura
ClicGET/track/c/:logIdRegistra clic; redirect 302 a URL original

:logId identifica la fila del log de envio. La API genera URLs trackeadas al construir el cuerpo del mensaje.

Como funciona

  1. Envias con tracking activo (por defecto).
  2. Los enlaces HTML pasan por /track/c/....
  3. Se anade pixel <img src=".../track/o/..."> para aperturas.
  4. Los eventos alimentan analiticas y webhooks opcionales.
Destinatario abre email  →  GET /track/o/clk_abc  →  apertura registrada
Destinatario hace clic   →  GET /track/c/clk_abc  →  clic registrado  →  redirect al destino

Desactivar tracking

Pon trackingDisabled: true en POST /emails/send para omitir el pixel de apertura y la reescritura de enlaces en ese envio. El tracking es por envio — no hay flag por plantilla. El List-Unsubscribe y el enlace de baja se siguen anadiendo, y el mensaje se entrega sin reescritura.

Ver Analiticas para tasas agregadas de apertura y clic.