تخطَّ إلى المستندات
API

تحليلات البث

كيف كان أداء البثوث المرسلة خلال فترة تنتهي الآن، مجموعةً ومعدودةً باليوم أو الساعة أو الدقيقة، مع صف لكل بث للمقارنة بينها: علامة التبويب «التحليلات» في صفحة البث.

GET/broadcasts/analytics

ينفّذ الاستدعاء الحقيقي على مساحة عملك.

GET /broadcasts/analytics

كيف كان أداء البثوث المرسلة خلال فترة تنتهي الآن، مجموعةً ومعدودةً باليوم أو الساعة أو الدقيقة، مع صف لكل بث للمقارنة بينها: علامة التبويب «التحليلات» في صفحة البث.

مثال

يتطلب emails:read. اترك broadcastIds لكل البثوث، أو اذكر حتى 50 منها مفصولة بفواصل. الفترة هي days (من 1 إلى 1095) أو minutes (من 1 إلى 1576800، وتكون لها الأولوية عند إرسال الاثنين)، و30 يومًا افتراضيًا. وgrain هو day أو hour أو minute، وday افتراضيًا، وoffsetMinutes (من -840 إلى 840) هو فرق توقيت المشاهد عن UTC.

curl
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    }  ]}

تُحتسب النسخة إذا أُرسلت داخل الفترة، ويُحتسب معها كل ما حدث لها بعد ذلك. ولا تدخل البثوث في وضع الاختبار.

يجمع totals وseries البثوث الواردة في broadcastIds، أو كلها حين تكون فارغة. ويعرض broadcasts دائمًا كل بث في الفترة، الأحدث أولًا، بالأعداد نفسها التي في totals، وقد اختُصرت هنا، لتقارن بينها أو تختار المعرّفات.

opened وclicked وunsubscribed تعدّ الأشخاص، بينما opens وclicks تعدّ الأحداث. وseries متفرّقة والأقدم أولًا، وتعدّ كل شخص مرة واحدة، عند أول مرة حدث له ذلك.

أكثر من 50 معرّفًا يعطي 422 invalid_parameter، والمعرّف الذي لا نسخة له في الفترة لا يضيف شيئًا. والمفتاح المقصور على عناوين أو نطاقات معيّنة لا يقرأ إلا البثوث المرسلة من عنوان أو نطاق يملكه.

صندوق بريدك،
بشروطك أنت.

بنية بريد إلكتروني للشركات والذكاء الاصطناعي والوكلاء والبريد الشخصي. مبنية للتوسّع والخصوصية والتحكّم. كل ما كان ينبغي للبريد الإلكتروني أن يملكه منذ اليوم الأول.

OpenEmail

بنية بريد إلكتروني للشركات والذكاء الاصطناعي والوكلاء والبريد الشخصي. مبنية للتوسّع والخصوصية والتحكّم. كل ما كان ينبغي للبريد الإلكتروني أن يملكه منذ اليوم الأول.

© 2026 OpenEmail. جميع الحقوق محفوظة.