Comment gérer les newsletters ?

À quoi ça sert ?

À partir de l’admin des newsletters, vous pouvez : 

1. Créer une nouvelle newsletter
2. Modifier le template d’une newsletter
3. Modifier les options d’envoi d’une newsletter
4. Sélectionner les sources d’information d’une newsletter automatique

Accéder à l'admin des newsletters ?

Vous devez avoir la permission "newsletters:full" puis : 

1. Cliquer sur "Administration" dans le menu de gauche
2. Cliquer sur "Newsletters"

Comment configurer une newsletter ?

L’admin des Newsletters s’ouvre sur la liste des Newsletters. Cliquer sur une newsletter pour éditer son contenu ou ses options d’envoi. Le formulaire est composé de 2 onglets “Configuration” et "Éditeur" dont le fonctionnement sont décris ci-dessous : 

Onglet "Configuration" 

Dans cet onglet, vous pouvez configurer les options relatifs à l’envoi de la newsletter. Vous trouverez ci-dessous le descriptif des différents champs :

Paramètres Généraux

• Nom de la newsletter : Nom de la newsletter visible dans Sirius
  

• Champs d'appel spécifiques : Lorsque cette option est activée, les utilisateurs peuvent modifier la titraille (titre et chapô) des articles embarqués dans une édition de newsletters 

• Activation :
• • Dans le cas d'une newsletter automatique : 
    • Cochée : La newsletter sera envoyé automatiquement 
    • Décochée : La newsletter ne sera pas envoyée
  • Dans le cas d'une newsletter manuelle :
    • Cochée : La newsletter apparaîtra dans la liste des publications
    • Décochée : La newsletter n’apparaîtra pas dans la liste des publications
      
      
• Version d'API : La v1 a été conçue lorsque l'API Sirius GraphQL n'existait pas. Aujourd'hui, il est plus facile pour un développeur d'utiliser la même API partout. Sirius GraphQL Newsletter API v2 est une extension de Sirius GraphQL API. Cela signifie que tout ce qui est accessible sur l'API Sirius GraphQL est accessible.

• Slug : Identifiant unique utilisé dans les exports et la génération des URLs
  
  
• Sujet : Sujet de la newsletter tel qu'il apparaît dans la boite e-mail des destinataires. Il est possible d’utiliser du JavaScript et des données dans le titre, exemple : "${articles[0].title}".
  Attention, une erreur de code ou une variable undefined interrompra l’envoi de la Newsletter, par exemple : "${articles[200].title}" renverra l’erreur suivante lors de l’envoi “Can’t access title of undefined”.
  
  
• Email de l'expéditeur : Utilisée uniquement en “reply to”.
  
  
• Nom de l'expéditeur : Le nom de l’expéditeur de l’e-mail.
  
  

• Mode :
  • Automatique : La newsletter partira automatiquement avec le contenu et la fréquence configurés.  La fréquence d’envoi est définie par le champ CRON. Le cron configure la fréquence d’envoie de la newsletter. Vous pouvez convertir la fréquence souhaitée en CRON sur le site suivant : https://crontab.guru/. Le contenu de la newsletter est lui récupéré de plusieurs rubriques définies dans l'onglet Éditeur.
  • Manuel : Les newsletter sont créées, peuplées et envoyées manuellement par un éditeur via le panneau de publication de Sirius.
    
    
• Autoriser l’envoi sur une alerte : cocher la case configurer l’envoi de la newsletter suite à la publication d’une alerte.
  
  
• [mode automatique uniquement] Envoyer en privé : Permet d’envoyer la newsletter sur le filtre privé. Attention, la newsletter sera réellement envoyée.
  
  
• [mode automatique uniquement] Envoyer en public : Permet d’envoyer la newsletter sur le filtre public. Attention, la newsletter sera réellement envoyée.

Paramètres du routeur "Cheetah" ou "Selligent"

L’envoi des Newsletters est réalisé par service tiers. Sirius supporte l'envoi de newsletters via "Cheetah" ou "Selligent". Pour utiliser ces services, un certain nombre d’informations doivent être configurées.

En premier lieu, vous devez configurer une intégration "Cheetah" ou "Selligent" dans l’admin des intégrations (cf. admin des intégrations). Une fois configuré, lors de la création d’une Newsletter, il vous sera demandé de choisir via quel service la Newsletter devra être envoyée.

Champs à configurer pour “Cheetah”

• Adresse : Adresse e-mail de l’expéditeur. Les différents choix sont à configurer directement sur Cheetah.

• Table

• Champs d’adresse de l’expéditeur

• Dossier : Dossier dans lequel la campagne est stockée sur Cheetah.

