Встановлення плагіну для сайтів WooCommerce

Плагін eSputnik дозволяє керувати маркетинговими кампаніями вашого WooCommerce-сайту за допомогою однієї платформи даних клієнтів (CDP).

📘
Зверніть увагу
Цей плагін називається Yespo, але він повністю підходить для роботи з eSputnik CDP.

Можливості плагіну

Плагін дозволяє:

Переносити контакти з вашого сайту до Yespo.
Синхронізувати дані про замовлення (історичні та нові).
Відстежувати події на вебсайті за допомогою скрипту вебтрекінгу: активність користувача, відвідувані сторінки, вміст кошика та замовлення тощо.
Автоматично зареєструвати домен, отримати та встановити скрипт та service worker для налаштування Web Push.

Після інтеграції ви зможете:

Організувати автоматичний онбординг для нових контактів.
Збагачувати профілі контактів даними з ваших альтернативних платформ, таких як мобільні додатки.
Робити масові омніканальні розсилки.
Налаштовувати ланцюжки транзакційних повідомлень.
Аналізувати ефективність кампаній у режимі реального часу.
Збирати Web Push підписників та надсилати їм повідомлення у відповідному каналі.

Плагін дозволяє надсилати до eSputnik наступні події:

Подія	Опис
`PageView`	Надсилається, коли відвідувач сайту завантажує певну сторінку вебсайту. Подія за замовчуванням, необхідна для роботи всіх інших подій вебвідстеження.
`ProductPage`	Пов’язана з діями на сторінках товарів. Подію можна використовувати для кампаній, що включають покинуті перегляди, сповіщення про знижки на переглянуті товари або кампанії з повернення клієнтів.
`CategoryPage`	Спрацьовує, коли відвідувач переглядає сторінку категорії товару. Після отримання цієї події в eSputnik ви можете надсилати електронні листи з рекомендаціями найпопулярніших товарів у переглянутій категорії.
`CustomerData`	Передає дані відвідувача сайту, отримані під час реєстрації, входу в систему або здійснення покупки. Подія пов’язує відвідувачів вебсайту з обліковими записами у вашій системі, що дозволяє проводити персоналізовані кампанії.
`StatusCart`	Допомагає відстежувати статус кошиків. Подію можна використовувати для запуску e-commerce сценаріїв, таких як покинутий кошик, сповіщення про знижки на товари в покинутому кошику та сповіщення про знижки на товари, схожі на ті, що є в кошику.
`PurchasedItems`	Інформує про придбані товари та може бути використана для рекомендацій популярних товарів, додаткових та перехресних продажів. Наприклад, якщо клієнт придбав телефон, ви можете надіслати йому повідомлення з рекомендаціями щодо чохла або зарядного пристрою.
`MainPage`	Спрацьовує, коли відвідувач знаходиться на головній сторінці. Необхідна для відображення рекомендацій на сайті.
`NotFound`	Спрацьовує при потраплянні на 404 сторінку. Необхідна для відображення рекомендацій на сайті.
`ProductImpression`	Дозволяє відстежувати покази рекомендаційних блоків.

У разі деактивації плагін перестає виконувати свої функції.

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

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

Плагін працює на основі передачі даних через cron-завдання. Переконайтеся, що у вас налаштований активний cron: або стандартний WordPress, або серверний на вашому хостингу.

Якщо ви використовуєте плагіни кешування, обов’язково встановлюйте оновлення через репозиторій WordPress і після цього очистіть кеш, щоб усі зміни застосувалися коректно.

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

Встановлення плагіну

Увійдіть у свій обліковий запис WordPress.
Перейдіть до розділу Плагіни.
Знайдіть Yespo у полі пошуку та натисніть Встановити зараз.
Або,

Перейдіть на сторінку плагінів WordPress.
Знайдіть Yespo у пошуку та натисніть Завантажити.
Завантажте плагін у розділ Плагіни свого облікового запису WordPress.

Натисніть Активувати.
Натисніть кнопку Налаштування під плагіном у розділі Встановлені плагіни або перейдіть на окрему сторінку Yespo.
Введіть свій ключ API з повним доступом з облікового запису eSputnik і натисніть Синхронізувати, щоб розпочати синхронізацію даних.

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

Права доступу для ключа API мають бути встановлені як Full access to API. Докладніше про ключі API в eSputnik можна дізнатися в цій статті.

