Klaviyo Connector для WooCommerce — події, профілі та підписки з магазину в Klaviyo

Klaviyo Connector для WooCommerce — інтеграція магазину з Klaviyo через офіційний API. Флоу Klaviyo — кинутий кошик, кинутий перегляд, «дякуємо за замовлення», повторні покупки — працюють настільки добре, наскільки точні події, які вони отримують. Плагін надсилає їх із самого WooCommerce, у фоні, без дублікатів, і з одним приватним ключем: чекаут ніколи не чекає на відповідь Klaviyo. Магазин на OpenCart — є Klaviyo Connector для OpenCart.

Важливо перед встановленням: якщо в магазині стоїть офіційний плагін Klaviyo for WooCommerce, вимкніть його. Два плагіни надсилають ті самі замовлення з різними ідентифікаторами, і Klaviyo порахує їх двічі.

Чесно про перевірку. Пісочниці Klaviyo не надає. Плагін зроблено за офіційною документацією (OpenAPI Klaviyo, ревізія 2026-07-15) і перевірено наскрізно в тестовому магазині на симуляції API, зробленій за цією документацією: блоковий і класичний чекаут, HPOS, PHP 7.4 і 8.3, мультивалютність, Polylang, банер згоди Complianz. Формат наших подій ми додатково прогнали через валідацію живого API Klaviyo, а відповіді на неправильний ключ звірили з ним самим. На реальному акаунті Klaviyo першим плагін запускає наш клієнт; ви можете перевірити на своєму в 7-денному тріалі Pro. Журнал показує кожен запит і відповідь Klaviyo, і якщо Klaviyo відповість інакше, ніж у документації, виправимо оперативно.

Як це виглядає для покупця

Для покупця нічого не змінюється, окрім одного непомітного чекбокса. Він дивиться товари, кладе їх у кошик і переходить до оформлення. Щойно він дописав коректний e-mail, магазин фіксує Started Checkout — не на кожну літеру, тож у Klaviyo не з’являються профілі з обрізаними адресами. Якщо покупець пішов, лист про кинутий кошик приходить з посиланням, яке повертає саме його кошик: товари, варіації, кількість і купон, у будь-якому браузері й на будь-якому пристрої.

Чекбокс «Надсилайте мені новини й пропозиції» ніколи не відмічений заздалегідь, текст ви пишете самі. Хто його відмітив — потрапляє в обраний список Klaviyo з маркетинговою згодою (якщо список з double opt-in, Klaviyo спершу надішле лист-підтвердження). Хто не відмітив — отримує звичайні листи замовлення і нічого маркетингового.

Що отримує магазин

• Кинуті кошики, що повертаються. Started Checkout з повним кошиком і посиланням, що його відновлює, — основа флоу «кинутий кошик» у Klaviyo.
• Замовлення без дублів. Placed Order і Ordered Product ідуть із сервера за хуками WooCommerce, один раз на замовлення, скільки б разів платіжний шлюз не міняв статус. Сума — те, що заплатив покупець, у валюті замовлення.
• Сегменти, що працюють. У кожній позиції — ціна після знижок з податком і без, SKU, категорії, бренд, фото й посилання; у замовленні — купони, доставка, адреса. Профіль отримує ім’я, телефон у форматі E.164, адресу й мову замовлення.
• Доказ згоди. Відповідь покупця, час і точний текст чекбокса зберігаються в замовленні, а нотатка показує, чи пройшла підписка.
• Спокій за staging. Ключ прив’язаний до адреси сайту: копія бази на тестовому домені нічого не надсилає в бойовий Klaviyo, поки ви не підтвердите.

Що отримує адмін

Налаштування — у WooCommerce → Klaviyo. На вкладці «Connection» вставляєте приватний ключ і натискаєте «Check the connection»: плагін читає акаунт, сам підставляє публічний ключ і завантажує списки. Вкладка «Tracking» вмикає події, статуси, які рахуються оформленням, і режим згоди на cookie. «Consent» — список і текст чекбокса, його місце в класичному чекауті.

