Suivi des messages |
Le message a t'il été traité et envoyé ? quel est son état de livraison ?
L'envoi des messages se fait de manière asynchrone. Le temps de traitement
pourra varier selon le volume de messages, la fréquence, et le poids de ces messages.
De plus l'état de livraison d'un message est mis à jour au fur et à mesure des remontées
d'informations SMTP des serveurs distants.
Un message peut être pendant plusieurs dizaines de minutes en état SoftBounce (erreur
temporaire) à cause d'une mise en attente du serveur SMTP distant. Ce même message peut ensuite être accepté 2 heures plus tard par le serveur distant, son statut passera à Delivered.
On peut considérer qu'au bout de 24h, le message ne changera plus d'état.
Pour chaque tentative d'envoi au delà de quota d'appels, une erreur est levée par web service :
Pour vérifier l'état d'un message, utilisez la méthode
GetMessageDeliveryStatusByTicket
Cette méthode renvoie l'état de livraison du message.
Les statuts possibles :
Pending : En attente d'envoi (le message est encore sur le serveur EMT et va bientôt être envoyé)
InProgress : En cours de diffusion (le message a été envoyé, mais nous n'avons pas encore eut de réponse du serveur SMTP distant)
Delivered : Abouti ( confirmation de livraison SMTP du message)
SoftBounce : en erreur temporaire (boite pleine, greylisting, serveur indisponible temporairement etc ...)
Hardbounce : en erreur définitive (destinataire inexistant)
Error : en erreur, ne sera pas envoyé
Complaint : une plainte pour SPAM a été déposée
Stop : une demande de désabonnement a été déposée
|
Suivre l'activité d'un message
Pour accéder aux informations d'activité du message, c'est à dire aux clics et aux ouvertures, vous avez 2 possibilités :
La méthode GetMessageActivityStatusByTicket qui indique uniquement si le message a été ouvert ou cliqué
La méthode GetMessageStatusByTicket qui indique si le message a été ouvert ou cliqué et peut également renvoyer la liste détaillées des clics et des ouvertures
|
Suivi des plaintes et désabonnement
Nous vous conseillons de récupérer régulièrement la liste des plaintes et désabonnement pour mettre à jour votre système d'information.
Les méthodes GetComplaintRecipientList et GetStopRecipientList renvoient
respectivement la liste complète des emails distincts ayant déposés une plainte
ou ayant fait une demande de désabonnement.
Les méthodes GetComplaintRecipientListByTemplateID et GetStopRecipientListByTemplateID
renvoient les même informations mais par Template et de date à date.
Si vous ne remontez pas ces informations dans votre SI, un filtrage empêchera le
renvoi à une personne ayant déposée une plainte ou étant désabonnée.
L'envoi sera refusé lors de l'appel à SendMessage
|
Récupérer la liste des tickets
La méthode GetMessageTicketListByTemplateID
renvoie une liste des tickets de messages pour un status et un intérval de dates
données.
Les types de statistiques (paramètre statisticType) possibles sont :
Sent: messages envoyés
Delivered: messages aboutis
WaitingSent: messages en attente
SoftBounced: messages en erreur temporaire
HardBounced: messages en erreur définitive
Opened: messages ouverts
Clicked: messages cliqués
Complaint: messages ayant provoqué une plainte
Stop: messages ayant provoqué un désabonnement
Error: Messages en erreur
Deux types d'intervalle(paramètre intervalType) de dates peuvent être utilisés pour la requête
Sent: la recherche sera effectué sur les dates d'envoi des messages
Event: la recherche sera effectué sur les dates d'évennement demandé (les dates de click, d'ouverture, de plainte etc.)
Cette méthode est plus pertinente, plus efficace et génère moins de dialogues inutiles avec le webservice
|