Email Spam Tester

Home › Integraatiot › Ohjeet › SendGrid

Ohje · yhteyttä ei tarvita

SendGrid-sähköpostien testaaminen

SendGridissä on saman kirjautumisen takana käytännössä kaksi lähettäjää: Marketing Campaigns -näkymät ja Email API. Ne lisäävät viesteihisi eri otsaketiedot, joten niitä testataan hieman eri tavoin.

Ohje · SendGrid

Testaa palvelusta SendGrid lähetetty sähköposti

Yksi osoite, yksi sähköpostiviesti, voimassa tunnin ajan. Ei käyttäjätiliä eikä API-avainta.

Hae testiosoite

Vaihe 1

Todenna verkkotunnus

Verkkotunnuksen todennus: CNAME-tietue osoitteessa em[0000], kaksi DKIM CNAME -tietuetta ja DMARC TXT -tietue.

Vaihe 2

Lähetä yksi oikea sähköpostiviesti testiosoitteeseen

Single Send -lähetys yhden yhteystiedon listalle tai yksi curl-kutsu osoitteeseen /v3/mail/send.

Vaihe 3

Lue raportti

Etsi "via sendgrid.net" -merkintä, kohdistusrivit ja peruutusotsakkeet.

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._domainkey ja s2._domainkey;
  • TXT osoitteessa _dmarc arvolla v=DMARC1; p=none;.

Esimerkkiarvot. Kopioi todelliset arvot tililtäsi.

NimiTyyppiArvoKäyttötarkoitusKopioi
Automaattinen suojaus käytössä (oletus)
em[0000]CNAMETililläsi annettu kohdeSPF ja Return-Path.
s1._domainkeyCNAMETililläsi annettu kohdeDKIM.
s2._domainkeyCNAMETililläsi annettu kohdeDKIM, toinen valitsin.
_dmarcTXTv=DMARC1; p=none;DMARC.
Automaattinen suojaus ei käytössä
em[0000]MXTililläsi annettu isäntänimiReturn-Path.
em[0000]TXTv=spf1 include:sendgrid.net ~allSPF, jota hallitset itse.
m1._domainkeyTXTTililläsi annettu avainDKIM.

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ä.

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.

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ä.

Muiden alustojen ohjeet

Kaikki integraatiot ja ohjeet →

Testaa sähköposti nyt

Yksi osoite, yksi sähköpostiviesti, voimassa tunnin ajan. Ei käyttäjätiliä. Raportti muodostuu automaattisesti tarkistusten valmistuessa.

Hae testiosoite