🌐EN🛠️ Developer Guide
User Guide
Start typing to search…

Інтеграція з Shopify

Плагін eSputnik для Shopify автоматично виконує таку технічну роботу:

  • Передача контактів — створення, оновлення та видалення контактів у реальному часі, а також імпорт історичних даних.
  • Передача замовлень — створення та оновлення замовлень у реальному часі, а також імпорт історичних даних.
  • Вебтрекінг — встановлення скрипта та конфігурація передачі подій (перелік подій наведено нижче).
  • Web Push — встановлення скрипта та Service Worker. Додаткових налаштувань зі стандартної інструкції з Web Push виконувати не потрібно — вам залишається лише активувати Web Push в налаштуваннях організації.
  • Віджети — встановлення скрипта.
  • App Inbox — плагін автоматично переналаштовує ініціалізацію скрипта та реалізує отримання токена авторизації. Додаткових налаштувань зі стандартної інструкції з App Inbox виконувати не потрібно.

Завдяки цій інтеграції ваш магазин Shopify з мінімальними налаштуваннями може використовувати потужні інструменти автоматизації для оптимізації маркетингових кампаній та комунікації з клієнтами.

✅

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

  • Цей додаток називається Yespo, але він повністю підходить для роботи з eSputnik CDP.
  • Товарні рекомендації потребують додаткових налаштувань на вашому сайті, тоді як технічна конфігурація решти інструментів виконується плагіном автоматично.
  • Технічні деталі щодо додатка можна дізнатися в публічному репозиторії.

Як налаштувати додаток Yespo Shopify

Виконайте наступні кроки, щоб інтегрувати eSputnik з вашим магазином Shopify.

❗️

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

Ми підтримуємо інтеграцію лише для одного активного маркету

Крок 1: Підключіть свій обліковий запис eSputnik

Використайте ключ Full access to API з вашого облікового запису eSputnik:

  • Увійдіть до свого облікового запису Shopify або зареєструйте його, перейдіть за посиланням для доступу до додатка Yespo та натисніть Install.
  • Підтвердьте встановлення додатка.
  • Введіть свій ключ API eSputnik та натисніть Connect.
Connect

Крок 2: Інтеграція скриптів для сайту та вебтрекінгу

Після підключення облікового запису eSputnik встановіть скрипти.

  • Активуйте розширення для теми Yespo (Activate theme extension).
  • Натисніть Save та Publish.

Крок 3: Активація App Inbox (опційно)

Щоб використовувати канал App Inbox у вашому магазині Shopify, активуйте цю опцію у розділі App Inbox.

Плагін автоматично переналаштує ініціалізацію скрипта для роботи в режимі App Inbox та реалізує отримання токена авторизації — ці кроки виконувати вручну не потрібно.

Повідомте [email protected] CSS-селектор елемента на сайті та розташування іконки дзвіночка відносно нього: beforebegin, afterbegin, beforeend або afterend.

<!-- beforebegin -->
<div class="your-selector">
  <!-- afterbegin -->
  вміст елемента
  <!-- beforeend -->
</div>
<!-- afterend -->

Крок 4: Активація вебтрекінгу (опційно)

Щоб активувати відстеження вебподій у eSputnik, натисніть Enable.

Enable

Додаток дозволяє надсилати такі події до eSputnik:

Подія

Опис

ProductPage

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

CategoryPage

Спрацьовує, коли відвідувач переглядає сторінку категорії товару. Після отримання цієї події в eSputnik ви можете надсилати електронні листи з рекомендаціями найпопулярніших товарів у переглянутій категорії. Налаштування мапінгу категорій в Category Settings описане нижче.

CustomerData

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

StatusCart

Допомагає відстежувати статус кошиків. Подію можна використовувати для запуску ecommerce сценаріїв, таких як покинутий кошик, сповіщення про знижки на товари в покинутому кошику та сповіщення про знижки на товари, схожі на ті, що є в кошику.
Викликається з бекенду вебхуком carts/update.

PurchasedItems

Інформує про придбані товари та може бути використана для рекомендацій популярних товарів, додаткових та перехресних продажів. Наприклад, якщо клієнт придбав телефон, ви можете надіслати йому повідомлення з рекомендаціями щодо чохла або зарядного пристрою.
Викликається з бекенду вебхуками orders/create.

MainPage

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

404

Спрацьовує при потраплянні на 404 сторінку. Необхідна для відображення рекомендацій на сайті.

📘

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

Також ви можете вручну налаштувати надсилання подій AddToWishlist та SearchRequest.

Налаштування події CategoryPage

Після активації вебтрекінгу натисніть Category Settings.

Налаштуйте надсилання події перегляду категорії CategoryPage для сторінок колекцій у Shopify.

  1. У колонці Collection Name оберіть колекції, для яких потрібно надсилати подію CategoryPage.
  2. У колонці Select entity для кожної колекції оберіть тип сутності (Type / Category), який ви використовуєте у товарному фіді як product type.
  3. У колонці Set up Category Value задайте типи товарів, які відображаються на сторінці цієї колекції (Сумки, Аксесуари тощо).

Після цього, коли користувач відкриватиме сторінку налаштованої колекції, додаток надсилатиме до eSputnik подію CategoryPage з даними про відповідну категорію з вашого фіду.

Крок 5: Синхронізація даних (опційно)

Активація цієї опції дозволяє:

  • Передавати до eSputnik історичні контактні дані;
  • Надсилати дані щодо нових та історичних замовлень.
Enable

Крок 6: Налаштування параметрів в eSputnik

Після встановлення скрипта перейдіть в eSputnik і налаштуйте Web Push, рекомендації та інші маркетингові інструменти відповідно до стратегії вашого магазину.

📘

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

  • Ви завжди може призупинити надсилання контактних даних у eSputnik.
  • Якщо додаток було деактивновано і активовано повторно, видалені за час його неактивності контакти не будуть передані у eSputnik.

Updated 13 days ago