Single Sends ile oluşturulan bir bülten ve /v3/mail/send üzerinden gönderilen bir parola sıfırlama e-postası aynı SendGrid hesabından çıkmasına rağmen alıcıya oldukça farklı e-postalar olarak ulaşabilir. Bu fark spam testi açısından önemlidir. Marketing Campaigns her zaman abonelikten çıkma başlıkları eklemeye çalışırken API bunları yalnızca siz istediyseniz ekler. Bu nedenle, herhangi bir şey göndermeden önce hangisini test ettiğinize karar verin.
Alıcı tarafı her ikisi için de aynıdır. Email Spam Tester size geçici bir adres verir, hesap gerekmez. Bir saat içinde ulaşan yalnızca ilk mesaj dikkate alınır. Bu mesaj için kimlik doğrulama, SpamAssassin ve Rspamd kararları, içerik, Gmail ile Yahoo'nun belirlediği toplu gönderici kuralları ve gönderici IP adresiniz kullanılarak sorgulanan 21 engelleme listesini kapsayan bir rapor oluşturulur.
Single Sends: test düğmesi ve konu öneki
Yerleşik test Marketing > Single Sends altında bulunur. Single Send'i açın, Test Your Email seçeneğini bulun, test adresini yazın ve Send Test Message düğmesine tıklayın. SendGrid, test yapmanıza izin vermeden önce bir gönderici ve konu girmenizi ister. Handlebars içeren bir konu için Test Data alanının da doldurulması gerekir. SendGrid, gönderim sırasında konu satırının başına Test - ekler.
Gerçek gönderim için Single Send'i bir listeye gönderin. Single Sends, listelere veya segmentlere gönderilir. Bu nedenle yalnızca test adresini içeren bir kişi listesi oluşturun ve Recipients altında bu listeyi seçin. Böylece üstbilgiler, abonelikten çıkma bağlantısı ve izlenen bağlantılar, bir abonenin alacağı biçimde olur. Gelen kutusu testini de yaptıysanız sağlayıcı gelen kutularını bu listeye ekleyebilirsiniz.
API ve SMTP: tek bir curl komutu
SendGrid'in başlangıç örneği kısaltılarak ve alıcı olarak test adresi kullanılarak:
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"}}'
Gelen kutusu testi açıkken sağlayıcı gelen kutusu adresleriniz aynı to dizisine, işaretleyici de subject alanına eklenir. Böylece tek bir istek, Gmail, Outlook, Yahoo ve diğer sağlayıcıların e-postayı hangi klasöre yerleştirdiğini de gösterir.
Kendi test adresinizi ve SendGrid'in tek gönderen doğrulaması veya alan adı kimlik doğrulaması yoluyla doğruladığı bir From adresini ekleyin. Daha da iyisi, içerik kontrollerinin gövdedeki içeriği değerlendirmesi için uygulamanızın gerçekten gönderdiği mesajı gerçek HTML içeriğiyle gönderin.
Uygulamanız SMTP kullanıyorsa aktarım yöntemi dışında hiçbir şey değişmez. Sunucu smtp.sendgrid.net, kullanıcı adı tam olarak apikey dizesidir (anahtarınız değil) ve SSL 465 numaralı bağlantı noktasında çalışır.
Ayrıca POST /v3/marketing/test/send_email adlı bir test gönderme uç noktası vardır. En fazla 10 adres kabul eder ancak yalnızca Dynamic Transactional Templates ile çalışır. Bu nedenle çoğu API e-postası için yukarıdaki standart Mail Send çağrısı gerçek testi sağlar.
Abonelikten çıkma üstbilgileri seçtiğiniz yola bağlıdır
Marketing Campaigns her seferinde List-Unsubscribe üstbilgilerini eklemeye çalışır. API veya SMTP üzerinden gönderilen e-postalara bu üstbilgiler yalnızca Settings > Tracking altında Subscription Tracking etkinleştirildiğinde eklenir. Bu durumda SendGrid, HTTPS bağlantısı içeren List-Unsubscribe üstbilgisini ve List-Unsubscribe-Post: List-Unsubscribe=One-Click üstbilgisini ekler.
Subscription Tracking etkin değilse üstbilgileri isteğe kendiniz eklersiniz:
"headers": {
"List-Unsubscribe-Post": "List-Unsubscribe=One-Click",
"List-Unsubscribe": "<mailto:unsubscribe@yourdomain.com>, <https://yourdomain.com/unsubscribe>"
}
SendGrid hem mailto hem de https bölümünü ister ve bu bağlantıya yapılan düz bir GET isteğiyle kimsenin abonelikten çıkarılmaması konusunda uyarır. Bu üstbilgileri SendGrid'in destek makalesinden kopyalarken dikkatli olun. İkinci örnekte List-Unsubscribe-Post değeri URL'ler olarak ayarlanmıştır, bu yanlıştır. Değer her zaman List-Unsubscribe=One-Click olmalıdır. Geri kalan bilgiler List-Unsubscribe düzeltme sayfamızda yer alır.
İleti bir parola sıfırlama e-postası veya makbuzsa ve liste üstbilgileri içermiyorsa rapor, Toplu gönderici kuralları grubunu başarısız olarak işaretlemek yerine atlandı olarak işaretler. API üzerinden gönderilen bir bülten bu muafiyetten yararlanmaz.
Kimlik doğrulama sonuçlarını okuma
Alan adı kimlik doğrulaması olmayan bir hesapta alıcılar, From adresinizden sonra "via sendgrid.net" ifadesini görür. SendGrid belgelerine göre alan adı kimlik doğrulaması bu ifadeyi kaldırır. Rapor, bu etiketin ötesinde bilgiler sunar. DKIM ve SPF hizalama satırlarına bakın. İmza veya Return-Path sizin alan adınız yerine bir SendGrid alan adına aitse DMARC, From adresiniz için başarılı olamaz ve çözüm planı sizi alan adı kimlik doğrulamasına yönlendirmelidir. gmail.com veya yahoo.com adresinden göndermek daha da kötüdür. SendGrid'in DMARC sayfasına göre bu adreslerde hem SPF hem de DKIM başarısız olur. Konsol da bu tür iletilerin DMARC kontrolünde başarısız olabileceği konusunda uyarır.
Alan adı kimlik doğrulaması Settings > Sender Authentication bölümündedir. Varsayılan ayar olan otomatik güvenlik açıkken SendGrid size dört kayıt verir:
em[0000]konumunda SPF'yi kapsayan ve Return-Path adresiniz olan bir CNAME;- DKIM için
s1._domainkeyves2._domainkeykonumlarında CNAME kayıtları; _dmarckonumundav=DMARC1; p=none;değerine sahip bir TXT kaydı.
Örnek değerler. Gerçek değerleri hesabınızdan kopyalayın.
| Ad | Tür | Değer | Kullanım amacı | Kopyala |
|---|---|---|---|---|
| Otomatik güvenlik açık (varsayılan) | ||||
| em[0000] | CNAME | Hesabınızdaki hedef | SPF ve Return-Path. | |
| s1. | CNAME | Hesabınızdaki hedef | DKIM. | |
| s2. | CNAME | Hesabınızdaki hedef | DKIM, ikinci seçici. | |
| _dmarc | TXT | v= | DMARC. | |
| Otomatik güvenlik kapalı | ||||
| em[0000] | MX | Hesabınızdaki ana makine | Return-Path. | |
| em[0000] | TXT | v= | Sizin yönettiğiniz SPF. | |
| m1. | TXT | Hesabınızdaki anahtar | DKIM. | |
Otomatik güvenlik kapalıyken em[0000] konumunda bir MX ve SPF TXT (v=spf1 include:sendgrid.net ~all) kaydı ile m1._domainkey konumunda bir DKIM TXT kaydı alırsınız. SPF kaydını kendiniz yönetirsiniz. DNS sağlayıcınız _ içeren CNAME adlarını reddediyorsa tek seçeneğiniz budur. Ayrıca başka bir hizmet s seçicisini zaten kullanıyorsa SendGrid özel bir seçici belirlemenize izin verir. Sonucu DKIM denetleyicisi (s1 seçicisi) ve SPF denetleyicisi ile kontrol edin. SPF kaydınız kalabalıklaşıyorsa SPF denetleyicisi DNS sorgularını da sayar.
Bağlantılar, IP'ler ve raporun geri kalanı
Tıklama izleme, her bağlantıyı yeniden yazar. Bağlantı metniniz bir URL ise görünen adres ile gerçek hedef artık eşleşmez ve rapordaki bağlantı uyuşmazlığı kontrolü bunu işaretler. SendGrid'in teslim edilebilirlik sayfası da aynı soruna dikkat çeker. Bağlantı metni olarak sözcükler kullanın veya izlenen bağlantıların kendi alan adınız üzerinden çalışması için bağlantı markalamasını ayarlayın. Bu alan adı, From alan adınızla eşleşmelidir.
Trial ve Essentials planları, paylaşılan IP havuzlarından gönderim yapar. SendGrid, itibarınız değişirse bu IP'lerin bildirim yapılmadan değişebileceğini belirtir. Bu nedenle bunlardan birinin bir engelleme listesine girmesi, o havuzdaki herkesi ilgilendirir. Engelleme listesi denetleyicisi ile IP'yi daha sonra tekrar sorgulayabilirsiniz. Ters DNS yalnızca özel bir IP ile yapılandırılabilir. Bu özellik Pro Email API ve Advanced Marketing Campaigns planlarında sunulur.
SendGrid belgelerinde daha fazla bilgi
E-posta testiwww.twilio.com ↗Alan adı kimlik doğrulamasıwww.twilio.com ↗List-Unsubscribewww.twilio.com ↗Bağlantı markalamasıwww.twilio.com ↗Sorular
E-postalarım neden "via sendgrid.net" ibaresiyle görünüyor?
SendGrid, gönderim alan adınızın kimliğini henüz doğrulamamış. Settings > Sender Authentication bölümünde alan adı kimlik doğrulamasını yapılandırın. SendGrid belgelerine göre bunu yaptığınızda bu ibare kaybolur.
Raporda List-Unsubscribe eksik görünüyor, ancak SendGrid kullanıyorum. Neden?
Muhtemelen Subscription Tracking kapalıyken API veya SMTP üzerinden gönderim yapıyorsunuz. Settings > Tracking bölümünden bu özelliği açın veya her iki üstbilgiyi de headers nesnesine kendiniz ekleyin.
Bunun için SendGrid'in "Send Test Message" özelliğini kullanabilir miyim?
Evet, ileti test adresine ulaşır. Ancak konunun başına Test - eklendiğini unutmayın. Üstbilgileri abonelerin aldığı biçimiyle test etmek için tek kişilik bir listeye gönderilen Single Send daha uygun bir seçenektir.
Mail Send yerine test gönderimi API uç noktasını kullanabilir miyim?
Yalnızca Dynamic Transactional Templates için kullanabilirsiniz. /v3/marketing/test/send_email yalnızca bunları kabul eder ve en fazla 10 adres alır. Diğer tüm gönderimler /v3/mail/send üzerinden yapılır.
DKIM denetleyicisine hangi seçiciyi girmeliyim?
Otomatik güvenlik açıksa s1 ve s2 seçicilerini kontrol edin. Kapalıysa seçici m1 olur. Kurulum sırasında özel bir seçici belirlediyseniz bunun yerine onu kullanın.