Analyses des diffusions
Les résultats des diffusions envoyées sur une période qui se termine maintenant, additionnés et comptés par jour, heure ou minute, avec une ligne par diffusion pour les comparer : l'onglet Analyses de la page Diffusions.
Exécute le véritable appel sur votre espace de travail.
GET /broadcasts/analytics
Les résultats des diffusions envoyées sur une période qui se termine maintenant, additionnés et comptés par jour, heure ou minute, avec une ligne par diffusion pour les comparer : l'onglet Analyses de la page Diffusions.
Exemple
Nécessite emails:read. Omettez broadcastIds pour toutes les diffusions, ou indiquez-en jusqu'à 50 séparées par des virgules. La période est days (1 à 1095) ou minutes (1 à 1576800, qui l'emporte si les deux sont envoyés), 30 jours par défaut. grain vaut day, hour ou minute, day par défaut, et offsetMinutes (-840 à 840) est le décalage de la personne qui consulte par rapport à UTC.
curl "$OE/broadcasts/analytics?days=30" -H "$AUTH"{ "object": "broadcast_analytics", "since": "2026-08-25T00:00:00.000Z", "until": "2026-09-23T12:00:00.000Z", "grain": "day", "offsetMinutes": 0, "broadcastIds": [], "totals": { "broadcasts": 2, "recipients": 530, "pending": 0, "sent": 527, "delivered": 519, "bounced": 6, "complained": 1, "failed": 3, "opened": 241, "clicked": 66, "unsubscribed": 4, "opens": 377, "clicks": 90 }, "series": [ { "bucket": "2026-09-09", "sent": 117, "delivered": 115, "opened": 54, "clicked": 14, "unsubscribed": 1 }, { "bucket": "2026-09-23", "sent": 410, "delivered": 404, "opened": 187, "clicked": 52, "unsubscribed": 3 } ], "broadcasts": [ { "id": "brd_5a8c1e3f7b2d94a06c8e1f3b", "subject": "The September release is out", "status": "sent", "sentAt": "2026-09-23T12:00:00.000Z", "recipients": 412, "sent": 410, "delivered": 404, "opened": 187, "clicked": 52, "unsubscribed": 3 }, { "id": "brd_2e7d9b4c1a8f60e35d2c7b91", "subject": "What changed in August", "status": "sent", "sentAt": "2026-09-09T09:30:00.000Z", "recipients": 118, "sent": 117, "delivered": 115, "opened": 54, "clicked": 14, "unsubscribed": 1 } ]}Une copie compte si elle a été envoyée pendant la période, et tout ce qui lui est arrivé ensuite compte avec elle. Les diffusions en mode test sont exclues.
totals et series additionnent les diffusions de broadcastIds, ou toutes s'il est vide. broadcasts liste toujours chaque diffusion de la période, la plus récente d'abord, avec les mêmes compteurs que totals, abrégés ici, pour que vous puissiez les comparer ou choisir des identifiants.
opened, clicked et unsubscribed comptent des personnes, tandis que opens et clicks comptent des événements. series est clairsemée, la plus ancienne d'abord, et compte chaque personne une fois, la première fois que cela lui est arrivé.
Plus de 50 identifiants donnent un 422 invalid_parameter, et un identifiant sans copie dans la période n'ajoute rien. Une clé limitée à certaines adresses ou certains domaines ne lit que les diffusions envoyées depuis une adresse ou un domaine qu'elle détient.
