SendGrid-E-Mails testen

Ein mit Single Sends erstellter Newsletter und eine über /v3/mail/send gesendete E-Mail zum Zurücksetzen des Passworts können dasselbe SendGrid-Konto verlassen und dennoch als recht unterschiedliche E-Mails ankommen. Für einen Spamtest ist das relevant. Marketing Campaigns versucht immer, Abmelde-Header hinzuzufügen, während die API sie nur hinzufügt, wenn Sie dies angefordert haben. Entscheiden Sie daher vor dem Senden, welche der beiden Varianten Sie testen.

Der Empfang funktioniert bei beiden gleich. Email Spam Tester stellt Ihnen eine temporäre Adresse bereit, ohne dass ein Konto erforderlich ist. Nur die erste Nachricht, die innerhalb einer Stunde eingeht, wird berücksichtigt. Sie erhält einen Bericht zu Authentifizierung, den Bewertungen von SpamAssassin und Rspamd, dem Inhalt, den von Gmail und Yahoo festgelegten Regeln für Massenversender sowie 21 Blocklisten, die mit Ihrer sendenden IP abgefragt werden.

Single Sends: Testschaltfläche und Präfix

Der integrierte Test befindet sich unter Marketing > Single Sends. Öffnen Sie den Single Send, suchen Sie Test Your Email, geben Sie die Testadresse ein und klicken Sie auf Send Test Message. SendGrid verlangt einen Absender und einen Betreff, bevor Sie testen können. Enthält der Betreff Handlebars, müssen außerdem Test Data eingetragen werden. Beim Versand stellt SendGrid dem Betreff Test - voran.

Für den tatsächlichen Test senden Sie den Single Send an eine Liste. Single Sends werden an Listen oder Segmente gesendet. Erstellen Sie daher eine Liste, die nur die Testadresse als Kontakt enthält, und wählen Sie sie unter Recipients aus. So entsprechen die Header, der Abmeldelink und die getrackten Links denen, die ein Abonnent erhält. Wenn Sie auch den Postfachplatzierungstest durchgeführt haben, können Sie dessen Anbieter-Postfächer ebenfalls zu dieser Liste hinzufügen.

API und SMTP: ein einziger curl-Befehl

Gekürzt aus dem Einstiegsbeispiel von SendGrid, mit der Testadresse als Empfänger:

curl --request POST \
  --url https://api.sendgrid.com/v3/mail/send \
  --header 'Authorization: Bearer <<YOUR_API_KEY>>' \
  --header 'Content-Type: application/json' \
  --data '{"personalizations":[{"to":[{"email":"test-xxxxxxxxxxxxxxxxxxxx@t.email-spam-tester.com"}],"subject":"Hello, World!"}],"content":[{"type":"text/plain","value":"Heya!"}],"from":{"email":"you@yourdomain.com","name":"Your Name"}}'

Wenn der Posteingangstest aktiviert ist, werden die Postfächer Ihrer Anbieter demselben to-Array hinzugefügt und die Markierung in subject eingefügt. So zeigt Ihnen dieselbe Anfrage auch, in welchem Ordner Gmail, Outlook, Yahoo und andere Anbieter die E-Mail ablegen.

Setzen Sie Ihre eigene Testadresse und eine von SendGrid verifizierte Absenderadresse ein, entweder über die Verifizierung eines einzelnen Absenders oder die Domain-Authentifizierung. Noch besser ist es, die Nachricht zu senden, die Ihre Anwendung tatsächlich verschickt, einschließlich des echten HTML, da die Inhaltsprüfungen den Inhalt des Nachrichtentexts bewerten.

Wenn Ihre Anwendung SMTP verwendet, ändert sich nur der Transportweg. Der Host lautet smtp.sendgrid.net, der Benutzername ist buchstäblich die Zeichenfolge apikey (nicht Ihr Schlüssel), und SSL verwendet Port 465.

Es gibt außerdem den Testsende-Endpunkt POST /v3/marketing/test/send_email. Er akzeptiert bis zu 10 Adressen, funktioniert aber nur mit Dynamic Transactional Templates. Für die meisten API-E-Mails ist daher der oben gezeigte normale Mail-Send-Aufruf der aussagekräftige Test.

Unsubscribe-Header hängen vom gewählten Versandweg ab

Marketing Campaigns versucht immer, List-Unsubscribe-Header hinzuzufügen. Über die API oder SMTP gesendete E-Mails erhalten sie nur, wenn Subscription Tracking unter Settings > Tracking aktiviert ist. In diesem Fall fügt SendGrid List-Unsubscribe mit einem HTTPS-Link und List-Unsubscribe-Post: List-Unsubscribe=One-Click ein.

Ohne Subscription Tracking fügen Sie die Header selbst zur Anfrage hinzu:

