Salta ai contenuti
spacepostdocs

Tracciamento di aperture e clic

Il tracciamento si configura per dominio ed è disattivato per impostazione predefinita.

Impostazione Che cosa fa Evento webhook
open_tracking Inserisce un pixel di tracciamento 1x1 nel corpo HTML. email.opened
click_tracking Riscrive i link nel corpo HTML in modo che i clic vengano registrati prima del reindirizzamento. 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);

La modifica si applica alle email inviate successivamente. Entrambi i campi sono facoltativi; invia solo quello che vuoi cambiare.

Considerazioni

Sezione intitolata “Considerazioni”
  • Le aperture sono approssimative. Apple Mail Privacy Protection e alcuni scanner di sicurezza caricano le immagini automaticamente, gonfiando le aperture. Gmail mette le immagini in cache. Considera le aperture un segnale indicativo, mai una prova che una persona abbia letto l’email.
  • I clic sono più affidabili, ma anche gli scanner di sicurezza possono cliccare in anticipo sui link.
  • Privacy. Il tracciamento registra indirizzo IP e user agent nel payload dell’evento. Dichiaralo nella tua informativa sulla privacy e valuta di lasciare disattivato il tracciamento delle aperture per le email transazionali sensibili (reimpostazioni della password, ricevute).
  • Le parti in solo testo non vengono mai tracciate. Il tracciamento riguarda solo l’HTML.
  • Recapito. La riscrittura dei link cambia gli URL che vedono i destinatari. Ad alcuni filtri antispam non piace sulle email transazionali; se noti un calo del recapito, disattiva il tracciamento dei clic per quel dominio e usa un sottodominio separato per le email di marketing.

Un evento email.opened o email.clicked imposta il last_event dell’email, ma non lo riporta mai indietro da uno stato più grave come bounced.