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

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

***

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

Использование 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).


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.1msg.io/docs/russkii/api-1msg/analitika-shablonov.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.