Dotdigital для OpenCart — контакти, замовлення й покинуті кошики

Dotdigital Sync для OpenCart 4.x, 3.x і 2.3 додає покупців, які погодилися на розсилку, у список вашого акаунта Dotdigital разом із записом згоди. Модуль створений для магазинів, що розсилають листи через Dotdigital, зокрема для Великої Британії.

Як це працює. Покупець ставить згоду при реєстрації, на сторінці розсилки в акаунті або галочкою на оформленні як гість. Модуль у фоні, вже після відповіді покупцеві, передає контакт у Dotdigital: імʼя, прізвище, список розсилки і запис згоди з текстом, часом, сторінкою, IP-адресою та браузером. Покупці без згоди у список розсилки не потрапляють.

Що бачить покупець

Нічого зайвого. Покупець реєструється, вмикає «Підписатися» на сторінці розсилки або ставить необовʼязкову галочку із текстом згоди на оформленні як гість. Сторінка відповідає одразу: відправка в Dotdigital іде у фоні після відповіді, тому повільна відповідь Dotdigital не гальмує магазин. Покупець без галочки нікуди не передається. Якщо покупець раніше відписався в самому Dotdigital, Dotdigital надсилає йому лист із підтвердженням, і лише після нього контакт знову підписаний. Контакти зі статусом жорсткого відскоку (hard bounce) модуль не чіпає.

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

Розширення → Модулі → Dotdigital Sync: вкладки «Connection», «Newsletter», «Customers and orders», «Abandoned carts», «SMS and events» і «Pro». У Dotdigital створіть API-користувача (Settings → Access → API users), вставте його адресу й пароль, і кнопка «Save and check the connection» покаже назву акаунта та знайдені списки. Регіон акаунта (r1, r2 або r3) модуль визначає сам; вручну його обирають, лише якщо Dotdigital вказав інший. Пароль зберігається зашифрованим і у форму не повертається.

Вкладка «Newsletter»: вибираєте список Dotdigital, вмикаєте опцію розсилки OpenCart і кнопкою «Create the consent box» створюєте необовʼязкову галочку для гостей та реєстрації. Текст згоди записується з кожною підпискою, тому тримайте його таким самим, як той, що бачить покупець. Підтвердження одинарне або подвійне (у другому випадку контакт лишається в очікуванні, доки не підтвердить лист Dotdigital). Коли покупець вимикає розсилку в акаунті, модуль відписує його від списку; сам контакт у Dotdigital залишається.

На сторінці замовлення зʼявляється блок Dotdigital: e-mail, згода на маркетинг, номер контакту в Dotdigital і таблиця відправок із станом кожної. Кнопка «Send contact» відправляє імʼя й поля даних покупця без зміни підписки, «Check in Dotdigital» показує стан контакту і його списки, у разі збою поруч зʼявляється «Retry». Усе, що модуль надсилає, іде в чергу: при відмові Dotdigital він повторює спробу, а при ліміті запитів ставить паузу до часу, який повідомив Dotdigital.

Pro передає замовлення в Insight data, у колекцію «orders» за обраними статусами: валюта замовлення, сума, купон і знижка, товари. Окремий список клієнтів і окремий список для кожної групи клієнтів, а також поля даних для сегментів: кількість замовлень, сума покупок, дата й сума останнього замовлення, останній статус, група (OC_ORDERCOUNT, OC_TOTALSPEND, OC_LASTORDERDATE, OC_LASTORDERTOTAL, OC_LASTSTATUS, OC_CUSTOMERGROUP). Кнопка створює ці поля в Dotdigital, а область замовлень можна обмежити тими, хто погодився на розсилку.