Плагін Yespo підтримує багатосайтові конфігурації для магазинів WooCommerce у WordPress. Для коректної обробки даних кожен магазин WooCommerce має бути підключений до окремого облікового запису eSputnik.

Після натискання кнопки Синхронізувати нові контакти та замовлення, що з'являтимуться у WooCommerce, автоматично передаватимуться в eSputnik. Також буде налаштовано відстеження подій на сайті та встановлено скрипт Web Push.

Щоб забезпечити правильну роботу, додайте товарний фід до eSputnik.

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

Ви завжди може призупинити надсилання контактних даних у eSputnik.

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

Якщо у вас виникнуть запитання або проблеми з інтеграцією — зв’яжіться з нами.

Хуки, таблиці, функції та інші компоненти WordPress і WooCommerce

Для коректної роботи плагіна необхідна наявність у системі низки стандартних елементів ядра WordPress і WooCommerce, а також доступ до базових таблиць, функцій, глобальних змінних та службових директорій.

Переконайтеся у наступному:

Стандартні хуки WordPress не були видалені чи деактивовані в темі або іншими плагінами. Ці хуки активні за замовчуванням, тому їхня відсутність може свідчити про навмисне використання remove_action або remove_filter.
Необхідні хуки WooCommerce присутні в темі й працюють належним чином. Ці хуки критично важливі для інтеграції з функціями WooCommerce і мають бути доступними у вашій конфігурації.
Таблиці WordPress доступні для читання та запису. Плагін використовує їх для зберігання налаштувань, роботи з користувачами та замовленнями.
Вбудовані функції WordPress не перевизначені або не заблоковані стороннім кодом. Плагін покладається на них для обробки запитів, захисту даних і взаємодії між фронтендом та бекендом.
Директорії та службові файли WordPress доступні для запису та читання. Плагін зберігає у них лог-файли, вебпуш-файли та власні скрипти.
Глобальні змінні WordPress і WooCommerce доступні. Вони використовуються для роботи з базою даних та замовленнями.

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

Хуки дій WordPress

Нава	Опис
`admin_notices`	Відображає повідомлення в зоні адміністративних сповіщень. Є частиною ядра WordPress і не залежить від тем оформлення чи їхніх кастомізацій. Використовується самим WordPress і сторонніми плагінами.
`profile_update`	Активується, коли створюється або оновлюється профіль користувача. Належить до ядра WordPress і не залежить від тем або налаштувань інтерфейсу. Використовується як WordPress, так і сторонніми плагінами.
`delete_user`	Викликається перед видаленням користувача. Являється частиною ядра WordPress і працює незалежно від кастомізацій тем. Використовується WordPress і сторонніми плагінами.
`wp_privacy_personal_data_erased`	Активується після виконання запиту на видалення персональних даних (GDPR). Належить до ядра WordPress і не залежить від змін у темах оформлення. Використовується всередині самого ядра WordPress.
`admin_enqueue_scripts`	Використовується для підключення JavaScript і CSS-файлів, що розширюють функціональність адміністративної панелі. Є частиною ядра і не залежить від оформлення інтерфейсу. Використовується WordPress і плагінами.
`wp_footer`	Додає власний код перед закриваючим тегом `</body>` . Є частиною ядра WordPress і не впливає на теми оформлення. Використовується WordPress і сторонніми плагінами.
`wp_login`	Активується після успішного логіну користувача. Базовий хук ядра, не залежить від кастомізацій тем. Використовується WordPress і сторонніми плагінами.
`wp_head`	Додає скрипти, стилі, метатеги для коду вебпушів в хедер сайту.

Таблиці WordPress

Нава	Опис
`wp_posts`	Одна з головних таблиць бази даних, у якій зберігаються всі типи контенту для отримання даних замовлень і подальшого експорту в eSputnik.
`wp_users`	Зберігає дані всіх зареєстрованих користувачів для подальшого експорту в eSputnik.
`wp_options`	Зберігає глобальні налаштування сайту, плагінів, тем, кешу, URL сайту та інші конфігураційні значення для зберігання API-ключа, скриптів вебтрекінга та вебпушів.

Вбудовані функції WordPress

