All documentation

Посібник користувача

Verimetriq — єдина панель, яка збирає дані з усіх ваших рекламних та аналітичних сервісів в одному місці. Хаб показує лише реальні дані з підключених джерел. Якщо чогось немає — ви побачите чесне «Недоступно» або «—», а не вигаданий нуль.

Загальні принципи (працюють на всіх сторінках)

Період — селектор угорі праворуч: «Останні 7 днів», «Останні 30 днів», «Останні 90 днів», «З початку року (YTD)». Керує всіма сторінками та блоками одразу. Деякі блоки (ціни Merchant, топ-сторінки SEO) живуть за власним вікном синхронізації і від періоду не залежать — це окремо позначено.
Перемикач організації (угорі) — кожна організація — це окремий кабінет із повністю ізольованими даними, ключами та брендами. Дані однієї організації ніколи не змішуються з даними іншої. Запросити колег до організації можна в «Налаштування → Команда».
Мова інтерфейсу — перемикач мов (українська, англійська та ще низка мов). Інтерфейс застосунку за замовчуванням українською.
ⓘ біля назви — наведіть, щоб отримати пояснення метрики простою мовою. Є в кожного показника й каналу. Усі ці тексти зібрані на сторінці «Довідник показників».
Кольори-світлофор: зелений — добре, бурштиновий — увага, червоний — проблема. Пороги підібрані під метрику (наприклад, Bounce <45% зелений).
Сортовані таблиці: клік по заголовку колонки сортує таблицю (перший клік — за спаданням, повторний — за зростанням).
«пор. з попереднім періодом» — порівняння з таким самим вікном до цього. Якщо даних минулого періоду мало (<70%), порівняння чесно приховується («Немає даних для порівняння»).
Блоки «Висновок» (на конкурентах тощо) та авто-банери — короткі підказки простою мовою, згенеровані з реальних цифр сторінки. Це не поради «з повітря», а переказ ваших даних.
Бурштинова плашка свіжості — дані не оновлювалися >26 годин: нічна синхронізація не відпрацювала (див. «Якщо дані застаріли»).

Сторінки

Панель управління (Дашборд)

Верхньорівневе зведення: дані сайту (GA4) + усі підключені рекламні майданчики.

Консолідовані показники бізнесу: дохід (GA4), замовлення, сеанси, конверсія сайту, середній чек, витрати на рекламу (всі канали) та MER (дохід ÷ усі витрати — загальна ефективність маркетингу, наприклад «5,0x»).
Таблиця каналів — дохід і сеанси за каналами GA4, поділені на Платні (коричнева смуга) та Безкоштовні (зелена) з підсумками та рядком «Різниця (безкоштовні − платні)». Колонки: сеанси, Bounce % (зелений <45%, бурштиновий 45–65%, червоний >65%), дохід, замовлення, CR %, середній чек, ROAS (лише платні), Δ до попереднього періоду.
Графік динаміки — перемикач метрики: дохід (GA4) / витрати на рекламу / конверсії.
Здоров’я джерел даних — скільки джерел підключено / не підключено, коли була остання синхронізація, посилання «Відкрити інтеграції» веде до «Налаштувань».

Важливо: дохід за каналами рахує GA4 (за останнім кліком) — він може відрізнятися від цифр кабінету Google Ads. Це різна атрибуція, не помилка (ⓘ).

Трафік (платна реклама)

Аналітика рекламних каналів: Google Ads, Meta Ads (FB · IG), TikTok, YouTube. Наразі реальні дані є по Google Ads; інші канали показані як «не підключено», доки не з’явиться інтеграція. (Пункт меню «реклама PPC» веде на цю ж сторінку — це одна й та сама сторінка.)

Вкладки каналів угорі: «Всі канали», Google Ads, Meta Ads, TikTok Ads, YouTube. На вкладці «Всі канали» — картка з кількістю підключених акаунтів і витратами по кожному каналу.
Вибір акаунтів (на вкладці Google Ads) — випадний список із галочками: можна вибрати один, декілька або всі кабінети (наприклад, «Бренд A», «Бренд B»). Керує всіма блоками сторінки одразу.
Зведені показники — ROAS, вартість (витрати), дохід (Google Ads), вартість/конверсія, кліки, покази, CTR, замовлення, коефіцієнт конверсії. У доходу позначено, що це атрибуція Google Ads і числа можуть відрізнятися від GA4 на дашборді.
Деталізація — сортована таблиця ВСІХ кампаній із витратами в періоді: назва й тип (PMax / Search / Shopping / Demand Gen / Display / Video), витрати, частка бюджету, покази, кліки, CTR, замовлення, ROAS. ★ — кампанія-зірка (високий ROAS на малому бюджеті). Нижче — авто-підказка.
Глибока аналітика — розширені групи метрик за вибраними кабінетами.

