Перейти к документации
MCP-сервер

Отслеживание

Что стало с почтой, отправленной этим ящиком.

Инструменты отслеживания

ИнструментЧто делает
getEmailTrackingБыло ли открыто одно письмо, кем, сколько раз и по каким ссылкам перешли. Принимает id переписки, RFC Message-ID или id отслеживания.
getFileDownloadsФайлы, отправленные в переписке ссылками на скачивание: имя файла, размер, сколько раз каждый скачали, когда было последнее скачивание и жива ли ещё ссылка. Принимает id переписки.
listTrackedEmailsПисьма, отправленные с включённым отслеживанием, начиная с самых свежих, с фильтром по тому, открыли их или по ним кликнули.
getEngagementStatsДоли открытий и кликов за период, с лучшими ссылками, клиентами и тем, сколько обращений было отфильтровано.

Они видят только почту, отправленную с включённым отслеживанием, а оно включено, если его не выключили для адреса, с которого отправляли, или для пункта «Все адреса». getEmailTracking говорит «по этому письму ничего не отслеживалось», а не сообщает о нуле открытий. Фразы «никто не открыл» и «мы не вели запись» — разные ответы, и инструмент, который выдаёт первый вместо второго, лжёт о получателе.

getFileDownloads считает людей, а не сканеры или генераторы предпросмотра ссылок, и никогда не называет, кто скачал файл, потому что ссылка на скачивание — один URL для всех получателей письма. Файлы, вложенные внутрь письма, не перечисляются, поскольку при их открытии ничего не записывается, так что пустой ответ означает «в этой переписке нет ссылок на скачивание», а не «никто не открыл вложение».

Каждая доля считается по ОТСЛЕЖИВАЕМЫМ письмам, а не по всей отправленной почте. У ящика, который отслеживает одно письмо из десяти, есть доля открытий по этим десяти; деление на всё когда-либо отправленное даёт число, которое падает каждый раз, когда кто-то отправляет неотслеживаемый ответ, а это не факт о том, как читают их почту.

Подсчёты не учитывают сканеры и прокси для приватности, и каждый отчёт сообщает, сколько было исключено. Открытия, видимые через прокси изображений Gmail, засчитываются, потому что письмо показал человек, но прокси кэширует, поэтому счёт через Gmail — нижняя граница, а не итог.