> ## Documentation Index
> Fetch the complete documentation index at: https://www.notifuse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# E-Mail-Tracking

> Erfassen Sie, wann Kontakte Ihre E-Mails öffnen und auf deren Links klicken, und lassen Sie jeden Kontakt diesem Tracking zustimmen oder es ablehnen.

## Überblick

Notifuse kann zu den E-Mails, die es versendet, zwei Dinge erfassen:

- **Öffnungen**: Ein unsichtbares Bild (ein Tracking-Pixel) wird in die E-Mail eingefügt und erfasst, wann die E-Mail geöffnet wird.
- **Klicks**: Links laufen über eine Weiterleitung, die jeden Klick erfasst, bevor sie den Kontakt zur Seite weiterschickt.

Beides wird in den Einstellungen des Arbeitsbereichs getrennt eingeschaltet, und jeder Kontakt kann beidem einzeln zustimmen oder es ablehnen. Links behalten ihre [UTM-Parameter](https://www.notifuse.com/de/docs/features/broadcast-campaigns.md#utm-tracking), unabhängig von der Tracking-Entscheidung.

## Einstellungen des Arbeitsbereichs

Unter **Einstellungen → Allgemein**, im Bereich **E-Mail-Tracking**:

- **Öffnungen** und **Klicks** schalten die jeweilige Art des Trackings für den ganzen Arbeitsbereich ein oder aus. Ist eine davon aus, enthält keine E-Mail dieses Tracking, ganz gleich, was die Kontakte gewählt haben.
- **Kontakte ohne erfasste Einwilligung** legt fest, was für einen Kontakt gilt, der nie eine Wahl getroffen hat: **Tracken** (Standard) oder **Nicht erfassen**.

Die eigene Wahl eines Kontakts hat immer Vorrang vor dieser Einstellung. Manche Aufsichtsbehörden, etwa die italienische Garante und die französische CNIL, erwarten, dass Öffnungs- und Klick-Tracking eine Einwilligung voraussetzt. Wenn das für Sie gilt, wählen Sie **Nicht erfassen**: Dann werden nur Kontakte getrackt, die zugestimmt haben.

## Die Wahl des Kontakts

Jeder Kontakt hat vier Felder:

| Feld                          | Beschreibung                                                                                                          |
| ----------------------------- | --------------------------------------------------------------------------------------------------------------------- |
| `tracking_opens_consent`      | `granted`, `denied` oder `null`, wenn unbekannt                                                                       |
| `tracking_clicks_consent`     | `granted`, `denied` oder `null`, wenn unbekannt                                                                       |
| `tracking_consent_updated_at` | Zeitpunkt der letzten Änderung einer Wahl. Notifuse setzt ihn, wenn sich ein Wert ändert, außer Sie senden ihn selbst |
| `tracking_consent_source`     | Herkunft der Änderung: `api`, `console`, `import`, `notification_center`, `email_link` oder `subscribe_form`          |

Eine E-Mail an einen Kontakt wird auf Öffnungen getrackt, wenn der Arbeitsbereich Öffnungen trackt und die Wahl des Kontakts es erlaubt: `granted`, oder unbekannt bei ausgewähltem **Tracken**. Für Klicks gilt dieselbe Regel.

Die Wahl lässt sich auf diesen Wegen setzen:

- **Über die API**: `contacts.upsert`, `contacts.import`, das Objekt `contact` der Transaktions-API und der Anmelde-Endpunkt. Ohne `tracking_consent_source` erfasst eine Änderung mit API-Schlüssel `api` und ein Import `import`; ein Anmeldeformular, das ohne API-Schlüssel abgesendet wird, erfasst immer `subscribe_form`.
- **In der Konsole**: auf der Seite des Kontakts, beim Anlegen oder Bearbeiten eines Kontakts und bei CSV-Importen (Spalten, die _Einwilligung zum Öffnungs-Tracking_ und _Einwilligung zum Klick-Tracking_ zugeordnet sind, mit den Werten `granted` oder `denied`).
- **Durch den Kontakt selbst**, im [Benachrichtigungscenter](https://www.notifuse.com/de/docs/features/notification-center.md#email-tracking).

Senden Sie `null`, um eine Wahl auf unbekannt zurückzusetzen. Eine Anfrage ohne diese Felder lässt die gespeicherte Wahl unverändert.

### Die Wahl nutzen

- **Kontaktliste**: Filtern Sie nach jeder der beiden Wahlen, `unknown` eingeschlossen, und blenden Sie die Spalte _Tracking-Einwilligung_ ein. CSV-Exporte enthalten die vier Felder.
- **Segmente**: Die vier Felder sind Kontaktfelder; verwenden Sie _ist nicht gesetzt_ für eine unbekannte Wahl.
- **Automatisierungen**: Ein Auslöser _Kontakt aktualisiert_ lässt sich auf eine Änderung einer der beiden Wahlen beschränken.
- **Webhooks**: Kontakt-Payloads enthalten die vier Felder, und eine Änderung wird in der Zeitleiste des Kontakts erfasst.

## Wenn ein Kontakt seine Meinung ändert

Die Wahl wird beim Versand einer E-Mail angewendet und erneut geprüft, wenn eine Öffnung oder ein Klick eingeht. Lehnt ein Kontakt das Tracking ab, nachdem eine E-Mail versendet wurde, wird das Öffnen oder Klicken dieser E-Mail nicht erfasst; der Link führt ihn trotzdem zur Seite.

## Linkklicks

Jede E-Mail erfasst, welche ihrer Links angeklickt wurden. Wenn ein Kontakt einen Link einer E-Mail zum ersten Mal
anklickt, erhält die Zeitleiste des Kontakts einen Eintrag `email.link_clicked` mit der Adresse des Links, neben dem
Eintrag `email.clicked` des ersten Klicks in der E-Mail. Dieser Eintrag kann [eine Automatisierung starten](https://www.notifuse.com/de/docs/features/automations.md#link-click-triggers) und aktualisiert
sofort die Segmente, die nach einem angeklickten Link filtern. Er zählt nicht zum monatlichen Ereigniskontingent.

In diesen Fällen wird kein Eintrag geschrieben:

- bei einem Klick auf einen Link, der in dieser E-Mail schon angeklickt wurde (ein Link, der vor dem Update auf 44.0
  angeklickt wurde, erhält seinen Eintrag beim nächsten Klick);
- bei einem Link, den Notifuse nicht prüfen kann: Links in E-Mails, die vor Version 42.2 versendet wurden, und Links, deren Signatur nicht passt;
- bei einem Link, dessen Adresse länger als 2.048 Zeichen ist, oder bei Links jenseits der ersten 50 verschiedenen Links, die in einer
  E-Mail angeklickt wurden;
- bei Links, die nicht `http` oder `https` sind, etwa `mailto:` und `tel:`, und bei Links auf Ihre Notifuse-Instanz selbst, etwa
  Abmelde-, Benachrichtigungscenter- und Webversion-Links. Notifuse erkennt sie an Ihrem API-Endpunkt, an der
  eigenen Domain Ihres Arbeitsbereichs oder an dem Host, den der Klick erreicht hat (auch einem, an den ein Reverse Proxy weiterleitet), auf jedem Port.
  Das betrifft auch Links auf Ihren Blog, wenn er auf Ihrer eigenen Domain ausgeliefert wird, und Links auf eine andere Website, die unter
  demselben Hostnamen wie Ihre Notifuse-Instanz läuft, auch auf einem anderen Port.

Öffnungen und Klicks bei einer E-Mail, deren Kontakt gelöscht wurde, werden nicht erfasst; der Link führt den Leser trotzdem zur Seite.

## Statistiken

Öffnungs- und Klickraten werden über die getrackten E-Mails berechnet, nicht über alle versendeten E-Mails. Wurden manche E-Mails nicht getrackt, nennt der Tooltip der Rate deren Anzahl (_von 1.200 erfasst_); eine Rate ohne getrackte E-Mail zeigt `-`. Das gilt für Kampagnenstatistiken, A/B-Test-Ergebnisse, Klickraten pro Link und das Analyse-Dashboard.

E-Mails, die vor Version 43 versendet wurden, gelten als getrackt, ihre Raten ändern sich also nicht.

## A/B-Tests

Der automatische Gewinner wird anhand der Öffnungs- oder Klickrate über die getrackten Empfänger jeder Variante bestimmt. Eine Variante ohne getrackte Empfänger kann nicht gewinnen; hat keine Variante welche, wählen Sie den Gewinner selbst.

Trackt der Arbeitsbereich keine Kontakte ohne erfasste Einwilligung, zählen in den Ergebnissen nur Kontakte, die zugestimmt haben. Die Variantentabelle warnt in Orange, wenn weniger als die Hälfte der Empfänger einer Variante getrackt wurde, und der Tooltip jeder Rate nennt die Zahl der getrackten Empfänger.

## Tracking für eine einzelne E-Mail ausschalten

- **Kampagnen**: Aktivieren Sie im Schritt _Web-Analyse_ die Option **Öffnungen und Klicks für diesen Broadcast nicht tracken** (`tracking_mode: "no_tracking"` in der API). Die UTM-Parameter bleiben erhalten, und der Gewinner eines A/B-Tests muss dann von Hand gewählt werden.
- **Transaktionsbenachrichtigungen**: Wählen Sie **Kein Öffnungs- oder Klick-Tracking, UTM-Parameter behalten** (`no_tracking`) oder **Für diese Benachrichtigung deaktiviert** (`disabled`). Die zweite Option lässt die Links ganz unverändert, ohne UTM-Parameter, und ist für Links gedacht, die sich nicht ändern dürfen, etwa Login-Links.

## Links in Vorlagen

Mit zwei Variablen treffen Kontakte ihre Wahl direkt aus einer E-Mail heraus:

- `{{ tracking_preferences_url }}` öffnet den Dialog zum E-Mail-Tracking im Benachrichtigungscenter.
- `{{ tracking_optout_url }}` bittet den Kontakt um Bestätigung und lehnt dann Öffnungs- und Klick-Tracking ab (Quelle `email_link`). Bis der Kontakt bestätigt, wird nichts erfasst, denn Sicherheitsscanner für E-Mails öffnen Links von sich aus.

```html
<a href="{{ tracking_preferences_url }}">Choose what we track</a>
```

Notifuse schreibt diese beiden Links nie für das Tracking um.