SEO & Пошук

Органічний (безкоштовний) пошук із Google Search Console по ваших сайтах.

Вкладки сайтів («Всі сайти» + по кожному сайту).
Воронка Search Console: органічні покази, органічний CTR (норма 3–6%, позначається «в нормі / нижче / вище»), органічні кліки, середня позиція (ціль <5). У кожної картки — порівняння з попереднім періодом.
Розшифровка по показниках — таблиця зі статусами-чипами (норма/увага/ проблема), включно з часткою небрендових кліків (норма 60–75%), бренд/небренд, кількість сторінок у пошуку, мобайл/десктоп.
Динаміка органічного пошуку — графік із перемикачем метрики (кліки / покази / CTR % / позиція).
Топ запитів і Топ сторінок — за вікном синхронізації (не залежить від періоду).
Сторінки, що продають (органіка) — дані GA4 (вікно 365 днів): які органічні сторінки реально приносять дохід (сеанси, замовлення, CR, дохід).

Конкуренти

Хто конкурує з вами в платному аукціоні Google та в органічній видачі. Дані з двох джерел: місячний CSV із Google Ads (завантажуєте ви) та автоматично синхронізований DataForSEO (органіка).

Профілі конкурентів — картки топ-конкурентів: домен, бейдж «SEO» та, якщо конкурент рекламується, бейдж «реклама»; спільні ключі, середня позиція, оцінка органічного трафіку. Нижче — «Висновок».
Аукціон Google Ads (Deep Dive) — як завантажити CSV (лише адміністратор):
1. У Google Ads: Кампанії → виділити кампанії → вкладка «Статистика аукціонів» → «Завантажити» → CSV.
2. На сторінці натисніть кнопку «Завантажити CSV», оберіть файл (можна кілька одразу). Місяць визначається автоматично з файлу — вручну вказувати не потрібно. Завантаження роблять щомісяця, по одному файлу за місяць.
3. Після завантаження з’явиться зведення: які місяці й скільки записів завантажено.
- Селектор «Період» (після першого завантаження) — вибір місяця (наприклад, «січень 2026»); органіка нижче підлаштовується під вибраний місяць.
- Бейдж типу звіту: «Пошук» або «Торгові».
- Сортована таблиця: домен, частка показів (SOV), перетин, частка показу вище за вас, частка обгонів; колонки «Платний» і «Органічний» показують, чи активний домен в аукціоні та в органіці. Нижче — «Висновок».
Органічні конкуренти (SEO) — з DataForSEO: домен, спільні ключі, всього органічних ключів, оцінка органічного трафіку, середня позиція. Якщо DataForSEO не підключено — підказка підключити його в «Налаштуваннях». Нижче — «Висновок».
Якщо за вибраний місяць ще немає SEO-зрізу, золотий банер чесно покаже, що виведено найближчий доступний зріз (SEO-історія накопичується з поточного місяця).

Товарний фід (Merchant Center)

Здоров’я товарного фіду Google Merchant Center. Сторінка лише для перегляду (дані надходять автоматично, селектора періоду немає).

Червоний банер угорі — якщо є серйозна проблема з фідом.
Статуси товарів (плитки): всього, схвалено (зелений), відхилено (червоний — товари НЕ показуються), з проблемами (бурштиновий), без статусу. Один товар може мати різні статуси для різних майданчиків, тому сума часток буває більшою за 100%.
Головні помилки Merchant Center — таблиця з кодом, описом, серйозністю та кількістю; рядки позначені «БЛОКУЄ» (товар знято з показу) або «не впливає».
ROAS за категоріями (Shopping / PMax) — витрати та віддача за типами товарів (зелений ROAS ≥3, бурштиновий ≥1, червоний <1); ★ — найкраща, ⚠ — слабка.
Цінова конкурентність (Google Shopping) — порівняння ваших цін із ринковим бенчмарком Google. Це знімок Google за останні тижні, він НЕ залежить від селектора періоду (оновлюється щоденною синхронізацією, «станом на» дату). Чипи: «дорожче >5%», «в межах», «дешевше»; таблиця по товарах (наша ціна / ринок / відхилення).
Чек-лист дій — авто-пріоритизований список задач із кольоровими мітками пріоритету.
Товари з критичними помилками — список DISAPPROVED-товарів, що не рекламуються (артикул, товар, бренд, код помилки).

