Klaviyo Connector для OpenCart — события, профили и подписки из магазина в Klaviyo

Klaviyo Connector для OpenCart — интеграция магазина на OpenCart 4, 3 или 2.3 с Klaviyo через официальный REST API. Модуль передаёт в Klaviyo то, на чём держатся флоу и сегменты: просмотры товаров, корзину, начало оформления со ссылкой, которая возвращает корзину, заказы с полным составом и профиль покупателя, а подписывает на рассылку только тех, кто сам поставил галочку. Магазин на WooCommerce — есть Klaviyo Connector для WooCommerce.

Честно о проверке. Песочницы у Klaviyo нет, поэтому модуль сделан по официальной документации Klaviyo API (revision 2026-07-15) и проверен сквозным тестом на симуляции этого API — форматы событий, подписок, каталога и ответы с ошибками сверены с документацией — на OpenCart 4.1 (PDO), 4.0.2.3, 3.0.5.0 и 2.3.0.2, на nginx с PHP-FPM и на Apache, рядом со штатным чекаутом и с CatCode One Page Checkout. На боевом аккаунте Klaviyo модуль ещё не запускали — проверьте на своём в 7-дневном триале Pro. Журнал показывает каждый запрос и ответ Klaviyo, и если Klaviyo ответит иначе, чем в документации, исправим оперативно.

Как это выглядит для покупателя

• Ничего лишнего на витрине. klaviyo.js загружается асинхронно, формы Klaviyo (всплывающие, встроенные) появляются так, как вы их настроили в Klaviyo. Страница никогда не ждёт Klaviyo: все запросы идут после того, как страница отдана.
• Согласие на рассылку — отдельной галочкой, не отмеченной. Где в чекауте уже есть штатная галочка рассылки OpenCart (OpenCart 4, One Page), именно она и есть согласие. Где её нет (гость в OpenCart 3 и 2.3) — наша галочка под полем e-mail, текстом на языке витрины; текст можно изменить для каждого языка.
• Брошенная корзина возвращается. В письме Klaviyo покупатель нажимает ссылку — и корзина с теми же товарами и опциями открывается даже на другом устройстве, 30 дней.
• Cookie — по правилам. Режим «ждать согласия на cookie» включает klaviyo.js только после согласия в Cookiebot, CookieYes или вашем баннере.

Что получает магазин

• «Сохранить и проверить» сверяет ключ с аккаунтом Klaviyo, подставляет публичный ключ для klaviyo.js и загружает все ваши списки. Ошибку Klaviyo модуль показывает понятным текстом с кодом ответа.
• Приватный ключ хранится в базе зашифрованным (AES-256 с HMAC), в форму больше не возвращается и не попадает в журнал.
• Placed Order и Ordered Product — из той же истории заказа, что и у самого OpenCart: штатный чекаут, One Page, колбэки оплат и смена статуса из админки дают событие один раз. Сумма — в валюте заказа, позиции с фото, ссылкой, категориями, брендом и опциями, отдельно скидка с кодом купона, налог, доставка, адреса.
• Started Checkout — со ссылкой на корзину и составом корзины, одно событие на покупателя и содержимое корзины за день, как только известен e-mail: покупатель вошёл или ввёл его на чекауте.
• Профиль покупателя: имя, телефон в формате E.164 по стране адреса, адрес и язык — в самом событии заказа. Телефон, который Klaviyo не примет, модуль отбрасывает, а событие всё равно отправляет.

• Очередь вместо запросов в момент покупки. Событие записывается в очередь и уходит после ответа страницы, фоновым запросом следующей страницы витрины или кроном. Лимит Klaviyo (429) — пауза ровно на столько, сколько просит Klaviyo, сбои сервера — повторы с нарастанием, отклонённый запрос оставляет ответ Klaviyo в журнале.
• Ключ без нужного разрешения (403) не останавливает всё: ждут только запросы этого типа, модуль пишет в админке, какое именно разрешение нужно, а остальные события идут дальше.
• Копия магазина на другом адресе (тестовый сайт, переезд) ничего не отправляет, пока вы не подтвердите, что это рабочий магазин.

Как это работает — шаг за шагом

1. Ключ. В Klaviyo: Settings → API keys → Create Private API Key (Full или Custom с доступом к Events, Profiles, Lists, Subscriptions, Catalogs и чтением Accounts).
2. Подключение. Расширения → Модули → Klaviyo Connector → «Подключение»: вставьте ключ, «Сохранить и проверить», выберите список для подписчиков.
3. Отслеживание и согласие. Вкладки «Отслеживание» и «Согласие»: какие события слать, режим cookie, текст галочки для каждого языка.
4. Флоу в Klaviyo. Метрики Started Checkout, Placed Order, Viewed Product появляются в Klaviyo с первыми событиями — на них строятся флоу брошенной корзины, после покупки и повторного просмотра.
5. Pro. Вкладки «Жизненный цикл заказа», «Каталог» и «История»: статусы для событий, синхронизация каталога, выгрузка прошлых заказов и подписчиков.

Что под капотом

• Klaviyo REST API, revision 2026-07-15: Create Event, Bulk Subscribe / Unsubscribe, Catalog items, variants и categories, Accounts, Lists. Авторизация заголовком Klaviyo-API-Key.
• Без дублей: у каждого события стабильный unique_id (префикс установки + номер заказа), поэтому повтор запроса или повторный вызов истории заказа не создаёт второго события в Klaviyo.
• Штатные события OpenCart: модуль слушает addHistory в OpenCart 4 и addOrderHistory в 3.x и 2.3, поэтому видит заказы из любого чекаута и любой оплаты, работающих через ядро.
• Сессию OpenCart модуль не пишет: состояние посетителя (e-mail, согласие, снимок корзины) — в собственной таблице, чтобы не перезаписать параллельные запросы чекаута.
• Pro-гейт без «кирпича»: когда триал закончился, останавливаются только Pro-функции.
• Удаление модуля убирает события, задания крона и права; таблицы модуля с копией настроек и ссылками восстановления корзины из уже отправленных писем остаются, поэтому обновление и переустановка ничего не теряют. Чтобы убрать данные полностью, удалите таблицы oc_cc_klaviyo_*.

Как установить

1. OpenCart 4: Расширения → Установщик → загрузите cc_klaviyo.ocmod.zip (имя архива не меняйте) и нажмите «Установить». OpenCart 3: Расширения → Установщик → cc_klaviyo-oc3.ocmod.zip, затем Расширения → Модификации → «Обновить». OpenCart 2.3: залейте содержимое папки upload/ из cc_klaviyo-oc23.ocmod.zip в корень магазина (FTP или файловый менеджер хостинга) — Установщик 2.3 без настроенного FTP файлы не копирует.
2. Расширения → Расширения → Модули → Klaviyo Connector → «Установить», затем «Редактировать».
3. «Подключение»: приватный ключ Klaviyo, «Сохранить и проверить», список для подписчиков, статус «Включено».
4. Для Pro: вставьте лицензионный ключ из письма после оплаты или нажмите «Начать 7-дневный триал» на вкладке «Лицензия».