Сегментація за подіями користувача

Event — це будь-яка подія на сайті або в мобільному застосунку, яка має дату, тип, набір обов’язкових і довільних параметрів.

Наприклад, такими подіями можна вважати:

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

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

📘

Зверніть увагу

Щоб підключити сегментацію за подіями користувача, залиште заявку на [email protected].

Параметри події для прив’язки контакта

При використанні метода Generate event v3 новий контакт створюється за умови, що для події підключено сегментацію.

Якщо контакт з ідентифікатором із параметрів події знайдено, система пов’язує подію з ним. Якщо не знайдено, новий контакт створюється лише тоді, коли в події є externalCustomerId разом з адресою email або номером телефону, а externalCustomerId не збігається з адресою email. Джерело створення такого контакта у його картці буде позначено як Подія.

Щоб подія збереглася з прив'язкою до контакта, параметр у події повинен містити ідентифікатор, за яким можна знайти контакт у eSputnik. Також необхідно знати, яке поле контакта використовується як ідентифікатор.

За замовчуванням система прив’язує події до контактів під час передачі таких параметрів:

Параметр подіїПоле контакта
ContactIdID контакта
externalCustomerIdЗовнішній ID
Email
EmailAddress
UserEmail
ContactEmail
Email
Phone
SMS
PhoneNumber
Номер телефону
PushTokenТокен контакта
ContactKey
Contact_key
Додаткове поле контакта з ім'ям
  • Назви параметрів, окрім адреси електронної пошти, чутливі до регістру. Наприклад, подія з параметром externalCustomerID замість externalCustomerId не зіставиться з контактом за цим параметром.
  • Значення параметрів, крім email, порівнюються зі значеннями параметрів події, що передаються, з урахуванням регістру.

Якщо подія передається з одним із параметрів, перелічених у колонці ліворуч, система автоматично пов’яже його з відповідним полем контакта в системі (стовпчик праворуч), коли знайде такий ідентифікатор.

Приклад події, для якої система автоматично знайде контакт:

{
  "eventTypeKey": "loginToMyWebSite",
  "keyValue": "bkeUc9sCpWoKLCOwmcZFKQ--",
  "params": {
    "contactId": "12312345612"
  }
}

Подія надійшла з ключем “contactId” : “12312345612”. Якщо такий контакт існує, eSputnik присвоїть йому подію.

Дізнайтеся, як зв'язати контакт із подією за зовнішнім ID >

Перевірка параметрів події

Виберіть тип події, який ви будете використовувати для сегментації, і перевірте його параметри. Розглянемо на прикладі OrderDeliveredRefferal.

  1. Перейдіть до розділу Тригери → Історія подій.
  1. У випадаючому списку Тип події виберіть OrderDeliveredRefferal або знайдіть його через пошук.
  1. Клікніть по назві OrderDeliveredRefferal, щоб відкрилися всі параметри події, і звірте їх з параметрами із таблиці вище.

Для події OrderDeliveredRefferal параметр email_client не підходить під жодне значення параметрів події з таблиці. У цьому випадку необхідне додаткове налаштування параметра email_client.

Параметр подіїПоле контакта
Email
EmailAddress
UserEmail
ContactEmail
Email

Налаштування параметрів події

Щоб використовувати іншу назву параметра події або інше поле контакта, ви можете задати правило відповідності для прив’язки параметрів події до ідентифікатора контакта.

  1. В обліковому записі перейдіть до розділу Налаштування → Події.
  1. Активуйте перемикач Задайте правило відповідності для прив'язки події, виберіть поле контакта та вкажіть назву параметра в події.

У нашому випадку пошук відповідності буде проходити за додатковим полем контакта з назвою Email і параметром події email_client.

  1. Натисніть Зберегти.

Врахування подій у сегментації

  1. Перейдіть до розділу Тригери → Типи подій та активуйте перемикач для потрібного типу подій.
  1. У вікні, що відкриється, натисніть кнопку Враховувати події в сегментації.
