Newsletter vytvořený v Single Sends a e-mail pro obnovení hesla odeslaný přes /v3/mail/send mohou opustit stejný účet SendGrid, ale přesto dorazit jako značně odlišné e-maily, což je při testu spamu důležité. Marketing Campaigns se vždy snaží přidat hlavičky pro odhlášení odběru, zatímco API je přidá pouze tehdy, pokud jste je vyžádali. Než cokoli odešlete, rozhodněte se proto, kterou z těchto dvou možností testujete.
Příjem funguje v obou případech stejně. Email Spam Tester vám poskytne dočasnou adresu, účet není potřeba. Počítá se pouze první zpráva, která dorazí během jedné hodiny. Obdržíte k ní report zahrnující ověření, verdikty SpamAssassin a Rspamd, obsah, pravidla pro hromadné odesílatele stanovená službami Gmail a Yahoo a 21 seznamů blokovaných adres, které se kontrolují podle vaší odesílací IP.
Single Sends: testovací tlačítko a jeho předpona
Vestavěný test najdete v Marketing > Single Sends. Otevřete Single Send, najděte Test Your Email, zadejte testovací adresu a klikněte na Send Test Message. Než vám SendGrid umožní test odeslat, vyžaduje odesílatele a předmět. Pokud předmět obsahuje Handlebars, musíte také vyplnit Test Data. Při odeslání SendGrid přidá před předmět Test - .
Pro skutečný test odešlete Single Send do seznamu. Single Sends se odesílají do seznamů nebo segmentů, proto vytvořte seznam, ve kterém bude testovací adresa jediným kontaktem, a vyberte ho v části Recipients. Záhlaví, odkaz pro odhlášení a sledované odkazy pak budou stejné jako ty, které obdrží odběratel. Pokud jste také provedli test doručení do schránky, můžete do tohoto seznamu přidat adresy jeho schránek u jednotlivých poskytovatelů.
API a SMTP: jeden příkaz curl
Zkráceno z úvodního příkladu SendGrid, s testovací adresou jako příjemcem:
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"}}'
Když je zapnutý test doručení do schránek, adresy schránek u poskytovatelů přidáte do stejného pole to a značku do subject. Jeden požadavek vám tak také ukáže, do které složky Gmail, Outlook, Yahoo a další poskytovatelé e-mail zařadili.
Vložte vlastní testovací adresu a adresu odesílatele, kterou SendGrid ověřil pomocí ověření jednoho odesílatele nebo ověření domény. Ještě lepší je odeslat zprávu, kterou vaše aplikace skutečně odesílá, včetně jejího skutečného HTML, protože kontroly obsahu vyhodnotí obsah těla zprávy.
Pokud vaše aplikace komunikuje přes SMTP, změní se pouze způsob přenosu. Hostitel je smtp.sendgrid.net, uživatelské jméno je doslova řetězec apikey (nikoli váš klíč) a SSL používá port 465.
K dispozici je také endpoint pro testovací odeslání POST /v3/marketing/test/send_email. Přijímá až 10 adres, ale funguje pouze s Dynamic Transactional Templates, takže pro většinu e-mailů odesílaných přes API je běžné volání Mail Send uvedené výše věrohodným testem.
Hlavičky pro odhlášení závisí na zvoleném způsobu odeslání
Marketing Campaigns se snaží přidávat hlavičky List-Unsubscribe pokaždé. E-maily odeslané přes API nebo SMTP je dostanou pouze tehdy, když je v části Settings > Tracking zapnutá možnost Subscription Tracking. SendGrid pak vloží List-Unsubscribe s odkazem HTTPS a List-Unsubscribe-Post: List-Unsubscribe=One-Click.
Bez Subscription Tracking musíte hlavičky přidat do požadavku sami:
"headers": {
"List-Unsubscribe-Post": "List-Unsubscribe=One-Click",
"List-Unsubscribe": "<mailto:unsubscribe@yourdomain.com>, <https://yourdomain.com/unsubscribe>"
}
SendGrid vyžaduje část mailto i https a varuje, abyste nikoho neodhlašovali při běžném požadavku GET na tento odkaz. Při kopírování z článku podpory SendGrid o těchto hlavičkách buďte opatrní. Jeho druhý příklad nastavuje List-Unsubscribe-Post na URL, což je chybně. Hodnota je vždy List-Unsubscribe=One-Click. Další informace najdete na naší stránce s opravou List-Unsubscribe.
Pokud je zpráva určena k obnovení hesla nebo obsahuje účtenku a nemá žádné hlavičky seznamu, přehled označí skupinu pravidel pro hromadné odesílatele jako přeskočenou, místo aby ji vyhodnotil jako neúspěšnou. Newsletter odeslaný přes API tuto výjimku nedostane.
Jak číst výsledky ověření
U účtu bez ověření domény příjemci za vaší adresou From uvidí „via sendgrid.net“ a podle dokumentace SendGrid ověření domény tento text odstraní. Report ale poskytuje více informací než jen tento štítek. Podívejte se na řádky se zarovnáním DKIM a SPF. Pokud podpis nebo Return-Path patří doméně SendGrid místo vaší doméně, DMARC pro vaši adresu From nemůže projít a plán by vás měl odkázat na ověření domény. Odesílání z adresy na doméně gmail.com nebo yahoo.com je ještě horší. Na stránce SendGrid věnované DMARC se uvádí, že u těchto adres selžou SPF i DKIM, a samotná konzole upozorňuje, že takové zprávy nemusí projít kontrolou DMARC.
Ověření domény najdete v části Settings > Sender Authentication. Se zapnutým automatickým zabezpečením, které je výchozí, vám SendGrid poskytne čtyři záznamy:
- CNAME na
em[0000], který pokrývá SPF a stane se vaším Return-Path; - záznamy CNAME na
s1._domainkeyas2._domainkeypro DKIM; - TXT na
_dmarcs hodnotouv=DMARC1; p=none;.
Ukázkové hodnoty. Skutečné hodnoty zkopírujte ze svého účtu.
| Název | Typ | Hodnota | K čemu slouží | Kopírovat |
|---|---|---|---|---|
| Automatické zabezpečení zapnuto (výchozí) | ||||
| em[0000] | CNAME | Cíl z vašeho účtu | SPF a Return-Path. | |
| s1. | CNAME | Cíl z vašeho účtu | DKIM. | |
| s2. | CNAME | Cíl z vašeho účtu | DKIM, druhý selektor. | |
| _dmarc | TXT | v= | DMARC. | |
| Automatické zabezpečení vypnuto | ||||
| em[0000] | MX | Hostitel z vašeho účtu | Return-Path. | |
| em[0000] | TXT | v= | SPF, o který se staráte sami. | |
| m1. | TXT | Klíč z vašeho účtu | DKIM. | |
S vypnutým automatickým zabezpečením získáte na em[0000] záznam MX a SPF TXT (v=spf1 include:sendgrid.net ~all) a k tomu DKIM TXT na m1._domainkey. O záznam SPF se staráte sami. Pokud váš poskytovatel DNS odmítá názvy CNAME obsahující _, je to jediná možnost. Pokud už jiná služba používá selektor s, SendGrid vám umožní vybrat vlastní. Výsledek zkontrolujte pomocí kontroly DKIM (selektor s1) a kontroly SPF, která také počítá dotazy DNS, pokud už je váš záznam SPF příliš rozsáhlý.
Odkazy, IP adresy a zbytek reportu
Sledování kliknutí přepisuje každý odkaz. Pokud je textem odkazu samotná URL, viditelná adresa přestane odpovídat skutečnému cíli a kontrola neshody odkazů v reportu ji označí. Na stejný problém upozorňuje také stránka SendGrid o doručitelnosti. Jako text odkazu používejte slova nebo nastavte branding odkazů tak, aby sledované odkazy vedly přes vaši vlastní doménu, která se musí shodovat s doménou v poli From.
Plány Trial a Essentials odesílají ze sdílených fondů IP adres. SendGrid upozorňuje, že pokud se změní vaše reputace, mohou být tyto adresy bez upozornění změněny. Výskyt jedné z nich na seznamu blokovaných adres se proto týká všech uživatelů daného fondu. Pomocí nástroje pro kontrolu seznamů blokovaných adres můžete IP adresu později zkontrolovat znovu. Reverse DNS lze nastavit pouze s vyhrazenou IP adresou, která je součástí plánů Pro Email API a Advanced Marketing Campaigns.
Další informace v dokumentaci SendGrid
Testování e-mailůwww.twilio.com ↗Ověření doménywww.twilio.com ↗List-Unsubscribewww.twilio.com ↗Branding odkazůwww.twilio.com ↗Otázky
Proč se u mých e-mailů zobrazuje „via sendgrid.net“?
SendGrid zatím neověřil vaši odesílací doménu. Nastavte ověření domény v Settings > Sender Authentication. Podle dokumentace SendGrid pak toto označení zmizí.
Report uvádí, že chybí List-Unsubscribe, ale používám SendGrid. Proč?
Pravděpodobně odesíláte přes API nebo SMTP s vypnutou funkcí Subscription Tracking. Zapněte ji v Settings > Tracking, nebo obě hlavičky přidejte sami do objektu headers.
Mohu k tomu použít funkci „Send Test Message“ v SendGrid?
Ano, zpráva dorazí na testovací adresu. Jen mějte na paměti, že před předmět se přidá Test - . Pokud chcete hlavičky přesně ve stejné podobě, v jaké je dostávají odběratelé, vhodnější je Single Send do seznamu s jedním kontaktem.
Mohu místo Mail Send použít koncový bod API pro testovací odeslání?
Pouze pro Dynamic Transactional Templates, protože /v3/marketing/test/send_email nic jiného nepřijímá. Lze zadat až 10 adres. Všechno ostatní se odesílá přes /v3/mail/send.
Který selektor mám zadat do kontroly DKIM?
Pokud je zapnuté automatické zabezpečení, zkontrolujte s1 a s2. Pokud je vypnuté, selektor je m1. Jestli jste během nastavení zvolili vlastní selektor, použijte místo něj ten.