Abmeldelinks

Ein Empfänger Ihres Marketing-Mails hat zwei Wege, sich abzumelden: den Abmeldebutton, den sein Mailbox-Provider anzeigt, und einen Link im Nachrichtentext. Wir setzen beides auf jeden marketing-Versand, melden jede Abmeldung als Webhook-Event und speichern die Abmeldung der Adresse, damit Ihre nächste Kampagne sie überspringt. Die Kategorie korrekt zu setzen ist der einzige Teil, den Sie übernehmen.

Eine Abmeldung hat nur bei Mail Bedeutung, von dem sich ein Empfänger abmelden kann – deshalb steht die Kategorie an erster Stelle. Ein Versand ist standardmäßig category: "marketing", sodass Kampagnen-, Newsletter- und Ankündigungsmail ohne zusätzlichen Aufwand korrekt behandelt wird. Setzen Sie category: "transactional" explizit bei operativem Mail, und wir lassen es unverändert. Eine Quittung oder ein Passwort-Reset hat keinen Abmeldelink und wird nie durch eine frühere Abmeldung blockiert.

Dahinter stehen zwei Pflichten. Massenversender sind von Gmail und Yahoo verpflichtet, bei Marketing-Mail One-Click-Abmeldung anzubieten, und ein sichtbarer Link im Nachrichtentext ist in den meisten Märkten separat gesetzlich vorgeschrieben. Ein marketing-Versand enthält beides.

Das ist das Abmelde-Steuerelement, das Mailbox-Provider im Nachrichtenheader anzeigen. Es basiert auf einem Header-Paar, List-Unsubscribe und List-Unsubscribe-Post, und Provider bieten die Ein-Klick-Version nur an, wenn beide vorhanden sind und der Opt-out-Endpunkt einen unauthentifizierten POST ohne Bestätigungsschritt akzeptiert. Das ist der Vertrag, den Gmail und Yahoo prüfen.

Marketing-Mail wird mit diesen Headern versandt, egal wie Sie es senden: als Broadcast vom Dashboard oder als marketing-Nachricht über POST /v1/email/messages. Nichts zu bauen, nichts zu hosten.

Da wir dieses Header-Paar bei Marketing-Mail verwalten, wird das Setzen eigener List-Unsubscribe- oder List-Unsubscribe-Post-Header bei einem marketing-Versand mit einem 422 abgelehnt. Bei einem transactional-Versand fügen wir keinen Abmeldeheader hinzu, und Sie können über das headers-Feld eigene setzen, wenn Sie einen Grund dafür haben.

Wenn ein Empfänger den Button des Providers nutzt, entsteht ein email.list_unsubscribed-Event.

Der zweite Weg ist ein sichtbarer Abmeldelink in der Nachricht selbst. Wir fügen einen in den HTML-Body Ihrer marketing-Versendungen ein, damit ein Empfänger immer etwas zum Klicken hat. Sie können auch einen eigenen Link hinzufügen, der auf ein von Ihnen gehostetes Preference Center zeigt – unserer bleibt daneben als gesetzlich vorgeschriebenes Minimum.

Standardmäßig erscheint der Link als kleiner Footer am Ende des Bodys. Um die Stelle selbst zu wählen, setzen Sie die reservierte {{ bird.unsubscribe_url }}-Variable an die Stelle, an die der Link gehört:

<p>
  You received this because you subscribed to our newsletter. You can {{ bird.unsubscribe_url }} at
  any time.
</p>

Wir rendern den Link dann dort statt den Footer anzuhängen, als Anchor mit dem Text "unsubscribe". Sie können ihn auch als href-Wert verwenden (<a href="{{ bird.unsubscribe_url }}">Leave this list</a>), um Ihren eigenen Wortlaut und Ihr Styling beizubehalten.

Die Ersetzung erfolgt nur auf der ausgehenden Kopie, sodass das Zurücklesen der Nachricht über die API Ihren Originalinhalt mit der intakten Variable zurückgibt.

Passen Sie die Zielseite unter Email > Unsubscribe page an. Legen Sie Absendername, Hintergrund-, Text- und Buttonfarben fest. Der Absendername wird standardmäßig auf Ihren Organisationsnamen gesetzt. Nutzen Sie den Beispiellink, um das Ergebnis in der Vorschau zu sehen.

Wenn ein Empfänger den Link im Nachrichtentext nutzt, entsteht ein email.unsubscribed-Event, das sich von email.list_unsubscribed unterscheidet, damit Sie die beiden Wege auseinanderhalten können.

Wir stoppen den Mailversand an den Empfänger, ohne dass Sie auf den Webhook reagieren müssen. Beide Events speichern die Adresse des Empfängers als abgemeldet von nicht-transaktionalem Mail, was bedeutet:

Eine Abmeldung ist eine erklärte Präferenz, keine Unterdrückung: Sie erscheint auf dem Preferences-Tab unter Email > Suppressions und auf der Detailseite des Kontakts, nicht in der Unterdrückungsliste. Nur diese Adresse ist betroffen, und der Eintrag zeigt, wer sich wann abgemeldet hat.

Die Webhook-Events ermöglichen es Ihnen, die Abmeldung in Ihre eigene Datenbank zu spiegeln, ein Abonnement-Flag umzuschalten oder sie zu protokollieren. Beide enthalten die identifizierenden Felder jedes E-Mail-Events: email_id, recipient_id, workspace_id, die recipient-Adresse und deren recipient_role. Sie enthalten außerdem tags und metadata des ursprünglichen Versands, damit Sie ohne zusätzlichen Lookup gegen Ihre Datensätze abgleichen können, sowie broadcast_id mit dem Broadcast, als dessen Teil das Mail versandt wurde, oder null, wenn dem Versand kein Broadcast zugrunde lag. Ein Abmeldelink aus Mail, das vor dem Hinzufügen des Felds versandt wurde, benennt keinen Broadcast, sodass eine Abmeldung über einen solchen Link null in beiden Events meldet, unabhängig davon, ob ein Broadcast das Mail versandt hat. Abonnieren Sie sie genauso wie jedes andere E-Mail-Event; die Events-Referenz enthält die vollständigen Payloads.

Eine Abmeldung ist die eigene Erklärung des Empfängers, daher können Sie sie nicht über die Suppressions-API entfernen, wie Sie es bei einer Unterdrückung tun würden. Um den Mailversand an die Adresse wieder aufzunehmen, erfassen Sie ein Opt-in unter Contacts > Preferences oder rufen Sie POST /v1/preferences mit status: granted auf. Diese Workspace-weite Seite erfasst Erklärungen für jeden Kanal, während der Tab unter Email > Suppressions die E-Mail-bezogenen zeigt. In jedem Fall erfordert das Überschreiben der Abmeldung consented_at, den Zeitpunkt der Einwilligung des Empfängers, und das Opt-in greift nur, wenn dieser Zeitpunkt nach der Abmeldung liegt, die es aufhebt.