Bounce-Domain
Ihre Bounce-Domain ist der Return-Path-Hostname auf einer Sendedomain. Bounces und Zustellungsrückmeldungen gehen an diese Envelope-From-Adresse. Ihr CNAME ermöglicht uns die Bounce-Verarbeitung und liefert SPF-Alignment ohne einen SPF-Eintrag an Ihrem Domain-Apex. Die Bounce-Domain ist einer der drei Einträge, die den Versand freigeben.
Diese Seite behandelt speziell den Return-Path. Den vollständigen Eintragssatz und den Verifizierungszyklus finden Sie unter Sendedomains; was jeder Eintrag nachweist, erfahren Sie unter DKIM, SPF & DMARC.
Der Eintrag
Der Return-Path ist ein CNAME unter Ihrer Sendedomain, der auf unsere Bounce-Infrastruktur in Ihrer Region auflöst:
| Typ | Host | Wert |
|---|---|---|
| CNAME | send.example.com | <region>.bounce.bird.com |
Der Wert ist regionsspezifisch: us1.bounce.bird.com oder eu1.bounce.bird.com. Kopieren Sie ihn aus Email > Domains im Dashboard oder aus der Domain-Ressource. Der Host lautet standardmäßig send. unter Ihrer Sendedomain.
Hostname anpassen
Sie wählen das Label bei der Registrierung der Domain: übergeben Sie es als return_path.name, und wir setzen den vollständigen Hostnamen unter Ihrer Sendedomain zusammen:
const domain = await bird.domains.create({
domain: "mail.acme.com",
return_path: { name: "bounce" },
});domain = client.domains.create(
domain="mail.acme.com",
return_path={"name": "bounce"},
)domain, err := client.Domains.Create(context.Background(), bird.DomainCreateParams{
Domain: "mail.acme.com",
ReturnPath: &bird.DomainReturnPathConfig{Name: "bounce"},
})$domain = $bird->domains->create(
(new DomainCreate())
->setDomain('mail.acme.com')
->setReturnPath((new DomainReturnPathConfig())->setName('bounce')),
);bird email domains create mail.acme.com --body-file - <<'JSON'
{
"domain": "mail.acme.com",
"return_path": {
"name": "bounce"
}
}
JSONcurl -s https://us1.platform.bird.com/v1/email/domains \
-H "Authorization: Bearer $BIRD_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"domain": "mail.acme.com",
"return_path": { "name": "bounce" }
}'Das registriert bounce.mail.acme.com als Return-Path anstelle des Standards send.mail.acme.com. Lassen Sie return_path weg, wird send als Standard verwendet. Der Hostname ist Teil der Workspace-Konfiguration der Sendedomain.
Warum er SPF abdeckt
Empfänger prüfen SPF anhand der Envelope-From-Domain und nicht anhand der sichtbaren From:-Adresse. Ihre Envelope-From-Adresse ist der Return-Path-Hostname. Da der verifizierte CNAME auf unsere Bounce-Infrastruktur auflöst, gilt deren SPF-Autorisierung für Sie, und sie stimmt mit Ihrer Domain überein, weil der Return-Path eine Subdomain davon ist. So besteht SPF die Prüfung und stimmt mit einem einzigen CNAME überein, und Sie müssen keinen include:-Eintrag an Ihrem Apex veröffentlichen oder pflegen. Die vollständige Herleitung finden Sie unter Wo ist SPF?.
Erforderlich für den Versand und nicht entfernbar
Der Return-Path-CNAME ist Teil der Versandfreigabe: capabilities.sending wird erst verifiziert, wenn DKIM, der Return-Path-CNAME und eine DMARC-Richtlinie vorhanden sind. Bis der Return-Path verifiziert ist, kann die Domain nicht senden.
Aus demselben Grund kann der Return-Path nicht entfernt werden. Jeder Versand braucht eine Adresse für Bounces, deshalb können Sie den Hostnamen ändern, aber nie aufheben: ein Update, das ihn auf null setzen will, wird abgelehnt. Änderungen werden sicher gestaffelt. Ein bereits verifizierter Hostname wird nie gegen einen unverifizierten ausgetauscht. Wir verifizieren den neuen Return-Path parallel zum aktiven und stufen ihn erst hoch, wenn der neue CNAME bestätigt ist – so bricht der laufende Versand nie ab, während Sie den Eintrag migrieren.
Nächste Schritte
- Sendedomains: Domain registrieren und Verifizierungszyklus
- DKIM, SPF & DMARC: jeder Eintrag auf der Domain und was er nachweist
- Tracking-Domain: der optionale gebrandete Hostname für Open-/Click-Tracking
- DNS-Anleitungen nach Anbieter: den CNAME bei Ihrem Registrar veröffentlichen
Verwandte Ressourcen
Weiter mit der Dokumentation, Anleitungen und Beispielen zu diesem Thema. Die Ressourcen sind auf Englisch.
Anleitung ansehenGetting started with emailDie Funktion erkundenEmailDem Lernpfad folgenBuild your first integrationImplementierungsleitfadenSend your first email
Übung ausprobieren und ein Implementierungs-Briefing erhalten