Abmeldungen und Marken
Abmeldungen werden pro Absenderdomain geführt, sodass jede Marke ihre eigene Liste, Abmeldeseite und Link-Domain hat.
Eine Abmeldung bedeutet „keine Marketing-E-Mails mehr“. BillionSend hält sie für die Absenderdomain fest, deren E-Mail den Link enthielt, sodass ein Team mit mehreren Marken deren Listen nie vermischt. Wer eine Marke verlässt, hört weiterhin von den anderen.
Transaktionsmails (E-Mails, die ohne Thema und außerhalb eines Newsletter-Versands gesendet werden) sind von einer Abmeldung nie betroffen.
Drei Geltungsbereiche
| Geltungsbereich | Wer setzt ihn | Was er stoppt |
|---|---|---|
| Domain | Der Empfänger, mit dem Abmeldelink oder der Ein-Klick-Schaltfläche seines E-Mail-Programms | Marketing-E-Mails der Domain, die diese E-Mail gesendet hat |
| Gesamtes Team | Sie, indem Sie unsubscribed eines Kontakts auf true setzen (API, Dashboard oder CSV-Import) |
Marketing-E-Mails jeder Domain Ihres Teams |
| Thema | Der Empfänger, auf der Abmeldeseite | E-Mails, die mit diesem Thema gesendet werden |
Die eigene Abmeldung eines Empfängers ändert nie das Flag unsubscribed des Kontakts. Sie wird als Datensatz für die Domain gespeichert, mit der E-Mail-Adresse als Schlüssel, und übersteht deshalb das Löschen und erneute Importieren des Kontakts.
Newsletter-Versände und Themen-Sendungen überspringen einen Empfänger, der sich von der Absenderdomain, vom gesamten Team oder vom Thema abgemeldet hat. Eine einzelne E-Mail, die so gestoppt wird, endet als suppressed mit dem Grund domain_unsubscribed, contact_unsubscribed oder topic_unsubscribed.
Abmeldungen sind keine Sperren. Die Sperrliste enthält Adressen, die gebounct sind, sich beschwert haben oder die Sie blockiert haben, und sie stoppt jede E-Mail, auch Transaktionsmails. Eine Abmeldung stoppt nur Marketing-E-Mails.
Die Abmeldeseite
Jede E-Mail eines Newsletter-Versands und jede Themen-E-Mail trägt List-Unsubscribe-Header für die Abmeldung mit einem Klick (RFC 8058) und einen Link zu einer gehosteten Abmeldeseite. Setzen Sie {{{UNSUBSCRIBE_URL}}} in einen Text, und er wird für jeden Empfänger zu demselben Link. Die Seite öffnet sich in der Browsersprache des Empfängers (vierzehn Sprachen, Englisch als Rückfall). Neben dem Abbestellen aller Marketing-E-Mails der Domain kann der Empfänger einzelne Themen ein- und ausschalten.
Ein Empfänger, der versehentlich geklickt hat, kann auf der Bestätigungsseite auf Wieder anmelden klicken. Das macht nur rückgängig, wovon ihn dieser Link abgemeldet hat. Ein Mail-Scanner, der den Link öffnet, meldet nie jemanden wieder an. Wenn Sie selbst unsubscribed: true setzen, hat die Seite keine Schaltfläche „Wieder anmelden“.
Jede Domain hat ihr eigenes Aussehen
Die Seite sieht aus wie die Domain, die die E-Mail gesendet hat. Jede Domain kann Folgendes festlegen:
- einen Markennamen, ein Logo und den Eckenradius des Logos,
- Hintergrund-, Text- und Akzentfarben,
- den Text über der Schaltfläche und den Text, der nach dem Speichern der Auswahl angezeigt wird,
- eine Weiterleitungs-URL, die nach der Abmeldung geöffnet wird, statt der Meldung auf der Seite.
Öffnen Sie im Dashboard die Domain und nutzen Sie den Tab Marke, der das Ergebnis in einer Vorschau zeigt. Ein Feld, das Sie leer lassen, greift auf die Marken-Standardwerte des Teams (Einstellungen) zurück, danach auf das schlichte Aussehen von BillionSend. Die Seite zeigt nur, was zu dieser Domain gehört: Sie nennt nie eine andere Domain Ihres Teams und listet nur die Themen, die an diese Domain gebunden sind, sowie die Themen ohne Domain.
Über die API senden Sie die Felder in unsubscribe_page bei PATCH /domains/{id}. Ein null leert ein Feld. Das Logo wird im Dashboard hochgeladen und ist in der API nur lesbar.
curl -X PATCH "https://api.billionsend.com/domains/$DOMAIN_ID" \
-H "Authorization: Bearer bs_..." \
-H "Content-Type: application/json" \
-d '{
"unsubscribe_page": {
"brand_name": "Acme",
"message": "Sorry to see you go. Unsubscribe from Acme emails?",
"success_message": "You are unsubscribed from Acme.",
"accent_color": "#0a7d5a",
"logo_radius": "rounded"
}
}'
Ein Link, der nicht aus einer E-Mail stammt, etwa der von POST /contacts/{id}/preferences-link, öffnet die Standardseite des Teams, und eine Abmeldung dort meldet den Kontakt von jeder Domain ab.
Ihre eigene Abmelde-Subdomain
Standardmäßig öffnen sich Links auf einem BillionSend-Host. Damit sie sich auf Ihrer eigenen Domain öffnen, geben Sie der Domain im Tab Links eine Abmelde-Subdomain oder setzen unsubscribe_subdomain bei POST /domains oder PATCH /domains/{id} (ein Label wie unsubscribe für unsubscribe.yourdomain.com; null löscht es). Sie funktioniert wie die Tracking-Subdomain, siehe Domains.
- Legen Sie den CNAME an, den der Tab DNS der Domain anzeigt, mit Ziel
cname.billiondns.com, als Nur-DNS-Eintrag (graue Wolke bei Cloudflare). - Das Zertifikat wird automatisch ausgestellt, sobald der CNAME auflöst, meist innerhalb von Minuten.
unsubscribe_statuswechselt vonpendingzuactive, undunsubscribe_errornennt den Grund, wenn das nicht klappt. - Neue E-Mails verwenden dann Ihren Host im Link und im
List-Unsubscribe-Header. Solange er nicht aktiv ist und nach einem Ergebnisfailed(72 Stunden ohne Aktivierung), wird der gemeinsame Host verwendet.
Ein bereits gesendeter Link behält den Host, mit dem er gesendet wurde, und funktioniert daher nicht mehr, wenn Sie den CNAME später entfernen. Eine Subdomain von Ihnen öffnet nur die Links ihrer eigenen Domain; jeder andere Link antwortet mit 404.
Sie können für Tracking und Abmeldung ein Label nutzen, getrennte Namen sind aber sicherer: Werbeblocker blockieren Tracking-Hosts, und ein gemeinsamer Name würde den Abmeldelink mit herunterziehen.
Abmeldungen lesen und ändern
GET /contacts/{id} liefert unsubscribed (das teamweite Flag) und unsubscribed_domains. Im Dashboard listet die Seite eines Kontakts beides auf und lässt Sie die Abmeldung von einer Domain entfernen. Der Tab Abmeldungen unter Zielgruppe listet jeden Datensatz auf.
# List, newest first. domain_id narrows to one domain.
curl "https://api.billionsend.com/unsubscribes?domain_id=$DOMAIN_ID" \
-H "Authorization: Bearer bs_..."
# Record an opt-out from one domain (leave domain_id out for every domain)
curl -X POST "https://api.billionsend.com/unsubscribes" \
-H "Authorization: Bearer bs_..." \
-H "Content-Type: application/json" \
-d '{ "email": "ada@example.org", "domain_id": "'"$DOMAIN_ID"'" }'
# Remove one record
curl -X DELETE "https://api.billionsend.com/unsubscribes/$UNSUBSCRIBE_ID" \
-H "Authorization: Bearer bs_..."
Ein Datensatz, bei dem domain_id und domain beide null sind, meldet die Adresse von jeder Domain ab. Das POST ist idempotent: Ein bestehender Datensatz kommt unverändert zurück. Dieselben Aufrufe gibt es als MCP-Tools list_unsubscribes, add_unsubscribe und delete_unsubscribe.
Was was aufhebt:
PATCH /contacts/{id}mitunsubscribed: falsehebt nur die teamweite Abmeldung auf. Abmeldungen von bestimmten Domains bleiben bestehen.DELETE /unsubscribes/{id}entfernt genau diesen einen Datensatz.
Wenn Sie eine Domain löschen und unter demselben Namen erneut hinzufügen, gelten die Abmeldungen ihrer Empfänger wieder.
Wer sie ändern darf
Inhaber, Admins und Marketing-Mitglieder sowie API-Schlüssel mit vollem Zugriff können Abmeldungen erfassen. Nur Inhaber und Admins können eine zurücknehmen. Siehe Teamrollen.
Ein auf eine Domain beschränkter API-Schlüssel verwaltet nur die Abmeldungen dieser Domain: Andere Domains liefern 403 restricted_api_key.
Eine Liste aus CSV importieren
Um eine Abmeldeliste eines anderen Anbieters zu übernehmen, öffnen Sie im Dashboard Kontakte → Abmeldungen und wählen CSV importieren.
email,domain
ada@example.com,
grace@example.com,news.example.org
alan@example.com,*
emailist erforderlich.domainist optional. Eine Kopfzeile ist ebenfalls optional.domainist eine Ihrer Domains und beschränkt die Abmeldung auf E-Mails von ihr.*steht für jede Domain. Eine leere Zelle verwendet die Standarddomain, die Sie im Dialog wählen.- Eine Zeile mit unbekannter Domain oder ungültiger Adresse wird übersprungen.
Der Dialog zeigt, wie viele Abmeldungen hinzugefügt wurden, wie viele bereits existierten und warum Zeilen übersprungen wurden. Dieselbe Datei zweimal zu importieren ist unbedenklich.
Ereignisse
Die Abmeldung eines Empfängers löst contact.unsubscribed aus, mit source gleich hosted_page oder one_click, dazu domain_id und domain_name (beide null bei einer teamweiten Abmeldung). Das Zurücknehmen löst contact.resubscribed aus. Siehe Webhooks.
Limits
| Free | Starter, Pro, Scale | |
|---|---|---|
| Aussehen der Abmeldeseite (Logo, Farben, Schrift, Logo-Eckenradius) | Standardaussehen | Ihr eigenes Aussehen pro Domain |
| Eigene Abmelde-Subdomain | Nein (gemeinsamer Host) | Ja |
| „Powered by BillionSend“ auf der Seite | Angezeigt | Ausgeblendet |
Bei Free liefert das Setzen einer Subdomain 403 plan_limit_reached. Sie können ein Seitenaussehen speichern, aber Empfänger sehen das Standardaussehen, bis Sie upgraden. Nach einem Downgrade bleiben gespeicherte Aussehen erhalten und gelten wieder, wenn Sie upgraden, und bereits gesetzte Subdomains funktionieren weiter.