У кожному замовленні є бокс Klaviyo: що покупець відповів на чекбокси і що з цього замовлення вже пішло в Klaviyo. Там же можна вручну надіслати Placed Order, якщо замовлення створене до встановлення плагіна.

Вкладка «Queue & log» показує чергу і кожен виклик API за 30 днів: код відповіді, час, текст помилки Klaviyo. Кнопки «Надіслати зараз» і «Повторити невдалі», а «Скопіювати діагностику» збирає все, що потрібно нашій підтримці, без ключа.

Як це працює крок за кроком

1. У Klaviyo: налаштування акаунта → сторінка API keys → створіть приватний ключ (Full access або Custom з правами з FAQ).
2. Вимкніть офіційний плагін Klaviyo, якщо він стоїть.
3. Встановіть плагін, вставте ключ на вкладці «Connection» і натисніть «Check the connection».
4. На вкладці «Consent» оберіть список Klaviyo для чекбокса розсилки і, за бажання, свій текст.
5. Якщо на сайті є банер cookie — оберіть його на вкладці «Tracking» (WP Consent API, Complianz, Cookiebot або власний).
6. Оформіть тестове замовлення на справжню пошту (не example.com) і перевірте в Klaviyo: Analytics → Metrics → Placed Order, профіль покупця, підписку в списку.
7. Побудуйте флоу в Klaviyo на метриках Started Checkout, Viewed Product і Placed Order — плагін уже їх наповнює.

Pro: повний життєвий цикл замовлення і каталог

Pro додає Fulfilled Order (на обраному статусі, з трек-номерами), Canceled Order і Refunded Order — кожне повернення, часткові теж. Назви метрик — як у Klaviyo, а Canceled і перше повернення несуть той самий unique_id, що й Placed Order: так Klaviyo віднімає їх у пожиттєвій цінності клієнта (CLV).

Каталог товарів передає товари й варіації з ціною, залишком, фото й категоріями — для блоків товарів у листах, рекомендацій і флоу «знову в наявності». Зміна товару чи залишку йде в Klaviyo за хвилину, незмінене не надсилається повторно. Історія замовлень за 3–60 місяців надсилається з початковими датами і без запуску флоу: ніхто не отримає «дякуємо за замовлення» за торішню покупку.

Що під капотом

• Офіційний REST API Klaviyo, ревізія 2026-07-15 зафіксована в одному місці; Klaviyo підтримує ревізію два роки.
• Власна таблиця черги з унікальним ключем задачі + Action Scheduler: один хук, що спрацював двічі, не поставить у чергу друге замовлення. У кожної події стабільний unique_id, тож повтор не дає дубля в Klaviyo.
• 429 з Retry-After ставить на паузу всю чергу рівно на вказаний час і не витрачає спробу; 5xx і збої мережі — повтори з наростаючою паузою до 6 годин; відмова Klaviyo з його текстом лишається видимою в журналі.
• Згода на cookie: до згоди klaviyo.js не завантажується і cookie Klaviyo не ставиться.
• Мова покупця береться зі сторінок, які він переглядав, — тому блоковий чекаут через REST і класичний через wc-ajax дають правильну мову з Polylang і WPML.
• Фільтри PHP на кожну подію, позицію замовлення, профіль і товар каталогу.
• Видалення плагіна прибирає налаштування, чергу, журнал і збережені кошики; згоди в замовленнях лишаються — це доказ згоди магазину.

Як встановити

1. Завантажте zip кнопкою «Завантажити безкоштовно» вгорі сторінки.
2. WordPress → Плагіни → Додати новий → Завантажити плагін → оберіть klaviyo-connector-for-woocommerce-1.0.0.zip → Встановити → Активувати.
3. WooCommerce → Klaviyo → вставте приватний ключ → «Check the connection».
4. Для Pro: вкладка «Licence» → введіть ключ ліцензії або натисніть «Спробувати Pro 7 днів».