HighPush. document /06/2009 Révision pour version /11/2008 Revision pour la /10/2008 Documentation initiale.

Transcription

1 Version du Date document /06/2009 Révision pour version /11/2008 Revision pour la /10/2008 Documentation initiale Commentaires 1

2 Table des matières 1 Introduction / Identification Gestion des campagnes Création de campagne Nommage de la campagne Utilisation d une campagne précédente comme modèle Options avancées Gestion des listes d envoi Contenu du message Programmation de l envoi (planification, interruption, fréquence) Validation finale / Filtre par opérateur Liste des campagnes Actions sur les campagnes à venir Actions sur les campagnes en cours Gestion des modèles Envoi «unitaire» de SMS Statistiques Envoi Automatique...17 Liste des campagnes...17 Statistiques générales...18 Export des statistiques...19 Export PDF Gestion des contacts Modification d une liste existante...21 Suppression d une liste de contacts...21 Ajout d une liste de contacts Import d un fichier CSV Import d un fichier texte Fusion de listes...24 Gestion de la blacklist

3 1 Introduction / Identification HighPush est une solution qui vous permet facilement de gérer vos campagnes de push SMS. Une fois votre compte ouvert un login (votre adresse par exemple) et un mot de passe vous sont attribués. L envoi de fichier XML est destiné aux utilisateurs utilisant l API de push SMS (Envoi de SMS piloté par une application). Une documentation annexe précise les modalités d emploi de cette API. L identification vous permet de vous connecter à l application. L écran d accueil vous donne accès aux 5 rubriques du service. 3

4 A la connexion au service, vous êtes directement dans la gestion des campagnes, à l onglet de visualisation des campagnes en cours. Les autres rubriques permettent d envoyer unitairement des s (sans passer par les listes de diffusion), de visualiser les statistiques, de gérer vos listes de diffusion («Contacts») et de créer une page Internet Mobile(«WAP») sur lequel vous pourrez faire une campagne de Push SMS. 4

5 2 Gestion des campagnes 1.1 Création de campagne Nommage de la campagne Le logiciel vous guide pas à pas dans la création de votre campagne de push SMS. Le premier écran vous invite à nommer votre campagne (un nom vous est proposé basé sur la date du jour) Utilisation d une campagne précédente comme modèle Il est possible d utiliser une campagne précédente comme modèle, auquel cas les paramètres tels que les textes de message, le type de message seront pré-remplis avec les valeurs utilisées précédemment. A la selection du lien une liste apparaît qui vous permet de choisir une des campagens précédentes. 5

6 1.1.3.Options avancées Expéditeur Le «numéro apparaissant comme expéditeur» n est pas géré par tous les routeurs. Seule la route Silver avec l option spécifique «Affichage de l émetteur» peut garantir que l émeteur est bien transmis. L émétteur peut être soit un numéro de téléphone soit une chaîne de caractères classiques «HIGHCONNEXON» par exemple Stockage du SMS Le SMS peut être soit «Stocké dans la mémoire du mobile» (SMS classique) soit flash. Dans ce cas, le texte complet apparaît directement sur le mobile mais il n est pas sauvegardé après lecture Données utilisateurs Les données utilisateurs permettent un suivi statistique détaillé. Cette donnée apparaît dans le détail SMS par SMS et permet un regroupement de plusieurs campagnes. 6

7 1.1.4.Gestion des listes d envoi Sélection des listes Les listes de contacts déjà utilisées apparaissent dans la liste de gauche. «Sélectionner» permet de les faire passer à droite, dans la liste utilisée pour cet envoi. «Effacer» permet de désélectionner un élément de la liste d envoi à droite «Créer une nouvelle liste de contacts» permet de charger un fichier depuis votre ordinateur ou de fusionner des listes existantes (voir la documentation dans le module gestion de contacts). «Visualiser» permet de voir le contenu de la liste. 7

8 Filtrage d après des campagnes précédentes Pour éviter d'envoyer plusieurs fois des messages similaires aux mêmes contacts, vous pouvez exclure de votre envoi les destinataires de campagnes précédentes en utilisant le bouton «Filtrer par une campagne précédente» Affichage de la synthèse L utilisation du bouton «Synthèse» permet d afficher le nombre final de destinataires une fois la/les listes dé-doublonnées et les blacklistes filtrées 8