Нава	Опис
`wp_remote_request`	Виконання HTTP-запитів будь-якого типу (GET, POST, PUT, DELETE тощо) до eSputnik.
`wp_localize_script`	Передача даних (зазвичай - об'єктів та рядків) з PHP у JavaScript для використання в підключеному скрипті.
`esc_html_`	Перекладає рядок і екранує його для безпечного виводу в HTML.
`esc_js`	Екранує текст для безпечного використання всередині JavaScript-коду, щоб запобігти XSS-атакам.
`esc_url`	Очищує та екранує URL перед його виведенням у HTML, щоб запобігти XSS-атакам або неправильному форматуванню посилань.
`esc_sql`	Екранує рядки, що вставляються в SQL-запити, щоб запобігти SQL-інʼєкціям.
`wp_create_nonce`	Створює одноразовий токен (`nonce`) для захисту від CSRF-атак при передачі даних через форми або AJAX-запити.
`wp_nonce_field`	Виводить приховане поле у формі з `nonce` (одноразовим токеном) для захисту від CSRF-атак.
`wp_enqueue_script`	Додає JS-файли у сайт для підключення скриптів плагіну.
`wp_send_json`	Надсилає JSON-відповідь і завершує скрипт.
`wp_kses_post`	Очищає HTML, залишаючи дозволені теги.
`wp_send_json_success`	Надсилає JSON-відповідь про успішну операцію.
`wp_send_json_error`	Надсилає JSON-відповідь про помилку.
`get_option`	Отримує значення опцій з БД (API-ключа, скриптів вебтрекінгу та вебпушів).
`update_option`	Створює або оновлює опцію в БД (збереження API-ключа та скриптів.)
`sanitize_text_field`	Очищає текст від небажаних символів для збереження в БД чи опціях.
`update_user_meta`	Додавання мітки, що контакт відправлено до eSputnik.
`get_user_by`	Пошук користувача за ID.
`wp_upload_dir`	Повертає дані про директорію завантаження файлів логів вебтрекінгу та вебпушів.
`wp_parse_url`	Обгортка навколо PHP-функції `parse_url()`, яка є більш стійкою до помилок і завжди повертає масив для логів вебтрекінгу та вебпушів.
`wp_json_encode`	Кодує PHP-масив або об’єкт у JSON-рядок перед відправкою даних до eSputnik.

Директорії та файли WordPress

Нава	Опис
`/wp-content/plugins`	Директорія для зберігання файлів плагіна.
`/wp-content/uploads`	Директорія для зберігання вебпуш-файлів і логів вебтрекінгу.
`admin-ajax.php`	Файл для обробки AJAX-запитів для обміну даними між фронтендом і бекендом.

Фільтр-хуки WordPress

Нава	Опис
`cron_schedules`	Використовується для додавання кастомних інтервалів для cron-завдань. Застосовується як ядром WordPress, так і сторонніми плагінами.

Хуки дій WooCommerce

Нава	Опис
`woocommerce_add_to_cart`	Активується під час додавання товару до кошика. Є частиною ядра WooCommerce, ініціалізується у файлі `CartController.php` у `src/StoreApi/Utilities` .
`woocommerce_after_cart_item_quantity_update`	Викликається при зміні кількості товару в кошику. Базовий хук WooCommerce, ініціалізується у `class-wc-cart.php` у директорії `includes` , але плагін безпосередньо його не використовує. Через рідкісні зміни в цих файлах ризик його порушення низький.
`woocommerce_cart_item_removed`	Активується при видаленні товару з кошика. Являється частиною ядра WooCommerce, ініціалізується у `class-wc-cart.php` в директорії `includes` . Активно використовується WooCommerce. Через рідкісні зміни в `includes` ризик пошкодження цього хука мінімальний.
`woocommerce_thankyou`	Викликається після оформлення замовлення. Є частиною ядра WooCommerce, використовується в шаблонах для відображення фінальних даних замовлення. Ініціалізується у файлі `thankyou.php` у директорії `templates/checkout` . Оскільки шаблони часто кастомізуються, ризик перезапису ініціалізації хука вищий.

Глобальні дані

Нава	Опис
`$wpdb`	Глобальний об’єкт для роботи з MySQL.
`WC`	Глобальний об’єкт, що надає доступ до замовлень та методів WooCommerce.
`WC_Order`	Клас для роботи з замовленнями.

Updated 10 days ago