Статистика в своей аналитике

Цифры по рассылкам и триггерам можно забирать к себе в BI, хранилище или таблицу по расписанию, например раз в сутки.

Рассылки за период

GET /api/v2/mailing/ отдаёт рассылки со счётчиками:

curl --location 'https://mailganer.com/api/v2/mailing/?start_date=2026-09-01&end_date=2026-09-30' \
--header 'Authorization: CodeRequest ВАШ_API_КЛЮЧ'

{
    "count": 67,
    "next": "https://mailganer.com/api/v2/mailing/?end_date=2026-09-30&page=2&start_date=2026-09-01",
    "results": [
        {
            "public_id": 178532701233,
            "subject": "Осенняя коллекция",
            "segment_name": "Покупатели",
            "send": "2026-09-17T13:11:31.979578",
            "status_str": "Доставлена",
            "count_sent": 4907,
            "count_delivery": 4851,
            "count_open": 1265,
            "count_click": 147,
            "count_unsubscribe": 3,
            "count_spam": 0
        }
    ]
}

В примере ответ сокращён. На странице 25 рассылок, следующую берите по ссылке из next.

Рассылка по дням

GET /api/v2/mailing/{public_id}/stat/ отдаёт события по дням и итог в summary:

curl --location 'https://mailganer.com/api/v2/mailing/178532701233/stat/' \
--header 'Authorization: CodeRequest ВАШ_API_КЛЮЧ'

Открытия и клики приходят ещё несколько дней после отправки. Забирайте статистику не только за вчера, а за последние 7 дней и перезаписывайте её у себя.

Триггеры

Список триггеров с ID: GET /api/v2/triggers/. Статистика по одному триггеру: GET /api/v2/triggers/{trigger_id}/stat/.

curl --location 'https://mailganer.com/api/v2/triggers/12345/stat/?start_date=2026-09-01&end_date=2026-09-30' \
--header 'Authorization: CodeRequest ВАШ_API_КЛЮЧ'

С обеими датами придут цифры по дням и summary. Без дат или с одной датой только summary за всё время.

Отчёт по рассылке файлом

Общий отчёт или отчёт по кликам в CSV или XLSX. Файл собирается в фоне:

1. POST /api/v2/tasks/emails_report с mailing_id, mailing_report_type (general_mailing_report или clicks) и file_type (csv или xlsx). В ответе task_id.
2. GET /api/v2/tasks/{task_id}, пока state не станет COMPLETED.
3. GET /api/v2/tasks/{task_id}/download_file отдаёт файл.

curl --location 'https://mailganer.com/api/v2/tasks/emails_report' \
--header 'Authorization: CodeRequest ВАШ_API_КЛЮЧ' \
--header 'Content-Type: application/json' \
--data-raw '{
    "mailing_id": 178532701233,
    "mailing_report_type": "general_mailing_report",
    "file_type": "csv"
}'

Методы отчётов работают, только если в аккаунте включено ограничение доступа к API по IP-адресам. Без него ответ 403.