Покинуті кошики (Pro): якщо покупець із акаунтом залишив товари в кошику, після вашої затримки (від 15 хвилин до 7 днів) модуль записує кошик у колекцію «cartinsight» і записує контакт у вибрану активну програму Dotdigital, яка надсилає нагадування. Коли покупець купує, запис помічається як куплений. Гостей модуль не відстежує: e-mail гостя до замовлення магазину невідомий. SMS (Pro) надсилаються через SMS-канал вашого акаунта Dotdigital за статусом замовлення, за шаблоном із {firstname}, {order_id}, {status}, {store}, {total}; номер без коду країни доповнюється кодом за замовчуванням (07700 900123 стає +447700900123 для коду 44). Події статусів (Pro) додаються на стрічку контакту, коли в акаунті доступний імпорт подій на пакеті CXDP.

Наявні клієнти й замовлення (Pro) вантажаться одним фоновим запуском: спершу контакти пакетним імпортом, потім замовлення пакетним імпортом Insight data, зі станом виконання на вкладці й у журналі та кнопкою зупинки. В імпорт потрапляють лише ті, хто погодився на розсилку, а статус підписки модуль у пакеті не змушує.

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

1. Встановлюєте архів для своєї версії OpenCart і вмикаєте модуль.
2. У Dotdigital створюєте API-користувача й вставляєте його адресу та пароль на вкладці «Connection».
3. Натискаєте «Save and check the connection»: модуль показує акаунт і знаходить регіон.
4. На вкладці «Newsletter» вибираєте список, створюєте галочку згоди й задаєте текст згоди.
5. Покупці, які погодились, потрапляють у список зі записом згоди; блок Dotdigital на сторінці замовлення показує стан.
6. У Pro вмикаєте замовлення в Insight data, покинуті кошики, SMS і події, за потреби запускаєте імпорт наявних даних.

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

• Відправка йде після відповіді покупцеві; повільний або недоступний Dotdigital не гальмує магазин і не показує покупцеві помилок.
• Із кожною підпискою Dotdigital отримує запис згоди: текст, час UTC, сторінку, IP-адресу, браузер.
• Покупці без згоди ніколи не потрапляють у список розсилки; у Pro їх можна не передавати взагалі.
• Пароль API-користувача зашифрований і у форму не повертається; e-mail адреси в журналі налагодження приховані.
• При збої: повторні спроби, пауза при ліміті запитів, зрозуміла причина відмови Dotdigital у журналі.
• Запис Insight data для замовлення зберігає валюту замовлення; підсумки в полях для сегментів — у валюті магазину за замовчуванням.
• Події OpenCart без правок ядра; після видалення й повторного встановлення налаштування та журнал на місці.
• Інтерфейс модуля і тексти для покупця — англійською.

Обмеження

• Dotdigital робить новий контакт «підписаним» на рівні акаунта, якщо не вказано статус. Модуль не додає покупців без згоди у список розсилки, але розсилайте листи саме на список розсилки.
• Зміни розсилки, які адмін робить у «Клієнти → редагувати», у Dotdigital не передаються: синхронізується вітрина (реєстрація, сторінка розсилки, оформлення).
• Покинуті кошики — лише для покупців із акаунтом.
• Ключі записів Insight data мають бути унікальними в межах акаунта: якщо два магазини шлють в один акаунт, задайте їм різні префікси ключа.
• Поле даних, видалене в Dotdigital, модуль памʼятає до години; контакти, надіслані за цей час, зупиняються з поясненням, «Retry» працює після оновлення кешу.

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

1. Розширення → Встановлення: завантажте архів для своєї версії без перейменування файлу (OpenCart 4 — cc_dotdigital.ocmod.zip, 3.x — cc_dotdigital-oc3.ocmod.zip, 2.3 — cc_dotdigital-oc23.ocmod.zip).
2. Для 3.x і 2.3: Розширення → Модифікатори → Оновити.
3. Розширення → Модулі → Dotdigital Sync: встановіть і відкрийте.
4. Вставте API-користувача й пароль, натисніть «Save and check the connection», виберіть список на вкладці «Newsletter».
5. Для Pro: вставте ключ або запустіть пробний період на вкладці «Pro».