TikTok Events API

Перед тим, як налаштувати відстеження активності на вашому сайті Odoo, спочатку отримайте ідентифікатор пікселя та токен доступу для серверної інтеграції через API. Для цього виконайте наведені нижче кроки.

• 01
  Авторизуйтесь у вашому обліковому записі TikTok Ads Manager
• 02
  Перейдіть у меню Tools — Events Manager — Data Sources та натисніть Connect Data Source

• 03
  Оберіть Web як джерело даних

• 04
  Вставте URL вашого веб-сайту Odoo у відповідне поле або пропустіть цей крок

• 05
  Оберіть Manual Setup як спосіб підключення даних

• 06
  Виберіть TikTok Pixel + Events API як спосіб ручного підключення

• 07
  Дайте назву вашому пікселю

• 08
  На кроці Implement Evens API скопіюйте Pixel ID, натисніть Generate Access Token та також скопіюйте згенероване значення

Після встановлення модуля перейдіть до налаштувань веб-сайту та в розділі Enhanced Website Tracking увімкніть опцію Activate Tracking. Щоб перевірити відстеження веб-сайту та переглянути події відстеження в консолі браузера, також тимчасово активуйте функцію Debug Logging.

Модуль дозволяє відстежувати події електронної комерції на вашому сайті за допомогою сервісу відстеження. Він надсилає події відстеження в TikTok Ads Manager разом із інформацією про товари і наданими користувачами даними. Дані ви можете надсилати через TikTok Pixel та Events API. Додайте та налаштуйте сервіс відстеження для вашого веб-сайту Odoo.

Додавання сервісу відстеження

Перейдіть до меню Website – Configuration – Tracking – Services та натисніть New, щоб додати новий сервіс відстеження подій для вашого веб-сайту Odoo.

Спочатку заповніть наступні поля:

• Вкажіть Веб-сайт (якщо використовуєте кілька веб-сайтів)
• Виберіть Тип сервісу TikTok Pixel
• Вставте ваш Pixel ID в поле Key

Потім вкажіть тип ідентифікатора для товарів та категорію товарів, які надсилати до TikTok Ads Manager.

Якщо товари мають характеристики та варіанти, виберіть Product Variant ID у полі Item Type, якщо ні — виберіть Product Template ID.

Оберіть бажаний тип категорії (Category Type): публічну категорію електронної комерції (Public Category) або внутрішню категорію товарів (Product Category).

Наступна опція – Lead Value на вкладці Options. Встановіть грошову вартість генерації потенційного клієнта відповідно до ваших оцінок.

Активація API подій

Активація TikTok Events API потребує токена доступу та логування подій.

Збереження подій відстеження у внутрішніх журналах Odoo є обов’язковим для серверної інтеграції.

Увімкніть опцію Internal Logs на вкладці Options.

Після цього активуйте серверну інтеграцію в розділі API — увімкніть опцію Activate та вставте згенерований Access Token.

Як згенерувати токен доступу, дивіться в розділі Отримання Pixel ID та API Access Token.

Розширене зіставлення

Розширене зіставлення оптимізує ваші рекламні оголошення, надаючи TikTok Ads Manager дані про користувачів. Відкрийте вкладку Advanced Matching та зазначте, яку саме інформацію має надсилати сервіс відстеження. Кнопка Enable Allowed дозволяє увімкнути всі доступні опції для цього сервісу відстеження.

Увімкнена галочка Hashed навпроти опцій Customer Name, Email та Phone означає, що ця інформація про клієнтів захищена хешуванням відповідно до вимог TikTok.

Щоб отримати кращі результати, також увімкніть автоматичне розширене зіставлення (AAM) в налаштуваннях вашого джерела даних у TikTok Events Manager.

Сервіс відстеження надсилає події з внутрішнього журналу через TikTok Events API із заданим інтервалом.

Щоб переглянути внутрішні події відстеження, перейдіть до меню Website – Configuration – Tracking – Logs або натисніть кнопку Logs у верхній частині форми сервісу відстеження.

Увімкніть колонки State та API Sent Date, щоб відобразити статус та дату відправлення події до TikTok Ads Manager через Events API.

Автоматична відправка подій

