---
title: "Як переглянути статистику натискань кнопок у сценарії?"
description: "Вкладка «Взаємодії з кнопками» в нативній статистиці: KPI, графіки, таблиця кнопок і фільтри для аналізу сценарію."
---

# Як переглянути статистику натискань кнопок у сценарії?

Коли потрібно зрозуміти, які пункти меню та inline-кнопки реально натискають клієнти в боті — відкрийте вкладку **«Взаємодії з кнопками»** в нативній статистиці. Там зібрані агреговані показники без ручного злиття логів.

## Коли знадобиться

- Аналізуєте популярність кнопок у сценарії (меню, inline, reply).
- Порівнюєте канали: де клієнти активніше обирають кнопки.
- Перевіряєте, як змінилася поведінка після зміни текстів кнопок або структури меню.
- Підготовка до оптимізації сценарію: які гілки майже не використовуються.

## Що важливо знати

- Вкладка показує **прийняті натискання кнопок** під час роботи сценарію (inline callback, збіг reply-кнопки, contact, location).
- **Не** відстежуються кліки в Constructor, Operator Panel або кнопки «відкрити посилання», якщо Engine не отримує подію назад.
- Вкладка **прихована**, доки адміністратор не вмикне її в налаштуваннях інстансу.
- Збір даних вмикається окремо: без збору нові кліки не накопичуються, а історія до ввімкнення збору не відновлюється.
- Період звіту — **не більше 90 днів**; сирі події зберігаються 90 днів (термін налаштовується).

## Перед початком

- [x] Ви увійшли з правами супервайзера, аналітика або адміністратора.
- [x] На інстансі увімкнена нативна статистика (**Статистика** → **Основна статистика**).
- [x] Адміністратор увімкнув відображення вкладки **«Взаємодії з кнопками»** в налаштуваннях інстансу.

## Покрокова інструкція

1. Відкрийте **Меню → Статистика**.
2. Перейдіть на **Основна статистика**.
3. Оберіть вкладку дашборду **«Взаємодії з кнопками»** (якщо її не видно — зверніться до адміністратора).
4. Задайте **Дата**, **Бот**, **Канал** та інші фільтри зверху, натисніть **«Застосувати фільтри»**.
5. Перегляньте блок KPI:
   - **Всього взаємодій** — сумарна кількість натискань за період і фільтрами.
   - **Унікальні користувачі** — кількість різних клієнтів (без персональних даних у звіті).
6. Графік **«Взаємодії у часі»** — динаміка по днях (межі днів — у часовому поясі фільтра).
7. **«За каналом»** і **«За типом підтвердження»** — розподіл по месенджерах і способу розпізнання кліку.
8. Таблиця **«Кнопки»** — деталізація по кнопках. Над таблицею — перемикач:
   - **«За кнопкою»** (за замовчуванням) — один рядок на кнопку: Translation ID, назва кнопки, секція, вихідна нода, взаємодії, унікальні користувачі, взаємодій на користувача. Inline- і reply-кнопка з одним перекладом — один рядок.
   - **«За текстом»** — один рядок на підпис кнопки; колонка «Кнопок» — скільки різних кнопок мають цей підпис. Кнопки без підпису потрапляють у рядок **«(без підпису)»**.
   - Додаткові фільтри вкладки: **Section ID**, **Вихідна нода**, **Translation ID**, **Кнопка**, **Мова**, **Тип підтвердження**.

<!-- screenshot: вкладка «Взаємодії з кнопками» — KPI, графік і таблиця «Кнопки» з перемикачем «За кнопкою / За текстом» -->

9. Якщо обрано період довший за 90 днів, картки не завантажуються, а замість даних з'являється повідомлення **«Оберіть період до 90 днів»** — скоротіть діапазон дат.

## Як читати «тип підтвердження»

| Показник | Що означає |
|----------|------------|
| **confirmed_click** | Структурований callback, contact або location — Engine однозначно розпізнав кнопку |
| **matched_selection** | Збіг тексту reply-кнопки з очікуваним варіантом |

## Для адміністратора (вмикання функції)

В **Instance settings → Feature flags**, категорія **System**:

1. **Button interaction tracking** (`ff_button_interaction_tracking`) — запис нових натискань.
2. **Button interactions statistics** (`ff_statistics_button_interactions`) — показ вкладки «Взаємодії з кнопками» для супервайзерів і аналітиків.
3. **Button interaction retention (days)** (`ff_button_interaction_retention_days`) — скільки днів зберігати сирі події (типово 90; нове значення діє для нових подій, не число або менше 1 — 90).

Після ввімкнення збору натискання починають записуватись не одразу: спершу фонове завдання готує індекси, зазвичай це кілька хвилин. Якщо через годину нових даних на вкладці так і немає — зверніться в підтримку.

Рекомендований rollout: спочатку збір, перевірка даних, потім відкриття вкладки. Детальніше про Instance Settings — [Налаштування інстансу](/uk/settings/how-to/configure-instance.md).

## Пов’язані матеріали

- [Метрики статистики — довідник](/uk/statistics/reference/statistics-metrics.md) — визначення показників вкладки
- [Переглянути дашборди](/uk/statistics/how-to/view-dashboards.md) — огляд інших вкладок
- [Показники тривалості та час реакції](/uk/statistics/how-to/view-appeals-duration-and-reaction-metrics.md) — SLA на вкладці «Звернення»