9 1.1.5.Contenu du message Saisie du message Cet écran vous permet de saisir le texte du SMS à envoyer Utilisation des modèles Cette zone de l écran vous permet de gérer vos modèles. Un modèle est simplement un texte de message sauvegardé et nommé. Le rappel d un modèle existant remplit la zone texte de message. 9

10 A tout moment le lien «Sauvegarder en tant que modèle» permet de mémoriser le message en cours Utilisation des variables Pour intégrer des champs de liste de contact il suffit de cliquer sur les boutons construits dynamiquement. Dans notre exemple nous avons cliqué sur «LASTNAME» pour générer dans le texte du sujet «%LASTNAME%» qui sera remplacé à l envoi par le contenu de la colonne LASTNAME de notre liste de contacts. Le champ numérique a côté du champ est la longueur maximale détectée dans les contacts prévus Calcul de la taille du message / troncature La longueur du message (et si il donnera lieu à l envoi de plusieurs SMS) est calculée automatiquement. Dans le cas des variables la taille maximum de la variable est prise en compte. Si la taille peut-être supérieure à 160 caractères le lien «gérer les troncatures» apparaît. La Gestion des troncatures permet choisir les champs à ne pas tronquer (PRENOM dans notre exemple) et ceux à tronquer (avec gestion de priorité). Dans le cas où un champ doit être tronqué, on peut sélectionner les caractères à placer en fin de champ pour indiquer que le champ a été tronqué («..» par défaut). 10

11 1.1.6.Programmation de l envoi (planification, interruption, fréquence) Cet écran permet de valider votre campagne de Push et de la planifier. Pour valider votre campagne vous pouvez vous envoyer le message : - le numéro préconfiguré est votre numéro, associé à votre compte utilisateur, mais vous pouvez saisir d autres numéros. - Les variables sont instanciées avec le premier contact de la liste de diffusion, afin d avoir une vision réaliste du texte du message. Vous pouvez également vous inclure dans l envoi en début et en fin d envoi afin de suivre le démarrage et la fin de l envoi, que ce soit un envoi immédiat ou différé. Au niveau des dates d envoi, la date de début est préconfigurée à la date et heure du jour (envoi immédiat). Un créneau horaire est également défini. Les SMS ne seront pas transmis aux opérateurs en dehors de ces périodes c'est-à-dire que l envoi est suspendu (manuellement ou parce que tous les SMS n ont pas été transmis à la fin du créneau horaire), lorsqu elle redémarrera le lendemain ce sera en début de créneau horaire. Un autre point de configuration est la fréquence d envoi. Par défaut on utilise la fréquence maximale. On peut cependant limiter la vitesse, notamment pour s adapter aux capacités d accueil du service promu. 11

12 Il est fin possible de programmer une interruption dans l envoi de message. Interruption au bout d un certain nombre de message. Cela couvre le besoin fonctionnel d un envoi en grand nombre, dont on désire contrôler le rendu en début d envoi avant d engager complètement tout l envoi, ceci sans avoir à découper la liste de diffusion en morceaux. Interruption à un moment donné. Il est possible de fragmenter l envoi : - Un nombre de messages - Avec un critère de tri Il est également possible, d arrêter l envoi à une certaine heure (besoin de couverture évènementielle). Attention, on ne peut que contrôler l heure de soumission du SMS à l opérateur ou au facilitateur. Si il n y a pas de restriction de débit (fréquence maximale) il est fort probable que tous les SMS seront soumis AVANT l heure limite mais envoyés, dépendamment des capacités de l opérateur, APRES cette heure. 12

13 1.1.7.Validation finale / Filtre par opérateur Le bouton «valider» programme la campagne. Sans appui sur ce bouton la campagne restera «en test» et sera encore modifiable. Par défaut le message est envoyé à tous les opérateurs, mais il est possible en validation finale de restreindre l envoi par opérateurs. Cette fonctionnalité peut être utile dans certains cas particuliers où le service promu n est accessible que par certains opérateurs. 13