📘

Важливо

  • У сегментації беруть участь тільки події, які відбулися після активації опції.
  • Тип події з'являється у списку умов лише після того, як надійшла перша подія цього типу. Позначення типу для сегментації саме собою його не додає, бо до надходження події сегментувати нічого. Надішліть одну тестову подію, щоб тип став доступним для вибору.
  • Максимальна кількість подій для участі в сегментації — 50. Це загальне обмеження для акаунту — зверніться в підтримку, якщо потрібно його підвищити.
  • Подія, яку ви надсилаєте зі свого бекенда через API, прив'язується до картки контакту, лише якщо для її типу ввімкнено врахування в сегментації. Без цього такі події видно в історії подій, але не в картці контакту.

Створення умовної групи для сегментації за подіями

  1. Перейдіть до розділу Контакти → Групи контактів. Натисніть кнопку Нова група.
  2. Виберіть тип групи Умовна та натисніть Створити.
  1. Заповніть атрибути умовної групи:
  • Назва – буде відображатися у загальному списку груп.
  • Мета створення – наприклад, для розсилки B2B-прайсів та акцій.
  • Мітки – допоможуть швидко знаходити потрібні групи в загальному списку.
  1. Натисніть кнопку Далі.
  2. Натисніть кнопку Додати умову. У переліку умов з’явиться новий набір полів, які створюються після передачі подій до системи. Виберіть поле Подія користувача → Інші.

Базова сегментація можлива за кількістю подій за певний період, а розширена дозволяє сегментувати ще й за параметрами у події.

Наприклад, нам потрібно виділити всіх, хто сьогодні у Києві замовив бренд Алмаз на суму більше ніж 1500 грн.

Для цього спочатку створимо картку з усіма подіями, що відповідають створенню замовлення (можна вказати інші параметри кількості подій: для цього в умові Кількість подій вкажіть дорівнює, більше ніж, менше ніж або діапазон між).

📘

Формат числових параметрів

Порівнюючи числові параметри події (наприклад, totalCost), передавайте їх в однаковому форматі. Якщо в різних подіях те саме число передається як ціле і як дробове (наприклад, 1.2 і 1.20), таке розходження форматів може призвести до того, що умова сегментації спрацює некоректно.

Кількість подій в умові обраховується в межах вибраного періоду (наприклад, 5 разів сьогодні або 5 разів за останні 30 днів) — це не загальний показник за весь час. Щоб сегментувати за справжньою кількістю за весь час (наприклад, 5+ замовлень за весь час), експортуйте події в BigQuery, агрегуйте кількість там і поверніть її як додаткове поле в картці контакту.

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

Картка умов

Натисніть на три крапки, щоб вибрати параметри події для додаткової фільтрації.

Виберіть такі параметри:

  • brand → Алмаз
  • totalCost → більше ніж 1500 грн
  • town → Київ

Для вкладених параметрів події сегментація підтримує не більше 2 рівнів вкладеності.

Оператор не вказано знаходить події, у яких параметр передано з порожнім значенням або null. Події, у яких цього параметра немає, він не знаходить. Тому параметр, за яким ви фільтруєте, передавайте в кожній події. Якщо так не виходить, додайте в групу контакти з подіями цього типу й виключіть контакти, у подіях яких параметр вказано.

Значення параметрів порівнюються з урахуванням регістру: WEB і web — різні значення.

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

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

Сегментація за параметром productCategoryId працює лише з числовим ідентифікатором категорії, а не з її назвою.

📘

Кілька товарних критеріїв в одному замовленні

У сегментації за подіями масив товарів фактично «розгортається» у набір значень. Тому умова на кшталт category=devices ТА quantity=1 може виконатися за рахунок різних товарів одного замовлення — вона не гарантує, що обидві характеристики має один і той самий товар.

