📦 Подія product_position_snapshot

product_position_snapshot — це основна подія, яку SellerIQ відправляє в Mixpanel для аналізу позицій товарів у видачі Rozetka.

Кожен івент — це «знімок стану» одного товару за одним пошуковим запитом у момент сканування:

• які у товару органічні позиції;
• які рекламні позиції;
• яка поточна ціна і знижка;
• скільки відгуків і яка оцінка;
• у якому режимі сканування було отримано цей знімок.

Цю подію зручно використовувати для побудови звітів у розрізі:

• конкретного товару,
• пошукового запиту,
• динаміки позицій,
• впливу ціни, знижок і рейтингів.

🏷 Назва події в Mixpanel

Технічна назва події: product_position_snapshot

У Mixpanel ви можете задати для неї більш зрозуміле Display name, наприклад Аналіз позицій у видачі

👉 Інструкція з додавання Display name

Це не змінить роботу сервісу, але зробить звіти і графіки більш зручними для читання.

🧱 Структура події

Нижче описані всі властивості, які SellerIQ відправляє в межах події product_position_snapshot.

1. Базова інформація про товар і запит

2. Групування товарів (Color Group)

⚠️ Наразі SellerIQ враховує лише групування товарів за кольором на стороні Rozetka. Інші типи групувань (модель, комплектація, обсяг пам’яті тощо) поки не аналізуються.

Rozetka об’єднує товари в групи за кольором (один і той самий товар у різних кольорах). У видачі при цьому може відображатися лише один товар із такої групи, а інші кольори доступні всередині картки товару.

SellerIQ враховує цю особливість і передає в події product_position_snapshot додаткові параметри, що описують, як саме було знайдено товар у видачі з урахуванням кольорового групування.

Як інтерпретувати group_source

3. Органічна видача (звичайні результати пошуку)

Ці властивості описують, на яких місцях товар знаходиться в органічній (не рекламній) видачі.

Приклад читання:

organic_page = 2, organic_pos_on_page = 5, organic_global_pos = 77 — товар на 2-й сторінці, 5-й за рахунком на 2 сторінці, а всього 77-й серед усіх результатів за запитом.

4. Рекламна видача (якщо товар показується в рекламі)

Ці властивості описують позиції товару в рекламних блоках Rozetka (якщо товар взагалі бере участь у рекламі за цим запитом).

Якщо товар не бере участі в рекламі за запитом, ці поля можуть бути порожніми (null).

5. Відгуки та рейтинг

Ці властивості допомагають аналізувати, як соціальне підтвердження (відгуки та оцінка) пов’язане з позиціями товару.

6. Ціни та знижки (Розширена модель цін)

SellerIQ фіксує не лише підсумкову ціну товару, але й структуру цін і знижок, щоб можна було аналізувати вплив базової ціни, знижок і промо-акцій на позиції товару у видачі Rozetka.

Ви можете будувати звіти за:

• товарами, у яких зараз є знижка,
• товарами, чия ціна знижувалась/підвищувалась,
• впливом знижок на органічні та рекламні позиції.
• які промо-акції працюють найкраще для покращення позицій.
• знаходити товари, які просуваються за рахунок промо-акцій (promo_price > 0),
• аналізувати, як додаткові промо впливають на позиції,
• порівнювати позиції товарів:
  • без знижок (discount_percent = 0),
  • зі стандартною знижкою,
  • з промо-прайсом;
• будувати звіти за ефективністю акцій у розрізі категорій, брендів і запитів.

6. Додаткові параметри (Event Props)

SellerIQ дозволяє передавати кастомні параметри разом із подією product_position_snapshot.

Ці параметри задаються під час додавання товару в пошук і передаються як властивості події для:

• конкретного товару
• і конкретного пошукового запиту

📌 Event Props не впливають на процес сканування і не беруть участі в розрахунку позицій. Вони використовуються виключно для аналітики та сегментації в Mixpanel.

🧠 Навіщо потрібні Event Props

Додаткові параметри дозволяють:

• сегментувати позиції товарів за бізнес-ознаками;
• групувати товари не лише за запитами, а й за внутрішньою логікою;
• будувати звіти під реальні задачі бізнесу.

Типові приклади використання:

