Uutiskirjeen tilauslomakkeen upottaminen ulkopuoliselle sivulle

Uutiskirjeen tilauslomakkeen voi laittaa varsinaisen tilaussivun lisäksi myös esimerkiksi kotisivuille. Lomakkeessa tulee olla mukana ainakin sähköpostikenttä ja sen listan tunnistenumero, jolle tilaaja liittyy tilauksen tehdessään. Voit joko upottaa suoraan LianaMailer-lomakkeen sivustollesi tai voit vaihtoehtoisesti lisätä upotuskoodit sivustollasi jo olevaan lomakkeeseen. Alla on esiteltynä molemmat vaihtoehdot.

Upotetut lomakkeet sivustollesi 

Asetukset-sivulta Sivustot-kohdan välilehdeltä Upotetut lomakkeet voit poimia tilaustoiminnon upotuskoodin verkkosivustollesi. Voit valita upotukseen staattisen tai dynaamisen lomakkeen. Dynaamisen lomakkeen upotuksen hyötynä on se, että mikäli tilaussivulle lisätään uusia tietokenttiä, päivittyvät ne automaattisesti myös verkkosivuston lomakkeelle. Mikäli taas et halua kaikkia tietokenttiä verkkosivuston lomakkeelle, kannattaa käyttää staattista upotusta.

Voit myös poimia LianaMaileriin määritetyt CSS-tyylimääritykset verkkosivuston lomakkeelle tai vaihtoehtoisesti käyttää verkkosivustosi omia tyylimäärityksiä.

Upotuskoodi sivuston lomakkeeseen

Peruslomake
Alla on esimerkkilomake, mitä voi käyttää mallina upotuksessa. Huomioi, että esimerkin kohdat ASIAKAS ja 12345 tulee muuttaa tilinne tietoja vastaaviksi. Huomioithan mikäli teillä on DKIM-asetukset käytössä, niin tilaus-peruutussivun nimi näkyy "Asestusten" takaa kohdasta "Sivustot".

<form method="post" action="https://uutiskirje.asiakkaandomain.fi/account" class="lianamailer" id="lianamailer">
<input name="email" type="text">
<input type="hidden" name="join" value="12345">
<input value="Tilaa" type="submit">
</form>

• Form-elementissä action-kohdan verkko-osoite korvataan tilin tilaussivun osoitteella.
• Sähköpostin name-kentän arvo vaihtelee tilaus- ja peruutussivun kielen mukaan, vaihtoehdot lomakkeen alapuolella.
• Piilotetun input-elementin value-kentän arvona tulee olla joko listan id (numerosarja, joka löytyy ko. listan muokkaussivulla osoiteriviltä, osoitteen lopusta) tai nimi ja listan tulee olla tilattavissa (ohje lomakkeen alapuolella).
• Lomakkeen sisältävän sivun pitäisi käyttää utf8-merkistökoodausta.
• Jos tilillä on tilattavissa useita listoja, tulee listan name-kentän arvona olla "join[]". Mikäli listoja on tilattavana vain yksi, arvona voi olla "join".
• Success_url ja failure_url käyttäjän sivustolle takaisinpaluuta varten (Kiitos-sivu ja epäonnistui -sivu).

Suostumuksen lisääminen upotuskoodiin
Suostumus pitää olla määritettynä tilaussivulle. Täältä löydät ohjeen sen tekemiseen.

• Tilaussivun asetuksista löydät sivukohtaisen upotuskoodin Lähetysperusteet-välilehdeltä.
• Valitse lähetysperuste ja paina Kopioi HTML-lomakkeen kenttä leikepöydälle -painiketta.
• Sivuston upotuskoodi on nyt kopioituna leikepöydällesi.

Listan tilattavuus

• Valitse kohta Listat
• Valitse lista, jonka haluat asettaa tilattavaksi
• Valitse listan tiedoista kohta "Tilattavissa sivujen kautta" ja Kyllä
• Paina Tallenna

Edistyneempi lomake, jossa valittavina useille listoille liittyminen ja sen lisäksi tallennettavia "ominaisuus"-kenttiä.

<form action="http://asiakas.mailpv.net/account" method="post">
<input type="text" name="etunimi" value=""> 
<input type="text" name="sukunimi" value="">  
<input type="text" name="sahkoposti" value="">
<input type="checkbox" name="join[]" value="Listan id"> 
<input type="checkbox" name="join[]" value="Listan id"> 
<input type="submit" value="Lähetä">
</form>

