Statistiques
Des statistiques de livraison quelques secondes après chaque événement, dans le tableau de bord et via GET /emails/metrics.
Chaque résultat (remis, rebond, plainte, ouverture, clic, désinscription) est comptabilisé quelques secondes après qu’il se produit. La page Statistiques du tableau de bord et GET /emails/metrics lisent les mêmes chiffres.
Dans le tableau de bord, Statistiques affiche les taux de livraison, d’ouverture, de clic, de rebond et de plainte, ainsi qu’un graphique des événements par heure. Vous pouvez filtrer par période (7, 15 ou 30 jours), fuseau horaire, marque (domaine d’envoi), campagne et domaine du destinataire.
Les statistiques sont conservées par heure pendant 13 mois. L’historique propre à une campagne n’est pas tronqué à 13 mois. Si le service de statistiques ne répond pas, l’endpoint renvoie 503 service_unavailable et l’envoi n’est pas affecté. Les listes d’e-mails, les exports et les événements d’un e-mail ne sont pas des statistiques ; voir Journaux.
Demander des chiffres
GET /emails/metrics exige une clé API à accès complet. Les SDK l’appellent emails.metrics().
curl "https://api.billionsend.com/emails/metrics?start_date=2026-11-01&end_date=2026-11-14&granularity=daily&metrics=sent&metrics=delivered&metrics=open_rate&dimensions=period" \
-H "Authorization: Bearer bs_..."
| Paramètre | Rôle |
|---|---|
start_date, end_date |
La période. Les statistiques sont lues par heures UTC entières, et la réponse indique le début réellement utilisé. |
timezone |
Un nom de fuseau IANA comme Europe/Berlin (un décalage UTC comme +05:00 n’est pas accepté). Les périodes sont découpées dans ce fuseau. |
granularity |
hourly, daily, weekly ou monthly : la taille d’une période lorsque dimensions inclut period. Une plage peut couvrir au plus 10 000 périodes. |
metrics |
Répétez-le pour chaque métrique souhaitée (voir ci-dessous). |
dimensions |
Répétez-le pour chaque ventilation : period, domain, email ou broadcast. email et broadcast ne peuvent pas être combinés. |
domain_id, email_id, broadcast_id |
Filtres. Répétez chacun jusqu’à 100 fois. |
La réponse contient totals pour toute la plage et, si vous demandez des dimensions, une ligne par combinaison dans data.
Métriques
| Métrique | Compte |
|---|---|
received |
Les destinataires acceptés pour l’envoi. Elle n’appartient à aucun domaine, campagne ou e-mail : une réponse filtrée ou ventilée par l’un d’eux l’exclut. |
sent, delivered, delivery_delayed, failed, suppressed |
Les destinataires, selon le résultat de l’envoi. |
bounced, bounced_permanent, bounced_transient, bounced_undetermined |
Les rebonds et les trois classes de rebond. |
complained, unsubscribed |
Les plaintes pour spam, et les destinataires qui se sont désinscrits par le lien de désinscription. |
opened, clicked |
Chaque ouverture et chaque clic. |
unique_opened, unique_clicked |
Les e-mails ouverts ou cliqués au moins une fois. |
delivery_rate |
delivered ÷ sent |
bounce_rate |
bounced ÷ sent |
open_rate, click_rate |
unique_opened ou unique_clicked ÷ delivered |
complaint_rate, unsubscribe_rate |
complained ou unsubscribed ÷ delivered |
Les taux sont des pourcentages avec une décimale, et valent 0 quand il n’y a rien à diviser. Les ouvertures et les clics faits par des machines, comme les proxys de confidentialité et les scanners de sécurité, ne sont pas comptés comme des ouvertures ou des clics.
Avec la dimension email et sans email_id, la réponse liste jusqu’à 1 000 e-mails créés dans la plage.
Clics par lien
GET /emails/metrics/links (une extension de BillionSend, clé à accès complet) liste les liens sur lesquels des personnes ont cliqué pendant une plage, du plus cliqué au moins cliqué :
curl "https://api.billionsend.com/emails/metrics/links?start_date=2026-11-01&end_date=2026-11-14&limit=10" \
-H "Authorization: Bearer bs_..."
{
"object": "list",
"start_date": "2026-11-01T00:00:00.000Z",
"end_date": "2026-11-14T23:59:59.999Z",
"has_more": false,
"data": [
{ "link": "https://shop.example.com/sale", "clicked": 412, "bot_clicked": 37 }
]
}
- Un lien est compté par son schéma, son hôte et son chemin. La chaîne de requête et le fragment sont écartés : un lien personnalisé pour chaque destinataire forme donc une seule ligne, et aucune donnée d’un destinataire n’est stockée.
clickedcompte les personnes ;bot_clickedcompte les requêtes de machines comme les scanners de sécurité et les aperçus de liens.- Il accepte
start_date,end_date,domain_id,broadcast_id(séparés par des virgules) etlimit(de 1 à 100, 20 par défaut), et couvre des heures UTC entières commeGET /emails/metrics. Les clics sont comptés par lien à partir du 16 novembre 2026.
Ouvertures et clics par pays et par client de messagerie
GET /emails/metrics/countries liste les ouvertures et les clics des personnes selon leur pays d’origine, et GET /emails/metrics/clients liste les ouvertures selon le client de messagerie qui a chargé les images (deux extensions de BillionSend, clé à accès complet), de la plus forte interaction à la plus faible :
curl "https://api.billionsend.com/emails/metrics/countries?start_date=2026-11-16&end_date=2026-11-30" \
-H "Authorization: Bearer bs_..."
{
"object": "list",
"start_date": "2026-11-16T00:00:00.000Z",
"end_date": "2026-11-30T23:59:59.999Z",
"has_more": false,
"data": [
{ "country": "BR", "opened": 1840, "unique_opened": 1203, "bot_opened": 95, "clicked": 311, "unique_clicked": 240, "bot_clicked": 22 },
{ "country": "unknown", "opened": 960, "unique_opened": 702, "bot_opened": 410, "clicked": 12, "unique_clicked": 9, "bot_clicked": 3 }
]
}
countryest le code ISO 3166-1 alpha-2 du pays où l’adresse du lecteur est enregistrée. Il vautunknownquand l’adresse ne peut pas être localisée, et pour les ouvertures passant par les proxys d’images de Gmail et de Yahoo ou par la protection de la confidentialité d’Apple Mail : celles-ci viennent de l’adresse du fournisseur, pas de celle du lecteur.clientvautgmail,apple_mail,outlook,yahoo,thunderbird,other(un navigateur web : les webmails et les clients qui ne se déclarent pas se ressemblent) ouunknown(pas d’agent utilisateur). Les clics ne sont pas comptés par client, car un clic arrive depuis le navigateur auquel le client de messagerie confie le lien.- Seuls le pays et le client sont conservés pour les statistiques, jamais l’adresse ni l’agent utilisateur.
unique_openedetunique_clickedcomptent les e-mails dont la première ouverture ou le premier clic vient de ce pays ou de ce client. Les personnes et les machines sont comptées séparément, comme dansGET /emails/metrics.- Les deux acceptent
start_date,end_date,domain_idetbroadcast_id(séparés par des virgules), couvrent des heures UTC entières et renvoient toutes les lignes (il n’y a qu’un nombre limité de pays et de clients). Les ouvertures et les clics sont comptés par pays et par client à partir du 16 novembre 2026. - Géolocalisation IP par DB-IP, sous licence CC BY 4.0.
Voir aussi
Insights de délivrabilité note chaque e-mail et votre compte. Pour réagir à un résultat au moment où il se produit au lieu de le compter plus tard, utilisez les webhooks.