تحلیل ارسال‌های گروهی
عملکرد ارسال‌های گروهی که در بازه‌ای منتهی به اکنون فرستاده شده‌اند، جمع‌شده و شمرده‌شده به تفکیک روز، ساعت یا دقیقه، با یک ردیف برای هر ارسال گروهی تا بتوان آن‌ها را مقایسه کرد: زبانهٔ تحلیل در صفحهٔ ارسال‌های گروهی.
فراخوانی واقعی را روی فضای کاری شما اجرا می‌کند.
GET /broadcasts/analytics
عملکرد ارسال‌های گروهی که در بازه‌ای منتهی به اکنون فرستاده شده‌اند، جمع‌شده و شمرده‌شده به تفکیک روز، ساعت یا دقیقه، با یک ردیف برای هر ارسال گروهی تا بتوان آن‌ها را مقایسه کرد: زبانهٔ تحلیل در صفحهٔ ارسال‌های گروهی.
نمونه
به emails:read نیاز دارد. برای همهٔ ارسال‌های گروهی broadcastIds را نفرستید، یا تا ۵۰ مورد را با ویرگول جدا کنید. بازه days (۱ تا ۱۰۹۵) یا minutes (۱ تا ۱۵۷۶۸۰۰، که اگر هر دو فرستاده شوند اولویت دارد) است، و پیش‌فرضش ۳۰ روز. grain یکی از day، hour یا minute است، با پیش‌فرض day، و offsetMinutes (-840 تا 840) اختلاف ساعت بیننده با 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 } ]}یک نسخه وقتی شمرده می‌شود که درون بازه فرستاده شده باشد، و هر چه پس از آن برایش رخ داده نیز همراهش شمرده می‌شود. ارسال‌های گروهی در حالت آزمایشی کنار گذاشته می‌شوند.
totals و series ارسال‌های گروهیِ داخل broadcastIds را جمع می‌زنند، یا اگر خالی باشد همه را. broadcasts همیشه همهٔ ارسال‌های گروهی بازه را، از تازه‌ترین، با همان شمارش‌های totals فهرست می‌کند (اینجا کوتاه شده)، تا بتوانید آن‌ها را مقایسه کنید یا شناسه‌ها را برگزینید.
opened، clicked و unsubscribed افراد را می‌شمارند، در حالی که opens و clicks رویدادها را می‌شمارند. series پراکنده است و از قدیمی‌ترین آغاز می‌شود، و هر فرد را یک بار می‌شمارد، در نخستین باری که برایش رخ داد.
بیش از ۵۰ شناسه 422 invalid_parameter می‌دهد، و شناسه‌ای که در بازه نسخه‌ای ندارد چیزی اضافه نمی‌کند. کلیدی که به نشانی‌ها یا دامنه‌های خاصی محدود است فقط ارسال‌های گروهی‌ای را می‌خواند که از نشانی یا دامنه‌ای در اختیارش فرستاده شده‌اند.
