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 дней».