"headers": {
  "List-Unsubscribe-Post": "List-Unsubscribe=One-Click",
  "List-Unsubscribe": "<mailto:unsubscribe@yourdomain.com>, <https://yourdomain.com/unsubscribe>"
}

SendGrid verlangt sowohl den mailto- als auch den https-Teil und warnt davor, Abonnenten durch einen einfachen GET-Aufruf dieses Links abzumelden. Seien Sie vorsichtig, wenn Sie die Header aus dem Supportartikel von SendGrid kopieren. Im zweiten Beispiel wird List-Unsubscribe-Post fälschlicherweise auf URLs gesetzt. Der Wert lautet immer List-Unsubscribe=One-Click. Weitere Informationen finden Sie auf unserer Hilfeseite zum List-Unsubscribe-Header.

Wenn es sich bei der Nachricht um das Zurücksetzen eines Passworts oder eine Quittung handelt und sie keine Listen-Header enthält, markiert der Bericht die Gruppe der Regeln für Massenversender als übersprungen, statt sie als fehlgeschlagen zu bewerten. Für einen über die API versendeten Newsletter gilt diese Ausnahme nicht.

Authentifizierungsergebnisse lesen

Bei einem Konto ohne Domain-Authentifizierung sehen Empfänger nach Ihrer Absenderadresse "via sendgrid.net". Laut der Dokumentation von SendGrid wird dieser Hinweis durch die Domain-Authentifizierung entfernt. Der Bericht liefert mehr Informationen als dieser Hinweis. Sehen Sie sich die Zeilen zur DKIM- und SPF-Ausrichtung an. Wenn die Signatur oder der Return-Path zu einer SendGrid-Domain statt zu Ihrer Domain gehört, kann DMARC für Ihre Absenderadresse nicht bestehen. Der Plan sollte Sie dann auf die Domain-Authentifizierung hinweisen. Noch ungünstiger ist der Versand von einer gmail.com- oder yahoo.com-Adresse. Laut der DMARC-Seite von SendGrid schlagen bei diesen Adressen sowohl SPF als auch DKIM fehl. Auch die Konsole warnt, dass solche Nachrichten eine DMARC-Prüfung möglicherweise nicht bestehen.

Die Domain-Authentifizierung finden Sie unter Settings > Sender Authentication. Wenn die automatisierte Sicherheit aktiviert ist, was der Standardeinstellung entspricht, erhalten Sie von SendGrid vier Einträge:

• einen CNAME unter em[0000], der SPF abdeckt und zu Ihrem Return-Path wird;
• CNAMEs unter s1._domainkey und s2._domainkey für DKIM;
• einen TXT unter _dmarc mit v=DMARC1; p=none;.

Wenn die automatisierte Sicherheit deaktiviert ist, erhalten Sie unter em[0000] einen MX und einen SPF-TXT-Eintrag (v=spf1 include:sendgrid.net ~all) sowie unter m1._domainkey einen DKIM-TXT-Eintrag. Den SPF-Eintrag verwalten Sie selbst. Wenn Ihr DNS-Anbieter CNAME-Namen mit _ ablehnt, ist dies die einzige Möglichkeit. Falls ein anderer Dienst bereits den Selektor s verwendet, können Sie in SendGrid einen benutzerdefinierten Selektor auswählen. Prüfen Sie das Ergebnis mit dem DKIM-Prüftool (Selektor s1) und dem SPF-Prüftool. Letzteres zählt auch DNS-Abfragen, falls Ihr SPF-Eintrag zu umfangreich wird.

Links, IPs und der restliche Bericht

Beim Klick-Tracking wird jeder Link umgeschrieben. Wenn der Linktext selbst eine URL ist, stimmen die sichtbare Adresse und das tatsächliche Ziel nicht mehr überein, und die Prüfung auf abweichende Linkziele im Bericht meldet dies. Auf der Seite zur Zustellbarkeit von SendGrid wird auf dasselbe Problem hingewiesen. Verwenden Sie Wörter als Linktext oder richten Sie Link Branding ein, damit die getrackten Links über Ihre eigene Domain laufen. Diese muss mit Ihrer From-Domain übereinstimmen.

Die Tarife Trial und Essentials versenden über gemeinsam genutzte IP-Pools. SendGrid weist darauf hin, dass sich diese ohne Vorankündigung ändern können, wenn sich Ihre Reputation ändert. Ein Blocklisteneintrag für eine dieser IPs betrifft daher alle Nutzer dieses Pools. Mit dem Blocklisten-Prüfer können Sie die IP später erneut prüfen. Reverse DNS lässt sich nur mit einer dedizierten IP konfigurieren. Diese ist in Pro Email API und Advanced Marketing Campaigns enthalten.