Test af SendGrid-mails

Et nyhedsbrev, der er oprettet i Single Sends, og en nulstilling af adgangskode, der er sendt via /v3/mail/send, kan forlade den samme SendGrid-konto og alligevel nå frem som ret forskellige e-mails. Det har betydning for en spamtest. Marketing Campaigns forsøger altid at tilføje afmeldingsheadere, mens API'et kun tilføjer dem, hvis du har bedt om det. Beslut derfor, hvilken af de to du tester, før du sender noget.

Modtagelsen er den samme for begge. Email Spam Tester giver dig en midlertidig adresse, og der kræves ingen konto. Kun den første meddelelse, der ankommer inden for en time, tæller. Den får en rapport, der dækker godkendelse, vurderinger fra SpamAssassin og Rspamd, indhold, de regler for masseafsendere, som Gmail og Yahoo har fastsat, samt 21 blokeringslister, der kontrolleres med din afsender-IP.

Single Sends: testknappen og dens præfiks

Den indbyggede test findes under Marketing > Single Sends. Åbn din Single Send, find Test Your Email, indtast testadressen, og klik på Send Test Message. SendGrid kræver en afsender og et emne, før du kan teste, og hvis emnet indeholder Handlebars, skal Test Data være udfyldt. Ved afsendelse sætter SendGrid Test - foran emnelinjen.

Ved en rigtig afsendelse skal du sende din Single Send til en liste. Single Sends sendes til lister eller segmenter, så opret en liste, hvor testadressen er den eneste kontakt, og vælg den under Recipients. Nu er headers, afmeldingslinket og de sporede links de samme som dem, en abonnent modtager. Hvis du også har taget placeringstesten, kan dens indbakker hos udbyderne føjes til listen.

API og SMTP: én curl-kommando

Forkortet fra SendGrids eksempel til at komme i gang, med testadressen som modtager:

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"}}'

Når placeringstesten er aktiveret, føjes dine testindbakker hos udbyderne til det samme to-array, og markøren føjes til subject. Dermed fortæller den samme anmodning dig også, hvilken mappe Gmail, Outlook, Yahoo og andre udbydere placerer e-mailen i.

Indsæt din egen testadresse og en afsender, som SendGrid har bekræftet via bekræftelse af en enkelt afsender eller domænegodkendelse. Endnu bedre er det at sende den besked, som din app faktisk sender, med dens rigtige HTML, fordi indholdskontrollerne vurderer det, der står i meddelelsesteksten.

Hvis din applikation bruger SMTP, ændres kun transporten. Værten er smtp.sendgrid.net, brugernavnet er bogstaveligt talt strengen apikey (ikke din nøgle), og SSL kører på port 465.

Der findes også et slutpunkt til testafsendelse, POST /v3/marketing/test/send_email. Det accepterer op til 10 adresser, men fungerer kun med Dynamic Transactional Templates. For de fleste API-mails er det almindelige Mail Send-kald ovenfor derfor den mest retvisende test.

Afmeldingsheadere afhænger af den valgte metode

Marketing Campaigns forsøger altid at tilføje List-Unsubscribe-headere. Mail sendt via API eller SMTP får dem kun, når Subscription Tracking er slået til under Settings > Tracking. I så fald indsætter SendGrid List-Unsubscribe med et HTTPS-link og List-Unsubscribe-Post: List-Unsubscribe=One-Click.

Uden Subscription Tracking skal du selv tilføje headerne i anmodningen:

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

SendGrid kræver både mailto- og https-delen og advarer mod at afmelde nogen ved en almindelig GET-anmodning til linket. Vær forsigtig, når du kopierer fra SendGrids supportartikel om disse headere. Det andet eksempel angiver URL'er som værdi for List-Unsubscribe-Post, hvilket er forkert. Værdien er altid List-Unsubscribe=One-Click. Du finder resten på vores side om rettelse af List-Unsubscribe.

Hvis meddelelsen er en nulstilling af adgangskoden eller en kvittering og ikke indeholder nogen listeheadere, markerer rapporten gruppen med regler for masseafsendere som sprunget over i stedet for at lade kontrollen fejle. Et nyhedsbrev sendt via API får ikke denne undtagelse.

Sådan læser du godkendelsesresultaterne

På en konto uden domænegodkendelse ser modtagerne "via sendgrid.net" efter din Fra-adresse, og ifølge SendGrids dokumentation fjerner domænegodkendelse denne tekst. Rapporten går videre end teksten. Se på linjerne for DKIM- og SPF-justering. Hvis signaturen eller returstien tilhører et SendGrid-domæne i stedet for dit, kan DMARC ikke godkendes for din Fra-adresse, og planen bør henvise dig til domænegodkendelse. Det er værre at sende fra en gmail.com- eller yahoo.com-adresse. På SendGrids DMARC-side står der, at både SPF og DKIM fejler for disse adresser, og selve konsollen advarer om, at sådanne meddelelser muligvis ikke består en DMARC-kontrol.

Domænegodkendelse findes under Settings > Sender Authentication. Når Automated security er slået til, hvilket er standardindstillingen, giver SendGrid dig fire poster:

• en CNAME på em[0000], som dækker SPF og bliver din retursti;
• CNAME-poster på s1._domainkey og s2._domainkey til DKIM;
• en TXT-post på _dmarc med v=DMARC1; p=none;.

Når Automated security er slået fra, får du en MX-post og en SPF TXT-post (v=spf1 include:sendgrid.net ~all) på em[0000] samt en DKIM TXT-post på m1._domainkey, og du administrerer selv SPF-posten. Hvis din DNS-udbyder afviser CNAME-navne, der indeholder _, er dette den eneste mulighed. Hvis en anden tjeneste allerede bruger selectoren s, giver SendGrid dig mulighed for at vælge en tilpasset selector. Kontrollér resultatet med DKIM-kontrollen (selector s1) og SPF-kontrollen, som også tæller DNS-opslag, hvis din SPF-post er ved at blive overfyldt.

Links, IP'er og resten af rapporten

Kliksporing omskriver alle links. Hvis din linktekst i sig selv er en URL, stemmer den synlige adresse og den faktiske destination ikke længere overens, og rapportens kontrol for uoverensstemmende links markerer det. SendGrids side om leveringsevne påpeger det samme problem. Brug ord som linktekst, eller konfigurer linkbranding, så de sporede links bruger dit eget domæne, som skal matche dit From-domæne.

Trial- og Essentials-abonnementer sender fra delte IP-puljer. SendGrid oplyser, at de kan ændres uden varsel, hvis dit omdømme ændrer sig, så en bloklistemarkering af en af dem påvirker alle i den pågældende pulje. Med bloklistekontrollen kan du slå IP'en op igen senere. Reverse DNS kan kun konfigureres med en dedikeret IP, som følger med Pro Email API og Advanced Marketing Campaigns.