• артикул або SKU;
• бренд;
• категорія;
• постачальник;
• маркетингова група;
• будь-яка внутрішня класифікація.

🧱 Як Event Props виглядають у Mixpanel

Кожен доданий параметр стає окремою властивістю події product_position_snapshot.

Приклад:

Після цього ви можете:

• фільтрувати звіти за цими параметрами;
• використовувати їх у Breakdown;
• комбінувати з позиціями, цінами та рейтингом.

🔍 Приклад сценаріїв аналітики

З використанням Event Props можна, наприклад:

• порівняти позиції товарів різних брендів за однаковими запитами;
• побачити, які категорії частіше потрапляють у топ;
• аналізувати ефективність постачальників або товарних груп;
• будувати звіти під внутрішні KPI команди.

⚙️ Обмеження та правила

Для параметрів Event Props діють такі обмеження:

• кожен параметр — це пара ключ → значення;
• ключ:
  • може містити лише латинські літери, цифри та символ підкреслення (A–Z, a–z, 0–9, _);
• значення:
  • може містити будь-який текст;
• ключ і значення:
  • не можуть бути порожніми;
  • автоматично очищаються від пробілів по краях перед збереженням.

💡 Рекомендується використовувати короткі та стабільні ключі (наприклад: brand, category, article, supplier).

🔗 Де налаштовуються Event Props

Додаткові параметри задаються у вікні додавання товару в пошук.

👉 Як додати Event Props під час додавання товару

Після збереження вони будуть автоматично передаватися у всі події product_position_snapshot для цього товару і пошукового запиту.

7. Статистика видачі (SERP stats)

Ці поля описують конкурентне оточення на 1-й сторінці видачі за запитом у момент сканування: цінові діапазони, знижки та популярність (вішлист) серед товарів, що потрапили до видачі.

Статистика рахується лише по товарах з 1-ї сторінки і надсилається разом із даними вашого товару.

Основні поля (середнє по A/B-варіантах)

Поля по A/B-варіантах видачі (суфікс _0, _1, _3, _4)

Rozetka паралельно показує кілька різних варіантів видачі різним групам користувачів (A/B-тестування). SellerIQ збирає статистику окремо по кожному варіанту.

Для кожного показника вище є 4 аналогічних поля із суфіксом _0, _1, _3, _4:

ℹ️ Поля без суфікса — середнє по всіх доступних A/B-варіантах. Для більшості тарифів доступний лише варіант _0, тому поля без суфікса і з суфіксом _0 збігаються. Доступ до всіх чотирьох варіантів (_0, _1, _3, _4) є на повних тарифах.

8. Службові поля

📂 Сканування категорій

Починаючи з версії v1.6.0 сканер підтримує не лише текстові пошукові запити, а й посилання на категорії Rozetka.

Розрізнити їх у Mixpanel можна за полем scan_type:

Поле query_url містить нормалізований URL: для категорій зберігається посилання без параметра page=N — завжди на першу сторінку з обраними фільтрами.

Поле search_query у обох випадках містить текстову мітку: назву пошукового запиту або назву категорії, з іконкою 🔍 чи 📂 на початку — саме так вона відображається у таблиці застосунку.

📊 Як використовувати product_position_snapshot у Mixpanel

Ось кілька практичних сценаріїв, для яких ця подія особливо корисна:

1️⃣ Аналіз позицій конкретного товару

Фільтруйте події за:

• rozetka_id або distinct_id,
• потрібним діапазоном дат.

Ви побачите, як змінювалися:

• органічні позиції (organic_global_pos),
• рекламні позиції (ad_global_pos),
• рейтинг і кількість відгуків (comments_mark, comments_amount),
• ціна і знижка (price, discount).

2️⃣ Порівняння різних пошукових запитів

Фільтруйте події за:

• одним і тим самим rozetka_id,
• різними значеннями search_query.

Так ви зможете зрозуміти:

• за якими запитами товар видно краще,
• де він частіше у топі,
• де його взагалі немає у видачі.

3️⃣ Аналіз впливу ціни та рейтингу

Використовуйте:

• price, old_price, discount,
• разом із organic_global_pos і ad_global_pos.

Можна побачити, як зміни:

• ціни,
• знижки,
• рейтингу та відгуків

впливають на позиції товару у видачі за ключовими запитами.