Особливості та переваги модуля TikTok Pixel для PrestaShop
- Впровадження TikTok Pixel з панелі PrestaShop: достатньо вказати TikTok Pixel ID у конфігурації модуля; не потрібно вручну вставляти код Pixel у файли теми.
- Підтримка шляху покупки: модуль реєструє події ViewContent, Search, AddToCart, InitiateCheckout, AddPaymentInfo, Purchase і CompleteRegistration у місцях, де доступні відповідні дані магазину.
- Контроль над подією покупки: Purchase ставиться в чергу після переходу замовлення в статус, позначений PrestaShop як оплачений, а не вже на самому початку оплати.
- Захист якості даних кошика: AddToCart надсилається після успішного оновлення кошика, а дані товару для цієї події беруться з поточного стану сервера.
- Відповідність каталогу TikTok: для товарних подій можна вибрати ID товару, ID товару з комбінацією, артикул, EAN-13 або UPC, а також застосувати спільний префікс ідентифікаторів.
- Опціональний TikTok Events API: модуль може передавати оплачені покупки також із сервера, не вимикаючи стандартне відстеження через TikTok Pixel у браузері.
- Спільний ідентифікатор події: браузерний і серверний Purchase використовують той самий детермінований event_id, щоб забезпечити дедуплікацію обох каналів надсилання.
- Налаштування для кожного магазину: у multistore кожен магазин може мати власний Pixel ID, токен Events API, тип ідентифікатора товару, префікс і налаштування згоди.
Найважливіші функціональності
- Запуск Pixel і виклик page: після виконання умов конфігурації та отримання згоди модуль завантажує бібліотеку TikTok Pixel і викликає page.
- ViewContent на сторінці товару: подія містить вибраний ідентифікатор товару, ціну, валюту, кількість і дані позиції, підготовлені з актуального товару.
- Search на сторінці пошуку: для непорожньої фрази модуль передає пошуковий запит у подію Search.
- AddToCart після підтвердження зміни кошика: скрипт реагує на успішне оновлення кошика PrestaShop і отримує дані події через захищений endpoint модуля.
- InitiateCheckout і AddPaymentInfo: модуль створює InitiateCheckout на підтримуваних сторінках checkout, а AddPaymentInfo — після зміни стандартного вибору способу оплати.
- CompleteRegistration: після створення облікового запису модуль ставить у чергу подію реєстрації та передає її на наступній підтримуваній сторінці клієнта.
- Purchase на сторінці підтвердження: модуль використовує дані оплаченого замовлення, зокрема позиції, вартість і валюту, а також призначає події детермінований event_id.
- Endpoint CRON для Events API: коли Events API налаштовано, модуль надає захищену токеном адресу для повторення короткочасних помилок доставки серверного Purchase.
Маркетингова згода та Advanced Matching
- Опціональний шлюз згоди: після ввімкнення вимоги маркетингової згоди Pixel не завантажується, доки інтеграція використовуваного менеджера згод не викличе надану функцію або JavaScript-подію модуля, або доки не буде розпізнано рішення PD Cookie Pro.
- Інтеграція з PD Cookie Pro: модуль розпізнає підписане рішення з активного PD Cookie Pro версії 1.1.1 або новішої. Згода «all» надає модулю дозвіл на відстеження та Advanced Matching, при цьому сама функція Advanced Matching усе одно потребує ввімкнення в конфігурації; власні групи потребують значення ad_storage для відстеження та ad_storage і ad_user_data для Advanced Matching.
- Advanced Matching за замовчуванням вимкнений: після його ввімкнення та отримання маркетингової згоди модуль може передати коректну адресу e-mail і номер телефону, збережений в адресі доставки цього авторизованого клієнта, якщо номер уже має формат E.164.
- Дані в Events API: у серверному Purchase e-mail і телефон нормалізуються та хешуються SHA-256 виключно тоді, коли Advanced Matching увімкнено і збережено маркетингову згоду.
- Технічний обсяг: модуль допомагає керувати роботою Pixel відповідно до стану згоди, але не замінює налаштування банера cookies, політики конфіденційності чи оцінки правових обов’язків адміністратора магазину.
TikTok Events API та надійність надсилання
- Добровільне серверне підключення: токен доступу до TikTok Events API є опціональним; без нього відстеження подій через браузерний TikTok Pixel і далі працює.
- Лише оплачені Purchase: Events API не надсилає повний список браузерних подій; серверне надсилання стосується виключно оплаченої покупки.
- Обробка транспортних проблем: короткочасні помилки можуть бути повторені через CRON, натомість відхилені дані або недійсні облікові дані не надсилаються повторно без кінця.
- Безпечні налаштування адміністратора: збереження нового токена Events API може відновити доставки, зупинені через помилку облікових даних, а перемикач дозволяє видалити токен і зупинити лише серверне надсилання.
Ідентифікатори товарів і каталог TikTok
- Вибір джерела content_id: доступні ID товару, ID товару з комбінацією, артикул, EAN-13 і UPC.
- Префікс ідентифікаторів: один опціональний префікс додається до кожного ідентифікатора, що передається в товарних подіях.
- Відповідність каталогу: вибраний ідентифікатор і префікс повинні точно відповідати значенням, використаним у каталозі товарів TikTok. Якщо для вибраного артикулу, EAN-13 або UPC значення відсутнє, модуль пропускає цю позицію замість заміни її іншим ідентифікатором.
Сумісність і multistore
- PrestaShop: модуль декларує сумісність із PrestaShop від версії 1.7.0.0 до 9.99.99.
- Multistore: конфігурація вимагає вибору конкретного магазину, завдяки чому налаштування відстеження не будуть випадково спільними між магазинами.
- Теми та checkout: модуль використовує фронтові hook-и PrestaShop, підтримує стандартний checkout і розпізнає вказані в коді контролери one-page checkout, зокрема TheCheckout, SuperCheckout і OnepageCheckout.