Отчёты и отслеживание¶
Mailroom считает открытия и переходы в вашей собственной базе данных как отметки времени рядом со строкой отправки. Ни IP-адрес, ни браузер, ни местоположение никогда не сохраняются, и цифры остаются вашими, когда вы меняете почтового провайдера. Эта страница описывает отслеживание, разметку ссылок и вкладку Reports.
Открытия и переходы¶
| Настройка | Название | По умолчанию | Что делает |
|---|---|---|---|
tracking.opens |
Track Opens | Включено | Добавляет невидимое изображение в каждую кампанию ({route}/o/{token}.gif), чтобы сайт знал, когда её прочитали. |
tracking.clicks |
Track Clicks | Включено | Отправляет ссылки кампании через собственный редирект сайта ({route}/c/{token}), чтобы каждая ссылка считалась. Читатель попадает ровно на страницу, которую называла ссылка. |
tracking.retain_days |
Keep Detail For (days) | 365 |
Сколько хранятся отдельные переходы и события провайдера, прежде чем ежедневная уборка их уберёт. Собственные итоги кампании переживают уборку. |
У каждой кампании есть свои Count opens и Count clicks (см. Кампании). Кампания, которая не считает ни то, ни другое, показывает на своей странице «Tracking is off for this campaign».
Открытия всегда занижены: многие почтовые клиенты блокируют изображение, а тот, кто читает с выключенными изображениями, никогда не считается. Когда webhook провайдера сообщает об открытии или переходе, которых не увидели собственный пиксель или редирект Mailroom, он заполняет пробел.
Разметка ссылок¶
Ссылки кампании, ведущие обратно на ваш сайт, могут нести utm_source, utm_medium, utm_campaign и utm_content — так Google Analytics, Plausible, Fathom, Matomo и Umami говорят вам, какие посетители пришли из кампании. Ссылки куда-либо ещё никогда не размечаются, а ссылку, размеченную вами в сообщении, не трогают.
| Настройка | Название | По умолчанию | Что делает |
|---|---|---|---|
utm.enabled |
Tag Campaign Links | Включено | Выключено отправляет ссылки точно как написано. |
utm.source |
Source | newsletter |
Что говорит utm_source. |
utm.medium |
Medium | email |
Что говорит utm_medium. |
utm.campaign |
Campaign | пусто | Что говорит utm_campaign. Пусто использует собственное имя каждой кампании как слаг. |
utm.content |
Content | пусто | Что говорит utm_content. Обычно задаётся у кампании, чтобы различить две версии. |
Кампания переопределяет любой из четырёх в How links are tagged; пустое значение откатывается к значению сайта по умолчанию.
Вкладка Reports¶
Reports отвечает, почему кампания сделала то, что сделала, и как она выглядит рядом с предыдущими. Выберите отчёт, затем окно: Last 7 days, Last 30 days, Last 90 days, This year, All time или Between two dates. Некоторые отчёты группируются по дню, неделе или месяцу, а некоторые можно сузить до одного списка, кампании или автоматизации. Окно и выбор передаются в адресе страницы.
В каждом отчёте есть строка главных цифр, таблица, Export CSV и What each of these figures means, где дано предложение, определяющее каждую цифру и столбец. Числа хранятся пять минут; Refresh заново читает сайт. Даты — в UTC, по часам Mailroom; отчёт о времени отправки использует собственный часовой пояс сайта.
| Отчёт | На что отвечает |
|---|---|
| Campaign performance | Каждая кампания, ушедшая за окно, с отправленными, принятыми, открытыми, переходами, возвратами, ушедшими и жалобами и пятью процентами. Тест темы письма говорит, какая тема победила. |
| List growth | Кто подписался, подтвердил, ушёл и был исключён за день, неделю или месяц, и как пришли подписавшиеся. Сужается до одного списка. |
| Engagement | Сколько подписчиков что-то читали за 30, 60 и 90 дней, сколько ничего не открывало и сколько неактивны, по списку и по тегу. |
| Links | По чему нажимали во всех кампаниях окна, с долей каждой ссылки от открытий этой кампании. Сужается до одной кампании. |
| Bounces and complaints | Где почта не доходит, по принимающей и отправляющей компании, с жёсткими, мягкими и отклонёнными возвратами. |
| Automations | Кто вошёл в каждую автоматизацию, кто идёт по ней сейчас, кто закончил, кто ушёл раньше и почему, и проценты открытий и переходов её писем. Выберите одну автоматизацию, чтобы увидеть её по шагам. |
| Send times | Открытия по часу дня и дню недели, а также самый занятый час и день. |
Несколько определений, которые стоит знать:
- Open rate и click rate вычисляются из итогов, а не усреднением кампаний, поэтому кампания на сорок человек не весит столько же, сколько кампания на сорок тысяч. Это доли всех, кого достигла кампания.
- Accepted — то, что транспорт сообщил как доставленное. У сайта, чей транспорт ничего не сообщает, там нули, и это факт о транспорте, а не о кампании.
- Delivered, Opened и Clicked считают всех, кому сообщение доставлено, кто его открыл или по нему перешёл, включая того, кто позже отметил его как спам, поэтому цифры кампании и её график всегда согласуются.
- Bounced у кампании считает только недошедшие сообщения (постоянные возвраты и отказы). Отчёт Bounces and complaints считает каждый возврат, включая мягкие, поэтому его число больше.
- Dormant — подписчики, которым писали за последние девяносто дней и которые ничего не открыли. Тот, кому вы просто не писали, не неактивен.
- Complaint rate — цифра, за которой стоит следить: Gmail просит массовых отправителей держаться ниже 0,1% и считает 0,3% границей.
Вкладка Overview несёт краткую версию: Last campaigns, каждая со своими процентами открытий, переходов, отписок, возвратов и жалоб.
Из API¶
GET /mailroom/reports/{type} отвечает отчётом как JSON, а GET /mailroom/reports/{type}.csv — файлом. type — campaigns, list-growth, engagement, links, bounces, automations или send-times. Параметры запроса: from и to (даты, YYYY-MM-DD) или preset (7d, 30d, 90d, year, all), bucket (day, week, month), list, campaign, flow и refresh=1, чтобы пропустить пятиминутный кэш. Проценты — дроби от 0 до 1 и null там, где делить было не на что. Обоим нужен mailroom.view.