Single Sends -toiminnolla luotu uutiskirje ja /v3/mail/send-rajapinnan kautta lähetetty salasanan palautusviesti voivat lähteä samalta SendGrid-tililtä mutta saapua perille hyvin erilaisina sähköposteina. Tällä on merkitystä spam-testissä. Marketing Campaigns yrittää aina lisätä tilauksen peruutusotsakkeet, kun taas API lisää ne vain pyynnöstäsi. Päätä siis ennen lähettämistä, kumpaa näistä testaat.
Vastaanottava pää toimii samalla tavalla molemmissa tapauksissa. Email Spam Tester antaa sinulle väliaikaisen osoitteen ilman käyttäjätiliä. Vain ensimmäinen tunnin kuluessa saapuva viesti huomioidaan. Siitä laaditaan raportti, joka kattaa todennuksen, SpamAssassin- ja Rspamd-tulokset, sisällön, Gmailin ja Yahoon asettamat joukkolähettäjien säännöt sekä 21 estolistaa, joista lähettävä IP-osoitteesi tarkistetaan.
Single Sends: testipainike ja sen etuliite
Sisäänrakennettu testi löytyy kohdasta Marketing > Single Sends. Avaa Single Send, etsi Test Your Email, kirjoita testiosoite ja napsauta Send Test Message. SendGrid vaatii lähettäjän ja aiheen ennen kuin voit tehdä testin. Jos aiheessa käytetään Handlebars-muuttujia, myös Test Data on täytettävä. Lähetyksen yhteydessä SendGrid lisää aiherivin alkuun etuliitteen Test - .
Lähetä varsinainen Single Send listalle. Single Sends lähetetään listoille tai segmenteille, joten luo lista, jonka ainoa yhteystieto on testiosoite, ja valitse se kohdassa Recipients. Tällöin otsakkeet, tilauksen peruutuslinkki ja seurattavat linkit ovat samat kuin tilaajan saamassa viestissä. Jos teit myös inbox-sijoitustestin, voit lisätä sen palveluntarjoajien inbox-osoitteet samalle listalle.
API ja SMTP: yksi curl-komento
Lyhennetty SendGridin aloitusesimerkistä, testiosoite vastaanottajana:
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"}}'
Kun inbox-sijoitustesti on käytössä, palveluntarjoajien testiosoitteet lisätään samaan to-taulukkoon ja tunniste lisätään subject-kenttään. Näin sama pyyntö kertoo myös, mihin kansioon Gmail, Outlook, Yahoo ja muut palveluntarjoajat sijoittavat sähköpostin.
Lisää oma testiosoitteesi ja From-osoite, jonka SendGrid on vahvistanut yksittäisen lähettäjän vahvistuksella tai verkkotunnuksen todennuksella. Vielä parempi vaihtoehto on lähettää sovelluksesi oikeasti lähettämä viesti ja sen todellinen HTML, koska sisältötarkistukset arvioivat viestin rungon sisällön.
Jos sovelluksesi käyttää SMTP:tä, vain siirtotapa muuttuu. Palvelin on smtp.sendgrid.net, käyttäjänimi on kirjaimellisesti merkkijono apikey (ei avaimesi), ja SSL käyttää porttia 465.
Käytettävissä on myös testilähetyksen päätepiste POST /v3/marketing/test/send_email. Se hyväksyy enintään 10 osoitetta, mutta toimii vain Dynamic Transactional Templates -mallien kanssa. Siksi useimmille API:n kautta lähetettäville viesteille yllä oleva tavallinen Mail Send -kutsu on luotettava testi.
Tilauksen peruutusotsakkeet riippuvat valitsemastasi lähetystavasta
Marketing Campaigns yrittää lisätä List-Unsubscribe-otsakkeet joka kerta. API:n tai SMTP:n kautta lähetetyt viestit saavat ne vain, kun Subscription Tracking on käytössä kohdassa Settings > Tracking. Tällöin SendGrid lisää List-Unsubscribe-otsakkeen, jossa on HTTPS-linkki, sekä otsakkeen List-Unsubscribe-Post: List-Unsubscribe=One-Click.
Jos Subscription Tracking ei ole käytössä, lisää otsakkeet itse pyyntöön:
"headers": {
"List-Unsubscribe-Post": "List-Unsubscribe=One-Click",
"List-Unsubscribe": "<mailto:unsubscribe@yourdomain.com>, <https://yourdomain.com/unsubscribe>"
}
SendGrid vaatii sekä mailto- että https-osan ja varoittaa peruuttamasta kenenkään tilausta tavallisella GET-pyynnöllä kyseiseen linkkiin. Ole varovainen kopioidessasi näitä otsakkeita SendGridin tukiartikkelista. Sen toisessa esimerkissä List-Unsubscribe-Post-otsakkeen arvoksi asetetaan URL-osoitteita, mikä on väärin. Arvo on aina List-Unsubscribe=One-Click. Loput tiedot ovat List-Unsubscribe-korjaussivullamme.
Jos viesti on salasanan palautusviesti tai kuitti eikä siinä ole postituslistaotsakkeita, raportti merkitsee massalähettäjien sääntöryhmän ohitetuksi hylätyn sijaan. API:n kautta lähetetty uutiskirje ei saa tätä poikkeusta.
Todennustulosten tulkitseminen
Jos tilillä ei ole toimialueen todennusta, vastaanottajat näkevät lähettäjäosoitteesi jälkeen tekstin "via sendgrid.net". SendGridin dokumentaation mukaan toimialueen todennus poistaa sen. Raportti kertoo tunnistetta enemmän. Tarkista DKIM- ja SPF-kohdistusrivit. Jos allekirjoitus tai Return-Path kuuluu sinun toimialueesi sijasta SendGridin toimialueeseen, DMARC ei voi onnistua lähettäjäosoitteellesi. Korjaussuunnitelman pitäisi tällöin ohjata sinut määrittämään toimialueen todennus. Lähettäminen gmail.com- tai yahoo.com-osoitteesta on vielä huonompi vaihtoehto. SendGridin DMARC-sivun mukaan sekä SPF että DKIM epäonnistuvat näillä osoitteilla, ja myös hallintakonsoli varoittaa, että tällaiset viestit eivät ehkä läpäise DMARC-tarkistusta.
Toimialueen todennus löytyy kohdasta Settings > Sender Authentication. Kun automaattinen suojaus on käytössä, kuten oletuksena, SendGrid antaa sinulle neljä tietuetta:
- CNAME osoitteessa
em[0000], joka kattaa SPF:n ja josta tulee Return-Path; - DKIM:n CNAME-tietueet osoitteissa
s1._domainkeyjas2._domainkey; - TXT osoitteessa
_dmarcarvollav=DMARC1; p=none;.
Esimerkkiarvot. Kopioi todelliset arvot tililtäsi.
| Nimi | Tyyppi | Arvo | Käyttötarkoitus | Kopioi |
|---|---|---|---|---|
| Automaattinen suojaus käytössä (oletus) | ||||
| em[0000] | CNAME | Tililläsi annettu kohde | SPF ja Return-Path. | |
| s1. | CNAME | Tililläsi annettu kohde | DKIM. | |
| s2. | CNAME | Tililläsi annettu kohde | DKIM, toinen valitsin. | |
| _dmarc | TXT | v= | DMARC. | |
| Automaattinen suojaus ei käytössä | ||||
| em[0000] | MX | Tililläsi annettu isäntänimi | Return-Path. | |
| em[0000] | TXT | v= | SPF, jota hallitset itse. | |
| m1. | TXT | Tililläsi annettu avain | DKIM. | |
Kun automaattinen suojaus ei ole käytössä, saat MX-tietueen ja SPF TXT -tietueen (v=spf1 include:sendgrid.net ~all) osoitteeseen em[0000] sekä DKIM TXT -tietueen osoitteeseen m1._domainkey. Hallitset tällöin SPF-tietuetta itse. Jos DNS-palveluntarjoajasi hylkää _-merkin sisältävät CNAME-nimet, tämä on ainoa vaihtoehto. Jos jokin toinen palvelu käyttää jo valitsinta s, SendGrid antaa sinun valita mukautetun valitsimen. Tarkista tulos DKIM-tarkistimella (valitsin s1) ja SPF-tarkistimella, joka laskee myös DNS-haut, jos SPF-tietueesi alkaa täyttyä.
Linkit, IP-osoitteet ja raportin muut tiedot
Klikkausten seuranta kirjoittaa kaikki linkit uudelleen. Jos linkkiteksti on URL, näkyvä osoite ja todellinen kohde eivät enää vastaa toisiaan, jolloin raportin linkkien vastaavuustarkistus merkitsee linkin. SendGridin toimitettavuutta käsittelevä sivu huomauttaa samasta ongelmasta. Käytä linkkitekstinä sanoja tai määritä linkkien brändäys, jotta seurantalinkit käyttävät omaa verkkotunnustasi, jonka on vastattava From-verkkotunnustasi.
Trial- ja Essentials-paketit lähettävät viestit jaetuista IP-varannoista. SendGrid huomauttaa, että IP-osoitteet voivat muuttua ilman ennakkoilmoitusta, jos maineesi muuttuu. Jos jokin niistä päätyy estolistalle, se koskee kaikkia saman varannon käyttäjiä. Estolistatarkistimella voit tarkistaa IP-osoitteen myöhemmin uudelleen. Käänteisen DNS:n voi määrittää vain erilliselle IP-osoitteelle, joka sisältyy Pro Email API- ja Advanced Marketing Campaigns -paketteihin.
Lisätietoja SendGridin dokumentaatiosta
Sähköpostin testauswww.twilio.com ↗Verkkotunnuksen todennuswww.twilio.com ↗List-Unsubscribewww.twilio.com ↗Linkkien brändäyswww.twilio.com ↗Kysymyksiä
Miksi sähköposteissani näkyy "via sendgrid.net"?
SendGrid ei ole vielä todentanut lähetysverkkotunnustasi. Määritä verkkotunnuksen todennus kohdassa Settings > Sender Authentication. SendGridin dokumentaation mukaan merkintä poistuu tämän jälkeen.
Raportin mukaan List-Unsubscribe puuttuu, mutta käytän SendGridiä. Miksi?
Lähetät todennäköisesti API:n tai SMTP:n kautta niin, että Subscription Tracking on poistettu käytöstä. Ota se käyttöön kohdassa Settings > Tracking tai lisää molemmat otsakkeet itse headers-objektiin.
Voinko käyttää tähän SendGridin "Send Test Message" -toimintoa?
Kyllä, viesti saapuu testiosoitteeseen. Muista kuitenkin, että aiheen alkuun lisätään Test - . Jos haluat nähdä otsakkeet täsmälleen sellaisina kuin tilaajat saavat ne, Single Send yhden yhteystiedon listalle vastaa paremmin todellista lähetystä.
Voinko käyttää testilähetyksen API-päätepistettä Mail Sendin sijaan?
Vain Dynamic Transactional Templates -malleille, koska /v3/marketing/test/send_email hyväksyy vain niitä. Se hyväksyy enintään 10 osoitetta. Kaikki muu lähetetään päätepisteen /v3/mail/send kautta.
Minkä valitsimen syötän DKIM-tarkistimeen?
Kun automaattinen suojaus on käytössä, tarkista s1 ja s2. Kun se ei ole käytössä, valitsin on m1. Jos valitsit määrityksen aikana mukautetun valitsimen, käytä sitä.