Інтеграція з Google Analytics 4
Spefix може відправляти події пошуку напряму в ваш GA4 — це дозволяє аналізувати поведінку покупців у пошуку в контексті всієї аналітики сайту.
За замовчуванням інтеграція вимкнена. Для підключення зверніться до підтримки.
💬 Telegram: @spefix_pm • 📧 [email protected]
Події які передаються в GA4
search
Фіксує факт пошуку. Спрацьовує через кілька секунд після відображення результатів — це дозволяє уникнути зайвих подій від незавершених запитів.
| Параметр | Опис |
|---|---|
search_term | Пошуковий запит |
search_source | Завжди spefix |
search_results_count | Кількість результатів |
search_type | autocomplete або fulltext |
search_had_results | true або false |
view_search_results
Що побачив покупець у видачі. Відправляється разом з search, тільки якщо є результати.
Передає масив видимих товарів (items) — максимум 20. Кожен товар містить:
| Поле | Опис |
|---|---|
item_id | ID товару |
item_name | Назва товару |
item_category | Категорія |
item_brand | Бренд |
price | Ціна |
currency | Валюта |
index | Позиція у видачі (0-based) |
item_list_id | Завжди spefix_search |
item_list_name | Завжди Spefix Search Results |
select_item
Клік покупця на товар з пошукової видачі. Містить один товар з тими ж полями що і view_search_results.
item_list_id: 'spefix_search' — ключ для фільтрації в GA4. Дозволяє відрізнити кліки з пошуку від каталогу, рекомендацій та інших джерел.
Використовуйте фільтр по item_list_id = spefix_search в GA4 щоб бачити тільки взаємодії з пошуку Spefix.
Чому дані в GA4 і кабінеті Spefix можуть відрізнятись?
Аналітика в кабінеті Spefix точніша — ось чому.
Як працює аналітика в кабінеті: Spefix збирає всі пошукові запити протягом кількох хвилин, після чого AI агрегує їх і видаляє сміття — недописані запити, дублі, проміжні варіанти. У кабінеті ви бачите реальну картину без зайвого шуму.
Як працює відправка в GA4: GA4 не підтримує агрегацію на стороні Spefix, тому події відправляються через кілька секунд після відображення результатів. Через це можливі розбіжності:
- Покупець знайшов товар і клікнув на нього за 2-3 секунди → подія
searchможе не встигнути відправитись в GA4, але буде зафіксована в кабінеті - Покупець закрив пошук одразу після результатів → аналогічна ситуація
Розбіжність між даними в кабінеті Spefix і GA4 — це нормально. Орієнтуйтесь на кабінет Spefix як основне джерело аналітики пошуку.
Технічні деталі
- Якщо на сайті не підключений
gtag— інтеграція мовчки не спрацьовує, нічого не ламається - Налаштування вмикається індивідуально для кожного домену
- Самостійне увімкнення через кабінет поки недоступне — планується в майбутніх оновленнях