Рекомендаційна система

У статті описано алгоритм роботи рекомендаційної системи, її переваги та технічні аспекти.

Що таке рекомендаційна система?

Рекомендаційна система – це логіки поштового маркетингу, які обирають найвлучніший контент листа, найкращий час для його відправки та користувача, якому найефективніше буде його надіслати.

Метою рекомендаційної системи є підтримка постійного зв’язку з вашими користувачами та залучення їх до взаємодії з вашим продуктом або сервісом.

Які проблеми допомагає вирішити рекомендаційна система?

1. Надлишок подій на продукті.

Припустимо, що користувач вашої платформи отримує багато нових повідомлень, його сторінку часто переглядають або додають у список “Улюблені”. Зрозуміло, що не варто відправляти надто велику кількість листів із кожного такого приводу.

Рекомендаційна система допомагає вирішити цю проблему, обираючи найбільш релевантну подію, що може стати темою нового листа.

2. Брак ідей для контенту.

Вибудувавши систему регулярного надсилання листів користувачу (наприклад, 2 чи 3 рази на день), ви також позбавите себе вічної дилеми “про що писати”. Адже, оскільки рекомендаційна система спирається виключно на дії самого користувача або на загальні оновлення, відповідно до його уподобань, їй ніколи не забракне ідей.

3. Нерелевантність листів.

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

Головна перевага рекомендаційної системи

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

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

• Дії на продукті самого користувача, що отримує лист;
• Дії інших користувачів, які стосуються безпосередньо отримувача листа (наприклад, перегляд його сторінки на вашій платформі або додавання його профілю до списку “Збережені”);
• Події, які можуть бути потенційно цікавими конкретному користувачу (наприклад, публікація нової книги, що належить до категорії його улюблених).

Як працює рекомендаційна система?

Спрощена схема роботи рекомендаційної системи

1. Спочатку система формує список користувачів для надсилання листів у певний момент.
2. Потім обирає тип листа, який необхідно надіслати, і робить запит івентного типу щодо конкретного користувача на вашу АРІ-точку.
   Запит івентного типу — це найбільш релевантний вид листа з привʼязкою до справжньої події, яка відбулась на вашому продукті або сервісі, та безпосередньо стосується конкретного користувача (наприклад, новий лайк, повідомлення, запит у друзі тощо).
   Кожен тип листа має окремі налаштування (наприклад, вказана частота його відправки або встановлені певні відмови чи Rejects).
   Система завжди враховує такі налаштування та відсікає ті типи листів, від яких користувач відписаний. Це можна перевірити за допомогою АРІ-точки Get current unsubscribes type mails.
3. У відповідь вам необхідно надіслати запит на АРІ-точку відправки тригерних листів із тим типом, запит на який ви здійснювали (наприклад, тип “new message”) та наповнити його персоналізованою інформацією. Також, додатково передається source_id запиту для того, щоб ми могли відрізнити ініційовані нами запити, від тих, які ініціювали безпосередньо ви.
   У випадку, якщо певна подія є неактуальною для отримувача листа (наприклад, ви хочете надіслати сповіщення про непрочитане повідомлення із типу “new message”, але у користувача наразі таких немає), ви можете надіслати інший тригерний лист із цим же source_id.
4. Зрештою, система відправляє відповідний тип листа вашому користувачеві.
5. Графік запитів подій з використанням рекомендаційної системи можна побачити у розділі Аналітика в адміністративній панелі, обравши метрику "Requests" у налаштуваннях. Додатково можна вибрати метрику “Response rate” та налаштувати фільтри для потрібного проєкту на бажаний часовий проміжок.

Логіка роботи рекомендаційної системи

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

1. Відслідковувати, збирати та зберігати події на вашому продукті або сервісі з привʼязкою до конкретного користувача або готовність згенерувати події на наш запит. (Наприклад, надати інформацію про нову книгу в категорії, яка подобається користувачеві, але яку він ще не відкривав);
2. На етапі інтеграції узгодити список таких подій із вашим CSM, щоб наша система могла робити запити на відправку листів;
3. Забезпечити кореляцію між певним типом події та типом листа, який ми можемо відправити;
4. Підключити тригерні типи листів;
5. Створити шаблони листів для кожної події зі списку погоджених (за вашим бажанням цей крок може виконувати наша команда);
6. Підготувати API-точку, яка буде приймати наші АРІ-запити.

Яку інформацію ви маєте нам передавати?

• Події виду "Online", "Payment" та інформацію про інші події в user_fields – ці дані можуть бути основою для запуску логіки відправки рекомендаційною системою:
  https://sendios.readme.io/reference/update-online-by-user-idhttps://sendios.readme.io/reference/add-payment-by-user-user
• Передавати client_user_id, за допомогою якого ми потім будемо відправляти вам запит:
  https://sendios.readme.io/reference/providing-user-id-on-product

Список IP-адрес, з яких Sendios відправляє запити

Для забезпечення правильної інтеграції та безпеки обміну даними, Sendios використовує конкретний набір IP-адрес для взаємодії з клієнтами.

За цим посиланням https://api.sendios.io/iplist ви можете знайти актуальний список IP-адрес, з яких Sendios може надсилати запити на вашу АРІ-точку. Це може допомогти вам забезпечити безпеку та стабільність обміну даними між вашою системою та Sendios.

FAQ

1. Яку API-точку треба використовувати?

Потрібно використовувати АРІ-точку для відправки тригерних листів:

https://sendios.readme.io/reference/send-system-trigger-email

2. В якому форматі необхідно передавати дані?

Дані необхідно передавати у форматі JSON.

3. Як дізнатися type_id листа?

type_id листа ви дізнаєтесь із нашого запиту, який ми відправляємо на вашу АРІ-точку.

4. Як відбувається вибір користувача (-ів) для відправки листа?

Спочатку система вибирає з бази даних всіх тих, у кого зараз найпопулярніша година переходу протягом дня (персоналізація часу);

Далі обирає користувачів за головним критерієм (наприклад, був онлайн 10 хвилин тому, не отримував листів протягом останніх 6 годин тощо);

Після застосування головного критерію система відсікає частину користувачів, яким наразі нерелеватно відправляти лист (наприклад, користувач відписаний від листів, зараз перебуває онлайн або нещодавно вже отримав тригерний лист від нас тощо);

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

5. Відправка листа ініціюється кожному користувачу окремо?

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

6. Як відбувається підпис запитів, які Sendios надсилає на вашу АРІ-точку та які ви робите на АРІ-точку відправки тригерних листів?

Підпис запитів на вашу АРІ-точку не є обовʼязковим, тому токена підпису не буде і в нашому запиті до вас (він міститиме лише основні параметри).

Надсилання нам підписується стандартно у вигляді clientId та clientToken.

7. Який запит Sendios надсилає на вашу АРІ-точку?

Ваша API-точка отримає POST-запит із наступними параметрами:

{  
    "project_id": 123, // Sendios  
    "email": "[email protected]",  
    "type_id": 1,  
    "source_id": 1,  
    "client_user_id": 123234 // your user_id on product - optional  
}

8. Як перевірити API-точку на вашому боці?

Ви можете перевірити свою API-точку за допомогою цього запиту сURL:

{  
    curl -X POST https://api.yourproduct.com/sendios/requestevent \
    -d '{"project_id": 123, "email": "[email protected]", "type_id": 1, "source_id": 1, "client_user_id": 123234}'  
}

У разі виникнення запитань зверніться до вашого Customer Success Manager