14 1.2 Liste des campagnes Actions sur les campagnes à venir La sélection de «liste de campagne» depuis le module de création de campagne permet d afficher la liste des campagnes en cours (les campagnes terminées ne sont accessibles que depuis le module statistique). Une campagne apparaît «En test» tant que sa date de programmation n a pas été validée. Après validation sur l écran final (voir 1.1.6), elle passe alors à «Programmée» La recherche par nom s effectue selon le critère «contient la chaîne de caractères» La recherche pas date permet de filtrer selon le critère «à partir de» permet de lancer la campagne (si son paramétrage est complet), c est l équivalent du «valider» final dans l écran de création de campagne. permet d éditer à la campagne (les fonctionnalités sont alors les mêmes qu en création). Dans le cas où la campagne est déjà programmée un message vous invite à suspendre la programmation avant de passer en mode modification. L action est la même qu avec le clic sur le nom de la campagne. permet de supprimer une campagne, après confirmation Actions sur les campagnes en cours Quand une campagne est en cours d émission, il est possible de la mettre en pause en utilisant l icône L affichage devient alors celui-ci, et permet de redémarrer la campagne. 14

15 Dans les 2 cas permet d arrêter la campagne. 1.3 Gestion des modèles Les modèles sont des textes de messages nommés, que l on peut utiliser lors de la création de campagnes. Le clic sur «Modèles SMS» fait apparaître l écran suivant avec la liste des modèles déjà sauvegardés. permet de créer un nouveau modèle, la création pouvant être gérée lors de la saisie du texte d un message affiche la liste des modèles créés édite un modèle Supprime le modèle 15

16 3 Envoi «unitaire» de SMS Ce module permet simplement d envoyer des SMS, à une (petite) liste de destinataires, sans gestion de listes de diffusion. Son principal intérêt est de tester le temps de réponse des passerelles. 16

17 4 Statistiques Envoi Automatique Cet onglet permet de suivre les SMS envoyés en utilisant l API de communication d application à application. Liste des campagnes Dans ce module seules les campagnes dont l envoi a commencé apparaissent. 17

18 Pour sélectionner dans la liste vous pouvez filtrer par nom de campagne ou par date. Les campagnes s affichant naturellement par ordre chronologique inverse (les plus récentes en premier). Les couleurs indiquent le pourcentage de : - SENT : Envoyé à l opérateur mais pas d accusé de réception reçu (doit rester marginal au bout de 24h temps au bout duquel on a demandé à l opérateur ne plus soumettre le SMS) - ERROR : Accusé de réception négatif reçu de l opérateur - RECEIVED : Accusé de réception positif reçu de l opérateur. Statistiques générales Sur un écran sont présentées les principales informations sur la campagne : - Nombre total de SMS envoyés et la répartition entre les lus et non lus - La ou les listes de contacts utilisées pour l envoi - La répartition par opérateur 18

19 - La date de début et de fin d envoi - Le nombre de NPAI Les NPAI sont les «N habite Plus à l Adresse Indiquée», autrement dit des numéros qui ne sont plus affectés. L appui sur le lien permet de les rajouter à votre blackliste. Un clic sur le nom de la liste permet de visualiser le détail : Export des statistiques Cette fonctionnalité vous permet de récupérer l information brute associée de la campagne afin de l intégrer dans votre système d information ou sous votre tableur préféré pour faire graphiques personnalisés. Le format utilisé est CSV, chaque champ étant séparé par le caractère «;» Les colonnes sont : - Nom de la campagne - Nom d utilisateur (votre login) - Le numéro de téléphone du destinataire - Le code opérateur (20801=ORANGE, 20810=SFR ; 20820=BOUYGUES) - Le texte du message - La date et heure d envoi (format AAAA-MM-JJ HH :MM :SS) - Le statut du message (RECEIVED/SENT/ERROR) - La «donnée utilisateur» utilisée pour l envoi de ce SMS - Le code associé à l erreur, le plus courant étant EXPIRED qui indique que l opérateur n a pas pu acheminer le SMS 19

20 Export PDF Cet écran reprend exactement les informations présentées dans l écran «Statistiques générales» mais sous forme d un document PDF. Vous pouvez ainsi l enregistrer et le communiquer par le mail sans donner accès à votre compte. 20

21 5 Gestion des contacts Ce module vous permet de gérer vos listes de contacts, utilisées pour l envoi des SMS. Les fonctions principales sont le téléchargement de vos fichiers d adresse depuis votre ordinateur vers le serveur d envoi, le dé-doublonnage de fichiers, la gestion des blacklists. Modification d une liste existante L appui sur la small-icon permet de modifier une liste existante. Par défaut l interface affiche la liste de tous les contacts de la liste de diffusion (un système de pagination permet de les afficher par groupe de 20). On peut restreindre la liste en rentrant une partie du numéro de téléphone recherché. Par exemple «0630» pour avoir tous les téléphones commençant par permet de mettre le numéro en blackliste. permet de l éditer. Supprime le contact. Suppression d une liste de contacts à partir de la liste des contacts, supprime, après confirmation, la liste. Ajout d une liste de contacts 21

