TikTok Pixel і Events API для PrestaShop | PrestaDev
TikTok Pixel і Events API для PrestaShop | PrestaDev

TikTok Pixel Tracking Pro модуль для PrestaShop

Module version: 1.3.0

PrestaShop compatibility: 1.7.x 8.x 9.x

Файл модуля оновлено: 2026-10-10 18:39:51

Дані товару оновлено: 2026-10-10 18:40:04


TikTok Pixel Tracking Pro — це модуль PrestaShop для впровадження TikTok Pixel в інтернет-магазині. Після збереження ідентифікатора Pixel модуль завантажує код TikTok і обробляє стандартні події на сторінках товару, пошуку, кошика, оформлення замовлення та підтвердження замовлення. Реєструє ViewContent, Search, AddToCart, InitiateCheckout, AddPaymentInfo, Purchase та CompleteRegistration, при цьому Purchase готується виключно для замовлення, яке в PrestaShop отримало статус оплаченого. Опціональний TikTok Events API може передавати оплачені покупки із сервера з тим самим event_id, який використовує подія браузера. Адміністратор обирає ідентифікатор товару, сумісний із каталогом TikTok, а також може додати префікс. Модуль також дає змогу ввімкнути шлюз маркетингової згоди та опціональний Advanced Matching. Налаштування зберігаються окремо для кожного магазину в середовищі multistore.

Тип ліцензії / оновлення
119,00 zł
96,75 złnetto
Price history:

опис

Особливості та переваги модуля 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.

Деталі продукту

Підтримка Prestashop 9.x
Так
Підтримка Prestashop 8.x
Так
Підтримка Prestashop 1.7.x
Так
Модульні переклади
ПЛ. EN
Безкоштовна підтримка
Так
Безкоштовні оновлення (1 рік)
Так
Легко встановлюється
Так
PDTTP-FULL

Вам також може сподобатися

Changelog

Release history for this product. Expand an entry to see what changed.

  • dodano obsługę content API TIkTok-a

FAQ

Find answers to the most common questions about this product.

Модуль впроваджує TikTok Pixel у магазині PrestaShop і надсилає події, пов’язані з поведінкою клієнта та шляхом покупки. Після налаштування TikTok Pixel ID, коли налаштування згоди це дозволяють, він підтримує ViewContent, Search, AddToCart, InitiateCheckout, AddPaymentInfo, Purchase і CompleteRegistration. Модуль не створює каталог товарів TikTok, рекламні кампанії чи звіти в панелі TikTok Ads Manager.

Модуль завантажує TikTok Pixel і викликає page, а також обробляє ViewContent на сторінці товару, Search на сторінці пошуку, AddToCart після успішного оновлення кошика, InitiateCheckout на підтримуваній сторінці оформлення замовлення, AddPaymentInfo після зміни стандартного вибору способу оплати, Purchase для оплаченого замовлення, а також CompleteRegistration після створення облікового запису.

У конфігурації модуля введіть TikTok Pixel ID, виберіть тип ідентифікатора товару та за потреби префікс. Ви також можете ввімкнути Advanced Matching, вимогу маркетингової згоди, а також за бажанням вказати токен TikTok Events API. Pixel ID має походити з TikTok Ads Manager; у поле не слід вставляти код JavaScript.

Так, TikTok Events API є опціональною функцією, яка запускається після збереження токена доступу. Модуль надсилає через API виключно оплачену подію Purchase; решта стандартних подій обробляються TikTok Pixel у браузері. Вимкнення або видалення токена зупиняє лише серверне надсилання, а не базову роботу Pixel.

Якщо для даного оплаченого замовлення використовуються обидва канали, модуль створює детермінований event_id. Той самий event_id потрапляє до браузерного Purchase і до серверного Purchase, що надсилається через TikTok Events API, що дає змогу дедуплікації обох каналів надсилання.

Покупка ставиться в чергу лише тоді, коли замовлення досягає статусу, позначеного PrestaShop як оплачений. На сторінці підтвердження модуль може передати подію в браузері, а за налаштованого Events API може також надіслати її із сервера. У разі відкладеного підтвердження оплати сторінка підтвердження виконує обмежену повторну перевірку очікуваної покупки.

Так. Перемикач вимоги маркетингової згоди є необов’язковим і за замовчуванням вимкнений. Після його ввімкнення Pixel очікує на сигнал, переданий через інтеграцію менеджера згод за допомогою наданої функції або події JavaScript модуля, або на рішення активного PD Cookie Pro. Це технічна обробка стану згоди, а не самостійна система CMP чи гарантія правової відповідності.

Інтеграція вимагає активного PD Cookie Pro у версії 1.1.1 або новішій, а також коректно підписаного рішення щодо згоди. Рішення «all» надає згоду на відстеження та Advanced Matching, при цьому Advanced Matching має бути додатково увімкнений у конфігурації модуля. За власного вибору груп відстеження вимагає значення ad_storage, а Advanced Matching одночасно ad_storage і ad_user_data.

Advanced Matching за замовчуванням вимкнено. Після його ввімкнення та збереження маркетингової згоди модуль може передати для авторизованого клієнта правильну адресу електронної пошти та номер телефону до браузерного Pixel, але телефон використовується лише тоді, коли він вказаний в адресі доставки цього клієнта і вже має формат E.164. У серверному Events API електронна пошта та телефон нормалізуються і хешуються за допомогою SHA-256.

У конфігурації виберіть одне джерело content_id: ID товару, ID товару з комбінацією, артикул, EAN-13 або UPC. Ви також можете додати префікс. Вибране значення має точно відповідати ідентифікатору в каталозі TikTok; якщо для вибраного артикулу, EAN-13 або UPC товар не має значення, модуль пропускає цю позицію замість того, щоб замінити її ID товару.

CRON не потрібен для браузерного TikTok Pixel. Коли Events API налаштовано, модуль надає захищену токеном адресу CRON для повторних спроб у разі короткочасних помилок доставки серверної події Purchase; панель налаштувань рекомендує запускати його кожні п’ять хвилин.

Так. Налаштування модуля зберігаються окремо для кожного магазину, тому в режимі multistore перед налаштуванням потрібно вибрати конкретний магазин. У коді модуля задекларовано сумісність із PrestaShop від версії 1.7.0.0 до 9.99.99.

Відгуки (0)

Немає відгуків