Ir al contenido
spacepostdocs

Seguimiento de aperturas y clics

El seguimiento se configura por dominio y está desactivado por defecto.

Ajuste Qué hace Evento de webhook
open_tracking Inserta un píxel de seguimiento de 1x1 en el cuerpo HTML. email.opened
click_tracking Reescribe los enlaces del cuerpo HTML para registrar los clics antes de redirigir. email.clicked
tracking.ts
import { SpacePost } from "@spacepost/node";


const spacepost = new SpacePost(process.env.SPACEPOST_API_KEY);


const { error } = await spacepost.domains.update({
  id: "0192e1c4-0000-7000-8000-000000000001",
  openTracking: true,
  clickTracking: true,
});
if (error) console.error(error);

El cambio se aplica a los correos enviados a partir de ese momento. Ambos campos son opcionales; envía solo el que quieras cambiar.

Consideraciones

Sección titulada «Consideraciones»
  • Las aperturas son aproximadas. Apple Mail Privacy Protection y algunos escáneres de seguridad cargan las imágenes automáticamente, lo que infla las aperturas. Gmail guarda las imágenes en caché. Trata las aperturas como una señal aproximada, nunca como prueba de que una persona leyó el correo.
  • Los clics son más fiables, pero los escáneres de seguridad también pueden hacer clic previamente en los enlaces.
  • Privacidad. El seguimiento registra la dirección IP y el user agent en el payload del evento. Indícalo en tu política de privacidad y considera dejar desactivado el seguimiento de aperturas en el correo transaccional sensible (restablecimientos de contraseña, recibos).
  • Las partes de texto plano nunca se rastrean. El seguimiento solo afecta al HTML.
  • Entregabilidad. La reescritura de enlaces cambia las URL que ven los destinatarios. A algunos filtros de spam no les gusta esto en el correo transaccional; si notas una caída de la entregabilidad, desactiva el seguimiento de clics en ese dominio y usa un subdominio aparte para el correo de marketing.

Un evento email.opened o email.clicked actualiza el last_event del correo, pero nunca lo hace retroceder desde un estado más grave como bounced.