CRM / Retention

Огляд аудиторії email/SMS з eSputnik / Yespo. Без персональних даних — лише агреговані підрахунки та метадані груп (жодних телефонів, email чи імен).

Аудиторія та канали — всього контактів, SMS-канали та Email-канали (з часткою бази), групи/сегменти (всього, статичні, комбіновані).
Джерело даних — статус підключення eSputnik і час останньої синхронізації; блок про приватність.
Email-канал → продажі сайту (GA4, 30 днів) — таблиця: тригерні листи магазину (Horoshop) vs розсилки eSputnik → сеанси, дохід, замовлення.
Групи та сегменти — таблиця метаданих (ID, назва, тип), без даних учасників.

Воронки

Шлях клієнта від показу реклами до покупки: скільки людей проходить кожен крок і де вони губляться. Реагує на загальний селектор періоду + власний вибір каналу.

Вибір каналу — «Всі канали», Google Ads, Meta Ads, SEO, соцмережі (органіка), email, прямі заходи, переходи з інших сайтів.
Воронка — етапи (за наявності даних): покази реклами → кліки → («перехід на сайт») → відвідувачі сайту → переглянули товар → додали в кошик → почали оформлення → купили. Кожен етап: кількість людей, конверсія кроку «↓ X%» (зелений ≥50%, бурштиновий ≥15%, червоний нижче) і «% від вершини».
Підсумок у грошах — витрати на рекламу, дохід сайту, конверсія в покупку, середній чек.
Внизу — методична примітка (кроки рахуються в людях; кліки не дорівнюють сеансам 1:1 через блокувальники та виходи до завантаження).

UTM-мітки

Конструктор посилань із мітками + пам’ятка. Мітка на посиланні дозволяє аналітиці бачити, звідки прийшов відвідувач. (Повний стандарт міток — у docs/UTM_GUIDE.md.)

Генератор посилань — форма: адреса сторінки (є швидкі кнопки на сайти), канал (Instagram, Facebook, YouTube, TikTok, PR-стаття, блогер, Telegram тощо), формат (змінюється під канал), назва видання/партнера (латиницею, де потрібно), дата, бренд (для мультибрендових компаній), тема (можна кирилицею — сама транслітерується), чий акаунт. Кнопка «Сформувати посилання» → готове посилання можна скопіювати одним кліком.
Пам’ятка — як влаштована мітка, що НЕ мітимо (Google Ads / Meta Ads / SEO на своїх сайтах / маркетплейси), три правила написання (латиниця, нижній регістр, _ замість пробілів), UGC, часті помилки.

Довідник показників (Глосарій)

Усі показники хаба простою мовою — ті самі тексти, що в підказках ⓘ.

«Чому числа відрізняються між сторінками» — пояснення атрибуції (дохід GA4 і дохід Google Ads — це два різні вимірювання, вони й не мають збігатися; джерело завжди підписане на плитці).
Список показників із пошуком (введіть «ROAS», «чек», «охоплення» — список відфільтрується): дохід, замовлення, сеанси, конверсія, середній чек, витрати, MER, ROAS, CPA, CTR, CPC та ін.

Зведені звіти

Розділ у розробці. Експорт звітів ще не підключено — тут навмисно немає кнопок, які нічого не роблять. Наразі всі живі дані доступні на сторінках розділів: Дашборд, Трафік, SEO, Merchant, CRM. Нижче — картки запланованих шаблонів (інформаційно).

Зворотний зв’язок

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

Нове звернення — тип (проблема / помилка в даних / пропозиція / доопрацювання / питання), опис (вкажіть сторінку та період, де цифри виглядають неправильно), файл до 5 МБ (необов’язково), кнопка «Надіслати».
Як це працює — звернення зберігається й надходить на email; відповідь протягом 2–3 робочих днів на ваш email входу. Зберігаються лише ваш email, компанія та сторінка.
Список звернень — ви бачите свої звернення та їхні статуси. Адміністратор бачить усі, може фільтрувати (Нове / В роботі / Закрито: виконано / Закрито: відхилено), писати резолюцію та змінювати статус.
Куди приходять звернення — поле email для звітів (бачить лише супер-адміністратор).