• Checkboxin value-kenttään listan nimi tai id
• Lisäkenttien (kuten "etunimi" ja "sukunimi") käyttö on mahdollista, kun järjestelmässä on tilaajille luotu tarvittavat ominaisuudet, jolloin lomake-elementin nimi vastaa järjestelmässä olevaa ominaisuutta. Lomake-elementin nimessä ominaisuudet kirjoitetaan aina pienellä ja useampiosaiset sanat tulee kirjoittaa yhteen ja ilman erikoismerkkejä. Esimerkiksi "Sukupuoli (Mies / Nainen)"-niminen ominaisuus laitettaisiin lomakkeeseen muodossa "< input type="radio" name="sukupuolimiesnainen" value="mies" checked="checked" />". Katso alta ohjeet ominaisuuksien luomiseen:

Ominaisuuksien (propertyjen) luonti

• Valitse kohta Asetukset
• Valitse välilehti Tilaajien tiedot
• Valitse kohta "Lisää uusi"
• Anna nimi avautuvaan popup ikkunaan ja paina  Lisää uusi. Tämän jälkeen ominaisuus on luotu ja voit käyttää sitä listalle liittymislomakkeessa.
   

Lomake, joka ohjaa tilaajan tietylle sivulle

<form action="http://asiakas.mailpv.net/account" method="post">
<input type="hidden" name="success_url" value="http://kiitos-sivu">
<input type="hidden" name="failure_url" value="http://virhe-sivu">
<input type="text" name="sahkoposti" value="">
<input type="checkbox" name="join[]" value="12345"> 
<input type="submit" value="Lähetä">
</form>

Tilaustoiminnallisuuden tekeminen AJAX-kutsuna
Tilauslomakkeen lähetys on mahdollista tehdä myös AJAX-kutsuna. Kutsu täytyy kohdistaa omalle tilaussivulle jossa pitää olla mukana parametrina "ajax". Esim. http://asiakas.mailpv.net/account/?ajax. Kutsuun voi liittää myös muiden ominaisuuksien tietoja, esim. etunimi, sukunimi, ikä. Mutta nämä täytyy olla LianaMailerin tilille määritelty.

Alla esimerkki jQueryllä tehdystä AJAX-kutsusta

<script>
$(function() {
    $('button.join').on('click', joinList);

    function joinList() {
        // tilaussivun osoite. Muista lisätä perään parametri 'ajax'
        var url = 'http://asiakas.mailpv.net/account/?ajax', 
        post_data = {
            // tilaajan sähköpostiosoite
            email: 'etunimi.sukunimi@domain.fi', 
            // 'Etunimi' -ominaisuuden määritys
             etunimi: 'Etunimi', 
            // Listan id-numero, jolle liittäminen tehdään. 
            join: 68,
            // Suostumus, mikäli se on sivustolle määritetty.
            consent: '123-1-fi'  /*osoitteesta <sinun_sivusto>/json näet oman sivustosi 
consentin tunnisteen*/
        };

        $.ajax({
            url: url,
            method: 'POST',
            data: post_data,
            complete: function(data) {
                
                if (data.responseJSON.success) {
                    // kutsu onnistui
                }
                else {
                    // kutsu epäonnistui.
                }
            }
        });
    }
});
</script>

<button class="join">Join</button>

AJAX-kutsu palauttaa tiedon tilauksesta JSON-muotoisena, jonka avulla käyttäjälle voidaan antaa asianmukainen ilmoitus tilauksesta.

Paluuviesti on rakenteeltaan tälläinen

{
"success":bool,
"error_key":string,
"error_msg":string
}

• success => Totuusarvo onnistuiko tilaus
• error_key => Virhekoodi
• error_msg => Virheviesti

Mukana voi tulla seuraavanlaisia virhekoodeja:

• adding-recipient-failed => Tilaajan lisäys epäonnistui
• email-already-registered => Tilaaja on jo rekisteröitynyt
• email-cannot-be-null => Sähköpostiosoite ei saa olla tyhjä
• invalid-email => Virheellinen sähköpostiosoite
• member-limit-exceeded => Tilin jäsenraja on täyttynyt
• missing-registration-fields => Pakollisia tilaustietoja puuttuu
• must-select-list => Tilaukselle ei ole valittu listaa
• no-consents-given => Tilaaja ei ole antanut suostumusta

AJAX tai tilauslomake ei paljasta, ketä on jo listalla. Kaikki sähköpostiosoitteet jotka vaikuttavat toimivilta sähköpostiosoitteilta hyväksytään ja liitetään listalle.
 

Google reCAPTCHA
Suosittelemme lisäämään lomakkeelle suojauksen lomakkeita täyttäviä robotteja vastaan. Tällainen onnistuu esimerkiksi Googlen reCAPTCHA:lla, joka mahdollistaa robotin ja oikean käyttäjän erottamisen toisistaan ilman käyttäjälle tehtäviä usein ärsyttäväksi koettuja kysymyksiä. Lue ohjeet Google reCAPTCHA-profiilin luomiseen ja avainkoodien lisäämiseen täältä. 

Kysy tarvittaessa lisätietoja tekniseltä tueltamme.