브로드캐스트 분석
지금 끝나는 기간 동안 보낸 브로드캐스트의 성과를 합산하고 일, 시간, 분 단위로 세어, 비교할 수 있도록 브로드캐스트마다 한 행씩 보여 줍니다. 브로드캐스트 페이지의 분석 탭과 같습니다.
워크스페이스에 실제 호출을 실행합니다.
GET /broadcasts/analytics
지금 끝나는 기간 동안 보낸 브로드캐스트의 성과를 합산하고 일, 시간, 분 단위로 세어, 비교할 수 있도록 브로드캐스트마다 한 행씩 보여 줍니다. 브로드캐스트 페이지의 분석 탭과 같습니다.
예시
emails:read가 필요합니다. 모든 브로드캐스트라면 broadcastIds를 생략하고, 좁히려면 쉼표로 구분해 최대 50개를 지정하세요. 기간은 days(1~1095) 또는 minutes(1~1576800, 둘 다 보내면 이쪽이 우선)이며 기본값은 30일입니다. 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와 같은 수치와 함께 나열합니다(여기서는 줄였습니다). 비교하거나 ID를 고를 때 쓰세요.
opened, clicked, unsubscribed는 사람 수를 세고, opens와 clicks는 이벤트 수를 셉니다. series는 희소하며 오래된 순이고, 각 사람을 처음 그 일이 일어난 시점에 한 번만 셉니다.
ID가 50개를 넘으면 422 invalid_parameter이고, 기간 안에 사본이 없는 ID는 아무것도 더하지 않습니다. 특정 주소나 도메인으로 제한된 키는 자신이 가진 주소나 도메인에서 보낸 브로드캐스트만 읽습니다.
