Wenn Gmail oder Yahoo Mail oben in einer E-Mail die Schaltfläche „Abmelden" anzeigt, steckt dahinter ein einziger HTTP-Header: List-Unsubscribe-Post. Dieser Header, zusammen mit dem bekannteren List-Unsubscribe-Header, bildet den Standard RFC 8058 – die technische Grundlage für One-Click-Abmeldungen. Dieser Leitfaden erklärt, wie er funktioniert, wann er vorgeschrieben ist, und gibt Ihnen alles, was Sie zur Implementierung benötigen.
Kurzfassung
- One-Click-Abmeldung = zwei HTTP-Header + ein HTTPS-Endpunkt für POST-Anfragen.
- Ab 5.000 E-Mails pro Tag an Gmail/Yahoo ist es Pflicht.
- Mailpro-Nutzer sind automatisch konform.
- Wenn Sie eigenen SMTP oder eine API verwenden, finden Sie nachfolgend die genaue Syntax.
Was One-Click-Abmeldung wirklich bedeutet
Eine One-Click-Abmeldung ist keine Schaltfläche im E-Mail-Body. Es ist ein Mechanismus auf Header-Ebene: Ihr E-Mail-Client liest einen versteckten Header und zeigt eine native Abmelden-Schaltfläche an. Ein Klick sendet automatisch eine HTTP-POST-Anfrage an Ihren Endpunkt – ohne Browser, Formular oder Bestätigung.
Das ist der Unterschied zu Footer-Abmelde-Links: Jene öffnen eine Webseite. RFC 8058 öffnet gar nichts – ein Klick, fertig.
Für Empfänger ist das bequemer. Für Absender ebenfalls besser: Wer problemlos abmelden kann, meldet keine Spam-Beschwerde – und eine niedrige Beschwerderate verbessert Ihre Zustellbarkeit dauerhaft.
Wann es Pflicht ist (die Bulk-Sender-Schwelle)
Google und Yahoo haben 2024 klargemacht: Wer 5.000 oder mehr E-Mails pro Tag an Gmail- oder Yahoo-Adressen sendet, muss One-Click-Abmeldungen nach RFC 8058 implementieren.
- Die 5.000 gelten pro Tag und Domain, nicht pro Kampagne.
- Auch transaktionale E-Mails zählen zur Tagessumme.
- Wer Mailpro verwendet, ist automatisch konform.
Die zwei Header, die Sie kennen müssen
-
List-Unsubscribe– gibt dem E-Mail-Client an, wohin die Abmeldeanfrage gesendet wird. -
List-Unsubscribe-Post– signalisiert, dass ein POST-Request erwartet wird. Ohne diesen Header zeigt Gmail keine native Schaltfläche.
List-Unsubscribe: <https://example.com/unsubscribe?token=abc123>
List-Unsubscribe-Post: List-Unsubscribe=One-Click
Tool: One-Click-Header-Builder (Copy und Paste)
Ersetzen Sie die Beispiel-URL durch Ihren echten Endpunkt und abc123 durch Ihr eindeutiges Token.
Schritt 1: HTTPS-Abmelde-Endpunkt erstellen
Sie benötigen eine HTTPS-URL, die POST-Anfragen entgegennimmt, öffentlich erreichbar ist, mit HTTP 200 antwortet und keinen Redirect durchführt.
from flask import Flask, request, abort
app = Flask(__name__)
@app.route('/unsubscribe', methods=['POST'])
def unsubscribe():
token = request.args.get('token')
if not token:
abort(400)
mark_as_unsubscribed(token)
return '', 200
Schritt 2: Opakes Token verwenden
Fügen Sie die E-Mail-Adresse nicht direkt in die URL ein. Verwenden Sie stattdessen ein opakes Token – eine zufällige Zeichenkette ohne persönliche Daten.
import secrets
def generate_token(subscriber_id):
token = secrets.token_urlsafe(32)
db.save_token(token, subscriber_id)
return token
Schritt 3: Header einfügen
Option A (empfohlen): Nur HTTPS One-Click
List-Unsubscribe: <https://example.com/unsubscribe?token=TOKEN>
List-Unsubscribe-Post: List-Unsubscribe=One-Click
Option B: HTTPS und mailto-Fallback
List-Unsubscribe: <https://example.com/unsubscribe?token=TOKEN>, <mailto:[email protected]?subject=unsubscribe>
List-Unsubscribe-Post: List-Unsubscribe=One-Click
Was Ihr Server verarbeiten muss
Beim Klick sendet Gmail eine POST-Anfrage. Ihr Server muss: Token validieren, Abonnenten sofort austragen, mit HTTP 200 antworten, keine Bestätigungs-E-Mail senden.
Faustregel: Schnell handeln
Google erwartet, dass Abmeldungen innerhalb von 2 Tagen umgesetzt werden. In der Praxis sollte es sofort erfolgen.
One-Click vs. Footer-Link vs. Präferenzzentrum
Vous avez besoin de la conformité RFC 8058 ? La segmentation Mailpro gère les désinscriptions en un clic automatiquement — votre liste reste propre sans aucun travail manuel.
| Methode | Funktionsweise | Gmail-Schaltfläche | Erfahrung |
|---|---|---|---|
| One-Click (RFC 8058) | POST vom E-Mail-Client | Ja | Ein Klick, keine Seite |
| Footer-Link | Öffnet Webseite | Nein | Klick und Bestätigung |
| Präferenzzentrum | Link zu Einstellungsseite | Nein | Klick und Formular |
Beispiele: Gängige Setups
1) Sie senden über Ihre eigene App (SMTP oder API)
Sie sind vollständig für die Header verantwortlich. Generieren Sie für jeden Empfänger ein Token und fügen Sie die zwei Header ein.
2) Sie senden über eine E-Mail-Marketing-Plattform
Wenn Sie Mailpro verwenden, werden die One-Click-Header automatisch gesetzt. In den Kampagnenstatistiken sehen Sie Abmeldungen in Echtzeit.
3) Sie verwalten mehrere Newsletter
Verwenden Sie für jede Kategorie unterschiedliche Tokens. Nutzen Sie E-Mail-Segmentierung und Tags zur Listenverwaltung.
Fehlerbehebung: Gmail-Schaltfläche erscheint nicht
- Fehlender List-Unsubscribe-Post-Header. Der List-Unsubscribe-Header allein reicht nicht.
- Fehlende E-Mail-Authentifizierung. Ohne SPF und DKIM wird die Schaltfläche nicht angezeigt.
- Zu geringes Sendevolumen. Neue Absender müssen zunächst Vertrauen aufbauen.
- Hohe Spam-Beschwerderate. Über 0,3% kann die Schaltfläche unterdrückt werden.
- Endpunkt antwortet nicht mit HTTP 200. Gmail testet den Endpunkt.
Compliance-Checkliste
Vor dem Versand
- List-Unsubscribe-Header mit HTTPS-URL in jeder E-Mail.
- List-Unsubscribe-Post: List-Unsubscribe=One-Click in jeder E-Mail.
- HTTPS-URL mit opakem Token (keine E-Mail-Adresse im Klartext).
- Endpunkt öffentlich erreichbar, akzeptiert POST, antwortet mit HTTP 200.
- SPF und DKIM konfiguriert.
Im E-Mail-Inhalt
- Sichtbarer Abmelde-Link im Footer vorhanden.
- Link führt zu Bestätigungsseite.
Nach dem Klick
- Abmeldungen innerhalb von 2 Tagen umgesetzt.
- Abgemeldete Adressen erhalten keine Marketing-E-Mails mehr.
- Abmeldedaten für Segmentierungsanalysen nutzen.
Vorlagen zur Spam-Reduzierung
Snippet: Warum Sie diese E-Mail erhalten
Sie erhalten diese E-Mail, weil Sie sich auf [Website] angemeldet haben.
Nicht mehr interessiert? [Jetzt abmelden]
Vorlage 1: Häufigkeit anpassen
Zu viele E-Mails? Wählen Sie Ihre Häufigkeit:
• Nur wichtige Updates → [Seltener]
• Alle Neuigkeiten → Wie bisher
• Alles beenden → [Abmelden]
Vorlage 2: Neuanfrage für inaktive Kontakte
Möchten Sie weiterhin E-Mails erhalten?
• Ja → [Bestätigen] • Nein → [Abmelden]
Ohne Antwort entfernen wir Sie automatisch.
Vorlage 3: Wir senden seltener
Ab sofort senden wir nur noch [Häufigkeit].
[Präferenzen anpassen] oder [Abmelden].
FAQ
Brauche ich noch einen Footer-Link bei One-Click-Headern?
Ja. DSGVO, CAN-SPAM und CASL verlangen einen sichtbaren Abmelde-Link im Body. Die RFC-8058-Header sind eine zusätzliche Ebene für E-Mail-Clients.
Gilt das nur für Newsletter?
Nein – für alle kommerziellen E-Mails. Rein transaktionale E-Mails sind ausgenommen, aber auch dort ist es gute Praxis.
Wie reduziere ich Spam-Beschwerden schnell?
One-Click-Header implementieren, Häufigkeit reduzieren, inaktive Kontakte mit Segmentierung und Tags herausfiltern.
Wie passt Mailpro dazu?
Mailpro setzt RFC-8058-Header automatisch und zeigt Abmeldungen in den Statistiken in Echtzeit – ohne eigenen Endpunkt.
Kurzfassung
Zwei Header, ein Endpunkt – das ist One-Click-Abmeldung nach RFC 8058. Pflicht ab 5.000 E-Mails/Tag an Gmail/Yahoo, aber empfehlenswert für alle. Mailpro übernimmt alles automatisch.
Mailpro et la désinscription en un clic
La désinscription en un clic, gérée pour vous
Gmail et Yahoo exigent désormais les en-têtes List-Unsubscribe. Mailpro les ajoute automatiquement et retire les désinscrits instantanément, gardant votre liste propre et votre réputation d’expéditeur intacte.
Démarrer gratuitement avec Mailpro Voir la segmentation des emails