Модуль автоматично надсилає події відстеження за допомогою запланованої дії Odoo. За замовчуванням вона виконує відправку кожні 30 хвилин, і цей інтервал можна налаштувати відповідно до ваших вимог.

Список запланованих дій знаходиться в меню Налаштування — Технічні налаштування — Автоматизація — Заплановані дії та доступний тільки в режимі розробника.

Щоб надіслати дані відстеження вручну, виберіть записи журналу подій відстеження зі списку або відкрийте одну подію і натисніть Send Event.

Очищення конфіденційних даних

Оскільки записи журналу подій відстеження можуть містити конфіденційні дані, такі як IP-адреси та агент користувача, можна налаштувати їх очищення. Перейдіть до налаштувань веб-сайту та вкажіть період очищення. За замовчуванням він становить 30 днів.

Увімкніть опцію Unlink Logs After Period для повного видалення записів журналу подій відстеження, давніших за вказаний період.

Рішення містить додаткові налаштування, які доступні в режимі розробника.

Ідентифікатор товару

Модуль використовує поле Product ID як унікальний ідентифікатор товару. Якщо потрібно використовувати інше значення, то на вкладці Technical вкажіть інше поле товару, яке містить бажаний ідентифікатор:

Вказане поле товару повинно містити непорожні значення і бути унікальним для кожного товару. В іншому випадку дані відстеження цього товару можуть бути непридатними для використання.

Покупка на порталі

Для відстеження покупок на порталі увімкніть опцію Track Purchase on Portal:

Виключити доставку

Наступним параметром, доступним для сервісів відстеження, є Exclude Delivery. Коли ця опція увімкнена, рядки доставки з замовлень на продаж не включаються до даних відстеження і не надсилаються через сервіс:

Виключити винагороди

Щоб виключити рядки замовлення з винагородою з даних відстеження увімкніть опцію Exclude Reward:

Додавання в кошик

За замовчуванням відстежується фактичне додавання товару до кошика. Якщо бажано відстежувати подію під час натискання кнопки, не чекаючи фактичного додавання товару до кошика, то виконайте такі дії:

• Перейдіть до меню Веб-сайт — Налаштування — Веб-сайти
• Відкрийте сайт на вкладці Enhanced Tracking
• Увімкніть опцію Add to Cart on Click

Відстеження фактичного додавання може не працювати, якщо логіку було змінено сторонніми модулями. У цьому випадку ця опція дозволяє відстежувати подію, прив'язавши її до селекторів кнопок, що використовуються у стандартних шаблонах веб-сайтів Odoo.

Покупка

Для відстеження покупки лише після успішної платіжної операції, увімкніть опцію Track Confirmed Purchases only:

Опція впливає лише на відправку події через сервіс відстеження, внутрішній лог фіксується в будь-якому випадку.

Якщо за вашою бізнес-логікою покупкою можна вважати замовлення зі статусом оплати В очікуванні, то увімкніть також опцію Track Pending Purchases too.

Перевірити серверну інтеграцію TikTok Events API можна за допомогою тестових подій. Для цього виконайте наведені нижче дії.

Спочатку відкрийте ваше джерело даних у TikTok Events Manager на вкладці Test Events та скопіюйте тестовий код.

Далі відкрийте ваш сервіс відстеження TikTok Pixel в Odoo на вкладці Options та вставте скопійований тестовий код у відповідне поле. Додатково увімкніть опцію Remove JS Script, щоб запобігти надсиланню подій до TikTok через Pixel-скрипт перед запуском API подій.

Тепер виконайте кілька дій на вашому сайті, наприклад, відкрийте список товарів або додайте товар у кошик.

Для тестування вийдіть з Odoo або використовуйте інший браузер, оскільки відстеження подій на веб-сайтах не працює для внутрішніх користувачів Odoo.

Після цього перейдіть до списку логів та відправте ці події вручну. Якщо статус — Warning або Error, перегляньте значення API Response на вкладці Technical, щоб отримати детальну інформацію.

Статус Sent означає, що подія успішно відправлена через API.

Поверніться до TikTok Events Manager та перегляньте наявність тестових подій у списку.

Після завершення тестування очистіть поле Test Code та вимкніть опцію Remove JS Script, оскільки поєднання браузерного та серверного відстеження подій підвищує продуктивність.