Вкладене ТА на рівні окремого товару в цьому конструкторі не підтримується.

Якщо це критично, передавайте окремий похідний атрибут на рівні товару чи події або будуйте сегмент у зовнішній системі.

Картка групи виглядатиме так:

📘

Значення параметрів для сегментації

Тип кожного параметра події система визначає з даних, які отримує. Параметр із довгими й майже унікальними значеннями — UUID, посилання, довгий опис — розпізнається як текстовий, і побудувати умову за ним неможливо.

Тому в параметрах, за якими плануєте сегментувати, передавайте короткі значення — приблизно до 50 символів. Довші не потрапляють у перелік, з якого оператор один з бере значення, тож знайти їх можна лише оператором містить із характерною частиною значення.

Період подій

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

Відносні періоди — протягом → останні N, між і більше ніж — відраховуються від часу, коли система перераховує контакти сегмента.

ВаріантЯкі події враховуються
сьогодніПодії поточної доби.
вчораПодії попередньої доби.
за весь часУсі збережені події без додаткового обмеження за датою. За замовчуванням події зберігаються два роки.
протягомПодії за поточний тиждень, місяць чи рік або за останні N хвилин, годин, днів, тижнів, місяців чи років.
міжПодії у відносному проміжку, наприклад від пʼяти до одного дня тому. Обидві межі входять до вибірки, а значення 0 означає момент перерахунку. Межі проміжку можна відлічувати як назад, так і вперед від моменту перерахунку.
серіяПодії, які відбувалися щонайменше один раз у кожному з N попередніх повних днів, тижнів або місяців за UTC.
період від X часу томуПодії за повний календарний період у минулому, наприклад за календарний рік два роки тому.
в день X часу томуПодії, що сталися у відповідний день у минулому, наприклад рівно два роки тому.
більше ніжПодії, що сталися раніше за вказаний момент, наприклад більше ніж 30 днів тому.
вказати датуПодії у вибрану дату, до неї або після неї.
вказати періодПодії між двома вказаними датами й часом. Дати можуть бути й у майбутньому.

Наприклад, якщо контакти сегмента перераховано 20 серпня 2026 року о 16:24:

  • протягом останніх 7 днів — події з 13 серпня 16:24 до 20 серпня 16:24, а протягом цього тижня — події від початку поточного календарного тижня до моменту перерахунку;
  • між 0 і 5 останніх днів — події з 15 серпня 16:24 до 20 серпня 16:24, зокрема події поточного дня;
  • між 1 і 5 останніх днів — події з 15 серпня 16:24 до 19 серпня 16:24; події поточного дня не враховуються;
  • період від 2 років тому — увесь 2024 рік;
  • в день 2 роки тому — 20 серпня 2024 року.

Серія працює з повними календарними періодами за UTC. Наприклад, умова серія → 4 → попередні повні тижні, перерахована 20 серпня 2026 року, охоплює чотири тижні: 20–26 липня, 27 липня – 2 серпня, 3–9 серпня та 10–16 серпня. До сегмента потраплять контакти, для яких подія відбулася щонайменше один раз у кожному з цих періодів. Поточний незавершений тиждень не враховується.

Натисніть Готово, щоб зберегти групу та використовувати її для надсилання ручних розсилок або у побудові сценаріїв.

Для формування сегментів за подіями, які відображають термін життєвого циклу клієнта, використовуйте умови:

  • Дата першої події — щоб визначити першу взаємодію користувача (наприклад, підписку, відписку, покупку тощо);
  • Дата останньої події — щоб зрозуміти, коли востаннє він проявляв активність за цією ж подією.

За допомогою цих умов ви зможете:

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

Це дозволить вам чітко розділяти нових і повернених користувачів. Наприклад, якщо контакт раніше вже був підписаний, потім відписався, а через кілька місяців знову оформив підписку — його не слід вважати новим.


Did this page help you?