AI Радник

Чат по ваших реальних даних: задавайте питання про маркетинг звичайною мовою — радник відповідає на основі підключених джерел. Нижче чату — історія запитів.

Статус доступу до даних (збоку) — які джерела радник може читати: лічильники «Підключено» / «Не підключено» та список джерел з індикатором (та сама правда, що на дашборді й у налаштуваннях).

Налаштування

Ключі та підключення: форми по кожному джерелу. Наявні ключі з .env.local уже враховано (позначка «задано у .env.local») — їх не потрібно вводити заново. Новий ключ: ввести → «Зберегти» → автоматична перевірка з’єднання → зелена галочка. Ключі зберігаються зашифровано, окремо для кожної компанії. Доступно лише адміністратору. (Де взяти кожен ключ — див. розділ «Підключення джерел» нижче.)
Статус підключень: що реально підключено, час останньої синхронізації (та сама правда, що й на інших сторінках). Якщо джерело не підключене, у звітах воно показує 0.
Покриття даних і Профіль робочого простору (клієнт, кількість брендів, правило «Тільки реальні дані»).

Вхід

Екран входу: email, пароль (з кнопкою показати/приховати), «запам’ятати мене», перемикач мови (uk / ru / en). Під час найпершого запуску (коли користувачів ще немає) ця ж форма створює адміністратора — кнопка тоді називається «Створити адміністратора».

Підключення джерел (де взяти ключ)

Усі ключі вводяться в «Налаштування → Ключі та підключення». Нижче — високорівнево, де знайти кожен у самому сервісі:

eSputnik / Yespo (CRM) — API-ключ у кабінеті eSputnik (розділ з API).
Google Analytics 4 — GA4 Property ID (у GA4: Адміністратор → налаштування ресурсу) + JSON сервіс-акаунта (вставити вміст файлу з Google Cloud).
Google Ads — Developer token (у MCC-акаунті: API Center), OAuth Client ID/Secret і Refresh token (Google Cloud), Manager (MCC) ID та Customer ID кабінетів.
Google Search Console — OAuth Client ID/Secret (Google Cloud) + адреси сайтів (Property), як вони заведені в Search Console.
Google Merchant Center — Merchant ID (видно в кабінеті Merchant Center).
Meta Ads (Facebook / Instagram) — Access token системного користувача (Meta Business → системні користувачі; права ads_read + pages_read_engagement + instagram_basic/insights) + Ad Account ID (act_…). Цей самий токен вмикає органіку Facebook-сторінок та Instagram.
Horoshop (замовлення як CRM) — домен магазину, API-логін і API-пароль (в адмінці Horoshop).
Bitrix24 CRM — URL вхідного вебхука (у Bitrix24: розробникам → вебхуки).
DataForSEO (органічні конкуренти + SEO) — логін (email акаунта) та API-пароль (кабінет DataForSEO → API Access) + домен для аналізу.
Microsoft Clarity — API-токен (Clarity → Settings → Data Export → New API token).
Claude AI (аналітичний радник) — Anthropic API key (console.anthropic.com → API keys). Кнопка «Відкрити сторінку ключів →» у картці веде прямо туди.

Якщо дані застаріли (бурштинові плашки)

Відкрийте «Налаштування» → перевірте статуси, або спитайте /api/health.
Адміністратор: docker compose logs scheduler на сервері покаже причину; перезапуск синку: docker compose exec scheduler npx tsx scripts/sync/run-all-syncs.ts (локально: npm run sync:all).

Ролі

super_admin — усе, включно з ключами, користувачами та завантаженням CSV конкурентів;
analyst / viewer — перегляд дашбордів.

Додати користувача: npm run auth:user -- email --role viewer.

Оплата зовнішніх сервісів

Платформа не проводить платежів. Claude, Google-сервіси, CRM — оплачуються власником напряму постачальнику (своя картка в їхній консолі). У налаштуваннях проєкту зберігається лише API-ключ, зашифровано. Кнопка «Відкрити сторінку ключів →» у картці Claude AI веде одразу на потрібну сторінку консолі Anthropic: реєстрація → своя картка → Create Key → вставити → «Перевірити».

Stuck? Write to support@verimetriq.com — a person answers.