> For the complete documentation index, see [llms.txt](https://help.1msg.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.1msg.io/docs/russkii/api-1msg/analitika-shablonov.md).

# Аналитика шаблонов

Аналитика шаблонов позволяет отслеживать эффективность ваших рассылок, контролировать качество сообщений и оптимизировать затраты. Система предоставляет данные по доставке, прочтениям и взаимодействию с кнопками.

***

## Основные возможности

Использование 1MSG API аналитики позволяет автоматизировать мониторинг по следующим метрикам:

* Sent / Delivered / Read: Стандартная воронка сообщений.
* Clicked: Статистика нажатий на кнопки (URL-кнопки и Quick Reply). Доступно только для категорий `MARKETING` и `UTILITY`.
* Cost**:** Показатели стоимости, например, общая сумма затрат, стоимость доставленных сообщений, стоимость за клик по кнопке URL (для кампаний/отслеживаемых шаблонов)

***

## Важные ограничения и нюансы

Перед внедрением или использованием аналитики обратите внимание на следующие технические особенности:

1. Географические ограничения: Аналитика кликов (click tracking) не поддерживается для WABA, зарегистрированных в Евросоюзе (EU), Великобритании (UK) и Японии. Это связано с законами о защите данных (GDPR и др.).
2. Особенности работы в РФ и Китае: В регионах с ограничениями доступа к сервисам Meta для корректной работы аналитики кликов пользователю необходим VPN. Если получатель нажимает на кнопку без VPN, ссылка может не открыться.
   * *Рекомендация:* Если ваша аудитория в РФ, рекомендуется отключать трекинг ссылок в настройках шаблона (`cta_url_link_tracking_opted_out: true`).
3. Технические лимиты API:
   * Гранулярность: Доступна только ежедневная статистика (`DAILY`). Почасовой аналитики нет.
   * Лимит запроса: В одном API-запросе можно получить данные максимум по 10 ID шаблонов.
   * Часовые пояса: По умолчанию используется UTC. Можно переключить на часовой пояс аккаунта параметром `use_waba_timezone`.
4. Включение аналитики шаблонов. Для активации аналитики необходимо вызвать метод `/settings/templateAnalytics` с параметром `enable = true`.\
   После этого на уровне Meta (WABA) будет запрошено и применено разрешение на получение данных аналитики. После включения аналитики отключить её на уровне WABA невозможно. В системе 1msg отключение реализовано как ограничение на уровне API 1msg. Данные перестают отображаться и использоваться в продукте

***

### Кейсы использования

* A/B тестирование контента: Сравните две версии оффера по метрике Read Rate и Clicked. Оставляйте тот вариант, который дает больше переходов.
* Контроль качества базы: Если разрыв между Sent и Delivered более 15% — в вашей базе много неактивных номеров. Это сигнал к чистке базы, чтобы не портить репутацию номера в Meta.

***

### 🔗 Документация и ресурсы

[Документация 1MSG.io — Template Analytics](https://docs.1msg.io/#tag/Template-Analytics) — Эндпоинты для получения статистики и управления настройками.

> Примечание: Данные в аналитике обновляются с задержкой от нескольких минут до нескольких часов (зависит от задержек на стороне Meta).