Aller au contenu
Esc
↑↓naviguer↵ouvrir⌘Japerçu
Sur cette page

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.
  • clicked compte les personnes ; bot_clicked compte 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) et limit (de 1 à 100, 20 par défaut), et couvre des heures UTC entières comme GET /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 }
  ]
}
  • country est le code ISO 3166-1 alpha-2 du pays où l’adresse du lecteur est enregistrée. Il vaut unknown quand 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.
  • client vaut gmail, apple_mail, outlook, yahoo, thunderbird, other (un navigateur web : les webmails et les clients qui ne se déclarent pas se ressemblent) ou unknown (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_opened et unique_clicked comptent 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 dans GET /emails/metrics.
  • Les deux acceptent start_date, end_date, domain_id et broadcast_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.

Cette page vous a-t-elle été utile ?