Intégrer un formulaire d'abonnement à une newsletter à une page externe

Mise à jour: 08.02.2022 Imprimer

Un formulaire d'abonnement à une newsletter peut être intégré à votre page d'accueil en plus de la page d'abonnement proprement dite. Le formulaire doit comporter au moins un champ pour l'adresse mail et le numéro d'identification de la liste à laquelle l'abonné s'inscrit.

Formulaire de base

<form method="post" action="http://customer.mailpv.net/account">
<input name="email" type="text">
<input type="hidden" name="join" value="12345">
<input value="Subscribe" type="submit">
</form>

Dans l'élément du formulaire, le mot "client" est remplacé par le nom de la page d'abonnement dans l'adresse web de la section d'action. Le nom de la page d'abonnement est visible en cliquant sur "paramètres" dans la barre de navigation principale, puis sur "sites". Ce nom peut également être vérifié dans la barre d'adresse du navigateur après avoir envoyé un aperçu et cliqué sur le lien "version web".
La valeur du champ nom de l'e-mail varie selon la langue d'abonnement et la page de désabonnement, les options se trouvent en dessous du formulaire.
Le champ de valeur d'un élément de saisie caché doit être soit un identifiant de liste (une série de chiffres qui se trouvent dans l'URL sur la page d'édition de cette liste, à la fin de l'URL), soit un nom et la liste doit être abonnée (instructions sous le formulaire). L'identifiant de la liste peut également être vu en double-cliquant sur la liste et en vérifiant dans l'onglet "informations sur la liste".
La page qui contient le formulaire doit utiliser le coding de caractères utf8.
Si le compte comporte plusieurs listes qui peuvent être souscrites, la valeur du champ du nom d'une liste doit être "join[]". S'il n'y a qu'une seule liste à souscrire, la valeur peut être "join".
Success_url et failure_url de façon à ce que l'utilisateur puisse retourner sur le site (Page de remerciement et d'échec)

Abonnement à la liste

choisissez "Listes"
choisissez la liste que vous voulez définir comme abonnable
choisissez "Peut être abonné" et "Oui" dans les informations de la liste
appuyez sur "Sauvegarder".

Un formulaire plus avancé où l'on peut choisir de joindre plusieurs listes et des champs "propriété" qui peuvent être sauvegardés.

<form action="http://customer.mailpv.net/account" method="post">
<input type="text" name="firstname" value=""> 
<input type="text" name="lastname" value="">  
<input type="text" name="email" value="">
<input type="checkbox" name="join[]" value="List id"> 
<input type="checkbox" name="join[]" value="List id"> 
<input type="submit" value="Submit">
</form>

Inscrivez le nom ou le numéro d'identification dans le champ de valeur de la case à cocher
L'utilisation de champs supplémentaires (tels que "prénom" et "nom") est possible lorsque les propriétés nécessaires ont été créées pour les abonnés dans le système et qu'ensuite le nom de l'élément de formulaire correspond à la propriété dans le système. Les propriétés du nom de l'élément de formulaire sont toujours écrites en minuscules et les mots comportant de nombreuses parties sont écrits ensemble sans caractères spéciaux. Par exemple, la propriété "Gender (Male / Female)" sera placée sur le formulaire dans le format suivant : "< input type="radio" name="gendermalefemale" value="male" checked="checked" />". Voir ci-dessous les instructions pour la création des propriétés :

Création de propriétés

choisissez "Paramètres".
sélectionnez l'onglet "Préférences"
choisissez "nouvelle propriété"
donnez un nom dans la fenêtre popup qui s'ouvre et appuyez sur "Nouvelle propriété" : vous pouvez désormais l'utiliser sur le formulaire d'abonnement.

Formulaire qui dirige l'abonné vers une certaine page

<form action="http://customer.mailpv.net/account" method="post">
<input type="hidden" name="success_url" value="http://thank-you-page">
<input type="hidden" name="failure_url" value="http://error-page">
<input type="text" name="sahkoposti" value="">
<input type="checkbox" name="join[]" value="12345"> 
<input type="submit" value="Submit">
</form>

Utilisation de la demande AJAX pour la fonction d'abonnement

L'envoi de l'abonnement peut également se faire sous forme de demande AJAX. La demande doit être destinée à votre propre page d'abonnement et le paramètre "ajax" doit être inclus. Par exemple, http://customer.maillm.net/account/?ajax. D'autres informations sur les propriétés peuvent également être incluses dans la demande, telles que le prénom, le nom de famille ou l'âge. Mais ces informations doivent être incluses dans le compte LianaMailer.

Voici un exemple d'une demande AJAX faite avec jQuery

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

    function joinList() {
        // subscription page url. Remember to add parameter 'ajax' in the end
        var url = 'http://customer.mailpv.net/account/?ajax', 
        post_data = {
            // email of the subscriber
            email: ’[email protected]', 
            // Defining the property ’Firstname’
             firstname: ’Firstname’, 
            // List id where the subscriber is added to 
            join: 68,
            // Consent value if it is set on the subscription page
            consent: '123-1-en'
        };

        $.ajax({
            url: url,
            method: 'POST',
            data: post_data,
            complete: function(data) {
                
                if (data.responseJSON.success) {
                    // request was successful
                }
                else {
                    // request was not successful
                }
            }
        });
    }
});
</script>

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

La demande AJAX renvoie les informations sur l'abonnement au format JSON, ce qui permet de donner à l'utilisateur une notification correcte sur l'abonnement.

La structure du message de réponse est la suivante

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

success => (Bool) true on successful subscription
error_key => Error code
error_msg => Error message
account_url => The address for the subscriber data that allows modification of the subscription with LianaMailer subscription form, for example. "account/1-124391e7fea644b4c32b565d58664c79"

Les codes d'erreur suivants pourraient être inclus :

adding-recipient-failed => L'ajout d'un abonné a échoué
email-already-registered => L'abonné s'est déjà inscrit
email-cannot-be-null => Le champ de l'adresse email ne peut pas être vide
invalid-email => Adresse email erronée
member-limit-exceeded => La limite de membres du compte a été dépassée.
missing-registration-fields => Les données d'abonnement requises sont manquantes
must-select-list => Aucune liste n'a été sélectionnée pour l'abonnement

AJAX ou le formulaire d'abonnement ne révèlent pas qui est déjà sur la liste. Toutes les adresses mail qui semblent être valides sont acceptées et ajoutées à la liste.

Google reCAPTCHA
Nous vous recommandons de protéger vos formulaires contre les robots qui les remplissent. Cela peut être effectué avec Google's reCAPTCHA, par exemple,qui permet de distinguer un robot et un utilisateur réel sans les questions que l'utilisateur trouve souvent désagréables.

Lisez les instructions de Google sur la façon de générer le champ reCAPTCHA ici.

Si nécessaire, n'hésitez pas à contacer notre équipe support pour plus d'informations.

Sur cette page:

Tags:

adding-recipient-failed ajax créer des fonctionnalités email-already-registered email-cannot-be-null failure_url form from google recaptcha input invalid-email member-limit-exceeded missing-registration-fields must-select-list possibilité d'abonnement à la liste property recaptcha succes_url utf8