• Nom de la campagne : Nom de la campagne sur Cheetah. Cette identifiant doit être unique pour chaque campagne. Nous utilisons toujours le même template par défaut : "NL_${metadata.date}_${metadata.provider.filter.display_name}_${metadata.environment}".
  
  
• Filtre privé : Nom de la liste des utilisateurs (ie. segment) qui recevront la newsletter lors d’un export privé. Les listes sont configurables sur Cheetah directement.
  
  
• Filtre public : Nom de la liste des utilisateurs (ie. segment) qui recevront la newsletter lors d’un export public. Les listes sont configurables sur Cheetah directement.

Champs à configurer pour “Selligent”

• Domaine de l'e-mail : Adresse e-mail de l’expéditeur. Les différents choix sont à configurer directement sur Selligent.

• Dossier : Identifiant (nombre) dans lequel la campagne est stockée sur Selligent.
  
  
• Nom de la campagne :  Nom de la campagne sur Cheetah. Cet identifiant doit être unique pour chaque campagne. Il est possible d’utiliser du JavaScript et des données. Par défaut : "NL_${metadata.date}_${metadata.provider.filter.display_name}_${metadata.environment}"
  
  
• Preheader : extrait de texte qui sera visible dans la boîte e-mail des destinataires. Il est possible d’utiliser du JavaScript et des données.

• Audience :

• Segment privé : Nom de la liste des utilisateurs (ie. segment) qui recevront la newsletter lors d’un export privé. Les listes sont configurables sur Selligent directement.
• Segment public : Nom de la liste des utilisateurs (ie. segment) qui recevront la newsletter lors d’un export public. Les listes sont configurables sur Selligent directement.
• Filtre sur l’audience 
• Tags

• Campaign Analytics Tag : “tag” collé à la fin de chaque lien de la newsletter pour, utilisés tracer les clics.

• Message Analytics Tag

Onglet "Editeur" 

Dans cet onglet, vous pouvez définir le template d’une newsletter et choisir le contenu des newsletters automatiques.

Cet volet se compose des zones suivantes : 

Zone : Data (GraphQL)

Dans cette zone, vous pouvez définir quels sont les informations à récupérer de Sirius : les articles, les rubriques, les images… ainsi que les informations relatives à l’envoi : la date, l’environnement, le routeur utilisé pour l’envoi… Du GraphQL est attendu dans cette zone pour récupérer la donnée.

 

Zone : Template (Handlebars)

Dans cette zone, vous pouvez configurer le template d’une newsletter en vous appuyant sur du Handlebars (voir https://handlebarsjs.com/) dans lequel il est possible d’interpoler des données récupérées dans la zone Data.

C'est dans cette zone que vous pouvez appeler les slugs des blocs précédemment créés depuis la page Administration > Newsletters > Blocs de newsletters. Une fois appelé, le bloc (s'il est activé) doit s'afficher dans la fenêtre de prévisualisation à droite de la page. Si je le supprime, la prévisualisation se met à jour et ne l'affiche plus.

Si j'enregistre un template qui n'est pas valide, par exemple avec un bloc désactivé, la prévisualisation doit renvoyer une erreur (dragon vert et description de l’erreur).

📌 pour modifier un bloc, vous pouvez maintenant le faire depuis l'administration, les modifications apportées se répercuteront à tous les endroits où le bloc est appelé !

 

Zone : Helpers (JavaScript)

Dans cette zone, vous pouvez configurer définir des objet et fonctions JavaScript utilisables dans le template Handlebars. Il est notamment possible de définir des variables utilisées plusieurs fois dans le template.

Zone : Prévisualisation

Dans cette zone, il vous est possible d’avoir un aperçu de la newsletter en cours de construction. Chaque modification d’une des zones précédentes entraînera un rafraichissement de la prévisualisation. Il est possible d’avoir une prévisualisation desktop ou mobile en cliquant sur les boutons correspondants.

Zone : Data

Dans cette zone, vous pouvez lire la liste des données récupérées dans la zone “Data (GraphQL)”

 

CA1. quand je suis dans mon éditeur de newsletter, je dois pouvoir appeler un bloc déjà créé dans l’administration

-> outes modification est bien visible dans les NL qui appellent le bloc

CA2. une fois appelé, je dois pouvoir le visualiser dans l’onglet de prévisualisation à droite de la page

si je le supprime de l'éditeur, la prévisualisation doit se mettre à jour et ne plus l’afficher

CA3. pour les erreurs, on garde le comportement actuel → si j’enregistre un template qui n’est pas valide, alors ça s’enregistre bien et je dois voir un écran d’erreur (dragon vert et description de l’erreur) dans la prévisualisation

 

Comment sauvegarder et publier mes modifications ?

Les modifications de configuration (Paramètres et Éditeurs) sont sauvegardées automatiquement. Un indicateur en haut à droite de l’écran vous informe sur la date de dernier enregistrement. Néanmoins, vous pouvez forcer l’enregistrement en cliquant sur le bouton “Enregistrer”.

Lorsque que vous êtes satisfait de vos changements, vous pouvez les publier via le bouton "Publier" en haut à droite. Vos changements seront alors appliqués pour les prochains envois de la newsletter.