22 Il y a deux types de fichiers importés correspondant à des emplois distincts : - Format CSV qui est de l export text, d un tableur à raison de un contact par ligne, avec un séparateur. La première ligne doit comporter le nom des champs. Ce format sert à manipuler les sources d informations issues de base de données. Si le fichier comporte plusieurs colonnes elles pourront être utilisées pour la personnalisation du SMS. - Format Texte. Le fichier est lu et tous les séquences de 10 chiffres commençant par 06 sont considérées comme des numéros de téléphones. Ce format est utilisé pour traiter notamment les pages «détails de connexion» des statistiques Audiotel. Par cette alimentation, il n y a pas de personnalisation avec des champs dynamiques possible, la seule donnée connue étant le numéro de mobile. Le bouton «Parcourir» permet de sélectionner le fichier et «importer» lance l interprétation du fichier. La saisie d un nom de liste de contact est obligatoire 22

23 4.1.1 Import d un fichier CSV Le fichier suivant Terminé le;id;name;lastname;mobile; ;flag;reglement;tag 07/04/ :26; ;Dupont;Daniel; ;jpcognet@9online.fr;;on;sms 07/04/ :55; ;Evangelysta;andré; ;jpcognet@abysse.net;on;on;pub 07/04/ :06; ;Magda ;Saeedi; ;;;on;pub 07/04/ :20; ;Patricia;Lacques; ;;on;on;pub 07/04/ :27; ;Samuel;Plumereau; ;;on;on;pub Est importé comme suit Le programme recherche automatiquement le séparateur utilisé ( ;, tabulation ou ).En cas d erreur vous pouvez intervenir manuellement. De même il recherche la colonne contenant le champ numéro de portable, mais vous pouvez intervenir en cas d erreur. La première ligne du fichier text doit contenir le nom des champs. Ce nom est traduit en majuscule afin d être utilisé dynamiquement dans le contenu du mail. Seules les lignes comportant un portable valide seront considérées. Dans le cas général on n importe pas les numéros déjà blacklistés Import d un fichier texte Soit la page HTML suivante Qui donne le code source suivant 23

24 <html> <body> <table border=1> <tr><td>num</td><td>temps</td></tr> <tr><td> </td><td>9:21</td></tr> <tr><td> </td><td>9:45</td></tr> <tr><td> </td><td>4:50</td></tr> <tr><td> </td><td>3:12</td></tr> </table> </body> </html> Est importé en utilisant le masque d import suivant Selon les cas on peut utiliser des cas avec séparateurs différents Fusion de listes Faire glisser les listes source de la gauche vers la droite avec l action «ajouter» et valider avec le bouton «Créer une nouvelle liste» sans oublier de saisir le nom destination 24

25 Un aperçu de la fusion avec les champs disponibles pour la personnalisation est affiché. La possibilité d effacer les listes source est également proposée. Par exemple pour utiliser une seule liste contacts «fusion», alimentée mensuellement : - Vous créez chaque mois votre liste «moiscourant» avec le fichier des nouveaux numéros - Vous fusionnez votre liste «moiscourant» et «fusion» avec comme nom cible fusion - Vous sauvegardez avec l option «Effacer la liste source» Gestion de la blacklist La blacklist correspond aux numéros reconnus comme invalide, parce qu ils ne répondent pas ou que l utilisateur a demandé la désinscription. 25

26 Sur ce module, on peut - ajouter (ou enlever) des adresses blacklistés à partir d un fichier. Le format du fichier est simplement un fichier texte avec simplement le numéro sur la ligne. - ajouter manuellement un numéro - Rechercher et supprimer (donc «autoriser» à nouveau) manuellement une adresse (la recherche se fait sur une partie de l adresse numéro) - Exporter au format CSV la liste des blacklistés - Enlever de la blacklist Si le numéro est soumis à nouveau dans une nouvelle liste, il ne sera plus considéré comme invalide. Cependant si le numéro est présent en tant que blacklisté dans une liste il restera blacklisté. Le but est d accepter la soumission du numéro à nouveau (pour la cas où il a été réattribué) pas de renvoyer des SMSs à des numéros identifiés comme erronés. 26