Öffnungs- und Klick-Tracking

Tracking wird pro Domain konfiguriert und ist standardmäßig aus.

Einstellung	Was sie bewirkt	Webhook-Event
`open_tracking`	Fügt ein 1x1-Tracking-Pixel in den HTML-Body ein.	`email.opened`
`click_tracking`	Schreibt Links im HTML-Body um, sodass Klicks vor der Weiterleitung erfasst werden.	`email.clicked`

Node.js
cURL

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);

curl -X PATCH https://api.spacepost.dev/domains/$DOMAIN_ID \
  -H "Authorization: Bearer $SPACEPOST_API_KEY" -H "Content-Type: application/json" \
  -d '{ "open_tracking": true, "click_tracking": true }'

Die Änderung gilt für E-Mails, die danach gesendet werden. Beide Felder sind optional; sende nur das, das du ändern willst.

Was du beachten solltest

Öffnungen sind nur näherungsweise erfasst. Apple Mail Privacy Protection und manche Sicherheits-Scanner laden Bilder automatisch und blähen die Öffnungen auf. Gmail cacht Bilder. Betrachte Öffnungen als grobes Signal, nie als Beweis, dass eine Person die E-Mail gelesen hat.
Klicks sind zuverlässiger, aber auch Sicherheits-Scanner können Links vorab anklicken.
Datenschutz. Das Tracking erfasst IP-Adresse und User-Agent in der Event-Payload. Weise in deiner Datenschutzerklärung darauf hin und erwäge, das Öffnungs-Tracking für sensible Transaktions-E-Mails (Passwort-Zurücksetzungen, Belege) ausgeschaltet zu lassen.
Nur-Text-Teile werden nie getrackt. Das Tracking betrifft nur HTML.
Zustellbarkeit. Das Umschreiben von Links verändert die URLs, die Empfänger sehen. Manche Spam-Filter mögen das bei Transaktions-E-Mails nicht; wenn die Zustellbarkeit sinkt, schalte das Klick-Tracking für diese Domain aus und nutze für Marketing-E-Mails eine eigene Subdomain.

Ein Event email.opened oder email.clicked setzt das last_event der E-Mail, setzt es aber nie von einem schwerwiegenderen Zustand wie bounced zurück.