Testing av e-post fra SendGrid

Et nyhetsbrev som er opprettet i Single Sends, og en tilbakestilling av passord som sendes via /v3/mail/send, kan sendes fra samme SendGrid-konto og likevel komme frem som ganske forskjellige e-poster. Dette har betydning for en spamtest. Marketing Campaigns prøver alltid å legge til avmeldingshoder, mens API bare legger dem til hvis du har bedt om det. Bestem derfor hvilken av de to du tester før du sender noe.

Mottakssiden er den samme for begge. Email Spam Tester gir deg en midlertidig adresse, uten at du trenger en konto. Bare den første meldingen som kommer frem i løpet av en time, teller. Du får en rapport som dekker autentisering, vurderinger fra SpamAssassin og Rspamd, innhold, reglene for masseavsendere som Gmail og Yahoo har fastsatt, og 21 blokkeringslister som sjekkes mot IP-adressen du sender fra.

Single Sends: testknappen og prefikset

Den innebygde testen finner du under Marketing > Single Sends. Åpne Single Send, finn Test Your Email, skriv inn testadressen og klikk på Send Test Message. SendGrid krever en avsender og et emne før du kan teste. Hvis emnet inneholder Handlebars, må Test Data være fylt ut. Når meldingen sendes, legger SendGrid Test - foran emnefeltet.

For en reell test sender du Single Send til en liste. Single Sends sendes til lister eller segmenter, så opprett en liste der testadressen er den eneste kontakten, og velg den under Recipients. Da blir overskriftene, avmeldingslenken og de sporede lenkene de samme som en abonnent mottar. Hvis du også tok innboksplasseringstesten, kan innboksene hos leverandørene fra testen legges til i denne listen.

API og SMTP: én curl-kommando

Forkortet fra SendGrids introduksjonseksempel, med testadressen som mottaker:

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 innbokstesten er aktivert, legges innboksadressene hos leverandørene i den samme to-matrisen, og markøren legges i subject. Dermed forteller den samme forespørselen også hvilken mappe Gmail, Outlook, Yahoo og andre leverandører plasserer e-posten i.

Lim inn din egen testadresse og en From-adresse som SendGrid har verifisert, enten gjennom verifisering av en enkelt avsender eller domeneautentisering. Enda bedre er det å sende meldingen appen din faktisk sender, med den virkelige HTML-koden, fordi innholdskontrollene vurderer det som står i meldingsteksten.

Hvis applikasjonen din bruker SMTP, er det bare transporten som endres. Verten er smtp.sendgrid.net, brukernavnet er bokstavelig talt strengen apikey (ikke nøkkelen din), og SSL bruker port 465.

Det finnes også et endepunkt for testsending, POST /v3/marketing/test/send_email. Det støtter opptil 10 adresser, men fungerer bare med Dynamic Transactional Templates. For de fleste e-poster som sendes via API, er derfor det vanlige Mail Send-kallet ovenfor den mest realistiske testen.

Avmeldingshoder avhenger av veien du valgte

Marketing Campaigns prøver alltid å legge til List-Unsubscribe-hoder. E-post som sendes via API eller SMTP, får dem bare når Subscription Tracking er slått på under Settings > Tracking. Da setter SendGrid inn List-Unsubscribe med en HTTPS-lenke og List-Unsubscribe-Post: List-Unsubscribe=One-Click.

Uten Subscription Tracking må du selv legge til hodene i forespørselen:

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

SendGrid ber om både mailto-delen og https-delen, og advarer mot å melde av noen ved en vanlig GET-forespørsel til denne lenken. Vær forsiktig når du kopierer fra SendGrids støtteartikkel om disse hodene. Det andre eksempelet setter List-Unsubscribe-Post til URL-er, noe som er feil. Verdien er alltid List-Unsubscribe=One-Click. Du finner resten på siden vår om å rette List-Unsubscribe.

Hvis meldingen er en tilbakestilling av passord eller en kvittering og ikke inneholder listehoder, markerer rapporten regelgruppen for masseutsendere som hoppet over i stedet for å underkjenne den. Et nyhetsbrev som sendes via API, får ikke dette unntaket.

Slik leser du autentiseringsresultatene

På en konto uten domeneautentisering ser mottakerne "via sendgrid.net" etter Fra-adressen din, og dokumentasjonen til SendGrid sier at domeneautentisering fjerner dette. Rapporten går lenger enn denne merkingen. Se på linjene for DKIM- og SPF-justering. Hvis signaturen eller returstien tilhører et SendGrid-domene i stedet for ditt, kan ikke DMARC bestå for Fra-adressen din, og planen bør vise deg hvordan du konfigurerer domeneautentisering. Det er enda verre å sende fra en gmail.com- eller yahoo.com-adresse. DMARC-siden til SendGrid sier at både SPF og DKIM mislykkes for disse, og selve konsollen advarer om at slike meldinger kanskje ikke består en DMARC-kontroll.

Domeneautentisering finner du under Settings > Sender Authentication. Når automatisk sikkerhet er på, noe den er som standard, gir SendGrid deg fire oppføringer:

• en CNAME på em[0000], som dekker SPF og blir returstien din;
• CNAME-oppføringer på s1._domainkey og s2._domainkey for DKIM;
• en TXT på _dmarc med v=DMARC1; p=none;.

Når automatisk sikkerhet er av, får du en MX og en SPF TXT (v=spf1 include:sendgrid.net ~all) på em[0000], pluss en DKIM TXT på m1._domainkey, og du administrerer SPF-oppføringen selv. Hvis DNS-leverandøren din avviser CNAME-navn som inneholder _, er dette det eneste alternativet. Hvis en annen tjeneste allerede bruker selektoren s, lar SendGrid deg velge en egendefinert selektor. Kontroller resultatet med DKIM-kontrollen (selektor s1) og SPF-kontrollen, som også teller DNS-oppslag hvis SPF-oppføringen din begynner å bli omfattende.

Lenker, IP-er og resten av rapporten

Klikksporing skriver om alle lenker. Hvis lenketeksten i seg selv er en URL, samsvarer ikke lenger den synlige adressen med det faktiske målet, og rapportens kontroll for avvikende lenker varsler om dette. SendGrids side om leveringsevne omtaler det samme problemet. Bruk ord som lenketekst, eller konfigurer lenkeprofilering slik at de sporede lenkene går gjennom ditt eget domene, som må samsvare med From-domenet ditt.

Trial- og Essentials-abonnementer sender fra delte IP-pooler. SendGrid opplyser at disse kan endres uten varsel hvis omdømmet ditt endres, så en oppføring på en blokkeringsliste for én av dem gjelder alle i den aktuelle poolen. Med blokkeringslistekontrollen kan du slå opp IP-adressen på nytt senere. Omvendt DNS kan bare konfigureres med en dedikert IP, som er inkludert med Pro Email API og Advanced Marketing Campaigns.