A Single Sends szolgáltatásban összeállított hírlevél és a /v3/mail/send útvonalon keresztül küldött jelszó-visszaállítás ugyanabból a SendGrid-fiókból indulhat, mégis jelentősen eltérő e-mailként érkezhet meg, ami fontos a spamtesztnél. A Marketing Campaigns mindig megpróbál leiratkozási fejléceket hozzáadni, míg az API csak akkor adja hozzá őket, ha Ön ezt kérte. Ezért még a küldés előtt döntse el, hogy a kettő közül melyiket teszteli.
A fogadó oldal mindkét esetben ugyanaz. Az Email Spam Tester ideiglenes címet biztosít, fiók létrehozása nélkül. Csak az egy órán belül beérkező első üzenet számít, és erről jelentés készül, amely kiterjed a hitelesítésre, a SpamAssassin és a Rspamd eredményeire, a tartalomra, a Gmail és a Yahoo által meghatározott tömeges küldőkre vonatkozó szabályokra, valamint a küldő IP alapján lekérdezett 21 tiltólistára.
Single Sends: a tesztgomb és az előtagja
A beépített teszt a Marketing > Single Sends alatt található. Nyissa meg a Single Send elemet, keresse meg a Test Your Email lehetőséget, írja be a tesztcímet, majd kattintson a Send Test Message gombra. A SendGrid csak a feladó és a tárgy megadása után engedélyezi a tesztelést, Handlebars-kódot tartalmazó tárgy esetén pedig a Test Data mezőt is ki kell tölteni. Küldéskor a SendGrid a Test - előtagot illeszti a tárgysor elé.
A tényleges teszthez küldje el a Single Send elemet egy listára. A Single Sends listákra vagy szegmensekre küldhető, ezért hozzon létre egy listát, amelynek egyetlen névjegye a tesztcím, majd válassza ki ezt a Recipients alatt. Így a fejlécek, a leiratkozási hivatkozás és a nyomon követett hivatkozások megegyeznek azokkal, amelyeket egy feliratkozó kap. Ha beérkezési tesztet is végzett, annak szolgáltatói postafiókjait is hozzáadhatja ehhez a listához.
Az API és az SMTP: egyetlen curl parancs
A SendGrid első lépéseket bemutató példájának rövidített változata, amelyben a tesztcím a címzett:
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"}}'
Ha a beérkezési teszt be van kapcsolva, a szolgáltatóknál használt postaládái ugyanabba a to tömbbe kerülnek, a jelölő pedig a subject mezőbe, így az egyetlen kérés azt is megmutatja, hogy a Gmail, Outlook, Yahoo és más szolgáltatók melyik mappába helyezik az e-mailt.
Illessze be a saját tesztcímét, és adjon meg olyan From címet, amelyet a SendGrid egyedi feladó-ellenőrzéssel vagy domainhitelesítéssel ellenőrzött. Még jobb, ha azt az üzenetet küldi el, amelyet az alkalmazása ténylegesen küld, a valódi HTML-tartalommal együtt, mert a tartalom-ellenőrzések a levéltörzs tartalmát értékelik.
Ha az alkalmazása SMTP-n keresztül kommunikál, csak az átviteli mód változik. A kiszolgáló címe smtp.sendgrid.net, a felhasználónév szó szerint az apikey karakterlánc, nem az Ön kulcsa, az SSL pedig a 465-ös porton működik.
Tesztküldési végpont is rendelkezésre áll: POST /v3/marketing/test/send_email. Legfeljebb 10 címet fogad, de csak Dynamic Transactional Templates sablonokkal működik, ezért a legtöbb API-n keresztül küldött levélnél a fenti egyszerű Mail Send hívás ad valós teszteredményt.
A leiratkozási fejlécek a választott küldési módtól függenek
A Marketing Campaigns minden esetben megpróbál List-Unsubscribe fejléceket hozzáadni. Az API-n vagy SMTP-n keresztül küldött levelek csak akkor kapják meg ezeket, ha a Settings > Tracking alatt be van kapcsolva a Subscription Tracking. Ebben az esetben a SendGrid egy HTTPS-hivatkozást tartalmazó List-Unsubscribe fejlécet, valamint egy List-Unsubscribe-Post: List-Unsubscribe=One-Click fejlécet illeszt be.
Subscription Tracking nélkül Önnek kell hozzáadnia a fejléceket a kéréshez:
"headers": {
"List-Unsubscribe-Post": "List-Unsubscribe=One-Click",
"List-Unsubscribe": "<mailto:unsubscribe@yourdomain.com>, <https://yourdomain.com/unsubscribe>"
}
A SendGrid a mailto és a https részt is kéri, és arra figyelmeztet, hogy egy egyszerű GET kérés hatására senkit se irasson le ezen a hivatkozáson. Legyen óvatos, amikor a SendGrid e fejlécekről szóló támogatási cikkéből másol. A második példában a List-Unsubscribe-Post értékeként URL-ek szerepelnek, ami hibás. Az érték mindig List-Unsubscribe=One-Click. A további részleteket a List-Unsubscribe javítási oldalunkon találja.
Ha az üzenet jelszó-visszaállítás vagy nyugta, és nem tartalmaz levelezőlistás fejléceket, a jelentés sikertelen minősítés helyett kihagyottként jelöli meg a tömeges küldőkre vonatkozó szabálycsoportot. Az API-n keresztül küldött hírlevél nem kap ilyen felmentést.
A hitelesítési eredmények értelmezése
Tartományhitelesítés nélküli fióknál a címzettek a „via sendgrid.net” szöveget látják az Ön feladói címe után, a SendGrid dokumentációja szerint pedig ezt a tartományhitelesítés távolítja el. A jelentés azonban ennél a címkénél többet mutat. Nézze meg a DKIM- és SPF-igazítás sorait. Ha az aláírás vagy a visszatérési útvonal az Ön tartománya helyett egy SendGrid-tartományhoz tartozik, a DMARC nem lehet sikeres az Ön feladói címénél, és a tervnek a tartományhitelesítést kell javasolnia. Még rosszabb, ha gmail.com vagy yahoo.com címről küld. A SendGrid DMARC-oldala szerint ezeknél az SPF és a DKIM is sikertelen, és maga a konzol is figyelmeztet arra, hogy az ilyen üzenetek esetleg nem mennek át a DMARC-ellenőrzésen.
A tartományhitelesítés a Settings > Sender Authentication menüpontban található. Ha az alapértelmezés szerint bekapcsolt automatikus biztonság aktív, a SendGrid négy rekordot ad:
- egy CNAME rekordot az
em[0000]névnél, amely az SPF-et kezeli, és az Ön visszatérési útvonala lesz; - CNAME rekordokat az
s1._domainkeyés azs2._domainkeynévnél a DKIM-hez; - egy TXT rekordot a
_dmarcnévnél,v=DMARC1; p=none;értékkel.
Példaértékek. A tényleges értékeket másolja ki a fiókjából.
| Név | Típus | Érték | Mire szolgál | Másolás |
|---|---|---|---|---|
| Automatikus biztonság bekapcsolva (alapértelmezett) | ||||
| em[0000] | CNAME | A fiókjában megadott célérték | SPF és a visszatérési útvonal. | |
| s1. | CNAME | A fiókjában megadott célérték | DKIM. | |
| s2. | CNAME | A fiókjában megadott célérték | DKIM, a második selector. | |
| _dmarc | TXT | v= | DMARC. | |
| Automatikus biztonság kikapcsolva | ||||
| em[0000] | MX | A fiókjában megadott hoszt | A visszatérési útvonal. | |
| em[0000] | TXT | v= | SPF, amelyet Ön kezel. | |
| m1. | TXT | A fiókjában megadott kulcs | DKIM. | |
Kikapcsolt automatikus biztonságnál egy MX rekordot és egy SPF TXT rekordot (v=spf1 include:sendgrid.net ~all) kap az em[0000] névnél, valamint egy DKIM TXT rekordot az m1._domainkey névnél, az SPF rekordot pedig Ön kezeli. Ha DNS-szolgáltatója elutasítja az _ karaktert tartalmazó CNAME-neveket, ez az egyetlen lehetőség. Ha pedig egy másik szolgáltatás már használja az s selectort, a SendGrid lehetővé teszi egy egyéni selector kiválasztását. Ellenőrizze az eredményt a DKIM-ellenőrzővel (s1 selector) és az SPF-ellenőrzővel, amely a DNS-lekérdezéseket is megszámolja, ha az SPF rekordja kezd túlzsúfolttá válni.
Hivatkozások, IP-címek és a jelentés többi része
A kattintáskövetés minden hivatkozást átír. Ha a hivatkozás szövege maga is URL, a látható cím és a tényleges cél már nem egyezik, ezért a jelentés hivatkozáseltérés-ellenőrzése megjelöli. A SendGrid kézbesíthetőségi oldala ugyanezt a problémát emeli ki. Használjon szavakat a hivatkozás szövegeként, vagy állítsa be a hivatkozások márkajelzését, hogy a követett hivatkozások az Ön saját domainjén haladjanak át, amelynek egyeznie kell a feladói domainnel.
A Trial és Essentials csomagok megosztott IP-készletekből küldenek. A SendGrid szerint ezek előzetes értesítés nélkül változhatnak, ha megváltozik az Ön hírneve, ezért ha valamelyik IP tiltólistára kerül, az az adott készlet minden használóját érinti. A tiltólista-ellenőrzővel később ismét ellenőrizheti az IP-címet. A Reverse DNS csak dedikált IP-címmel állítható be, amely a Pro Email API és az Advanced Marketing Campaigns csomaghoz érhető el.
További információ a SendGrid dokumentációjában
E-mail-teszteléswww.twilio.com ↗Domain hitelesítésewww.twilio.com ↗List-Unsubscribewww.twilio.com ↗Hivatkozások márkajelzésewww.twilio.com ↗Kérdések
Miért jelenik meg a „via sendgrid.net” az e-mailjeimnél?
A SendGrid még nem hitelesítette az Ön küldő domainjét. Állítsa be a domainhitelesítést a Settings > Sender Authentication alatt. A SendGrid dokumentációja szerint ezután eltűnik a jelölés.
A jelentés szerint hiányzik a List-Unsubscribe, pedig SendGridet használok. Miért?
Valószínűleg az API-n vagy SMTP-n keresztül küld, miközben a Subscription Tracking ki van kapcsolva. Kapcsolja be a Settings > Tracking alatt, vagy adja hozzá mindkét fejlécet a headers objektumban.
Használhatom ehhez a SendGrid „Send Test Message” funkcióját?
Igen, az üzenet megérkezik a tesztcímre. Ne feledje, hogy a tárgysor elejére bekerül a Test - előtag. Ha pontosan olyan fejléceket szeretne, mint amilyeneket a feliratkozók kapnak, akkor jobb megoldás egy Single Send küldése egy egyetlen névjegyet tartalmazó listára.
Használhatom a tesztküldési API-végpontot a Mail Send helyett?
Csak Dynamic Transactional Templates esetén, mert a /v3/marketing/test/send_email kizárólag ezt fogadja el. Legfeljebb 10 címet kezel. Minden más a /v3/mail/send végponton keresztül megy.
Melyik szelektort írjam be a DKIM-ellenőrzőbe?
Ha az automatikus biztonság be van kapcsolva, ellenőrizze az s1 és az s2 szelektort. Ha ki van kapcsolva, a szelektor m1. Ha a beállítás során egyéni szelektort választott, akkor azt használja.