Опис
TikTok Events API - це серверне з'єднання для надання даних відстеження з Odoo до TikTok.
Події електронної комерції Odoo можна відстежувати за допомогою TikTok Pixel, а також за допомогою Events API. Це рішення дозволяє вам керувати тим, який метод з'єднання використовувати: з боку браузера, з боку сервера або обидва.
Встановлення |
Odoo Online
Odoo.sh
On Premise
|
---|---|
Сумісність |
Community
Enterprise
|
Технічна назва | website_sale_tiktok_capi |
Версія | 18.0.1.0.0 |
Ліцензія | OPL-1 |
Категорія | |
Підтримка | Допомога з встановленням та підтримка впродовж 60 днів, гарантований багфіксинг впродовж року |
Use Case
Jorem ipsum dolor sit amet, consectetur adipiscing elit. Nunc vulputate libero et velit interdum, ac aliquet odio mattis. Class aptent taciti sociosqu ad litora torquent per conubia nostra, per inceptos himenaeos.
Forem ipsum dolor sit amet, consectetur adipiscing elit. Nunc vulputate libero et velit interdum, ac aliquet odio mattis. Class aptent taciti sociosqu ad litora torquent per conubia nostra, per inceptos himenaeos.
Dorem ipsum dolor sit amet, consectetur adipiscing elit. Nunc vulputate libero et velit interdum, ac aliquet odio mattis.
It is a long established fact that a reader will be distracted by the readable content of a page
Korem ipsum dolor sit amet, consectetur adipiscing elit. Nunc vulputate libero et velit interdum, ac aliquet odio mattis. Class aptent taciti sociosqu ad litora torquent per conubia nostra, per inceptos himenaeos.
Korem ipsum dolor sit amet, consectetur adipiscing elit. Nunc vulputate libero et velit interdum, ac aliquet odio mattis.
Встановлення модуля Odoo
Завантаження модулів
Завантажте модулі з ZIP архіву на ваш сервер, де встановлена Odoo, або в GitHub репозиторій підключений до нього.
Розмістить розархівовані модулі у директорії з кастомними модулями та перезапустить системний сервіс Odoo.
Оновить список модулів
Після перезавантаження активуйте Режим розробника, та перейдіть до меню Додатки.

Натисніть на Оновити список додатків, щоб підтягнути нові модулі до списку.
Інсталяція модуля
Знайдіть модуль за його іменем та натисніть на Активувати, щоб інсталювати його.

* Якщо ви не бачите модуль, спробуйте видалити типовий фільтр Додатки у рядку пошуку.
Налаштування
Дотримуйтесь інструкцій в описі модуля, щоб завершити процес встановлення та почати користуватися застосунком.

Інструкція
TikTok Events API - це серверне з'єднання для надання даних відстеження з Odoo до TikTok.
Події електронної комерції Odoo можна відстежувати за допомогою TikTok Pixel, а також за допомогою Events API. Це рішення дозволяє вам керувати тим, який метод з'єднання використовувати: з боку браузера, з боку сервера або обидва.
Події, що надсилаються до TikTok, містять деталі про товар та замовлення, дані про клієнтів для розширеного зіставлення та ідентифікатор події для усунення дублювання.
Інструкція з налаштування модуля:
Налаштування в TikTok Увімкнення відстеження подій веб-сайту Налаштування в Odoo Розширене зіставлення Тестування Моніторинг











- contend_id
- contend_type
- contend_category
- contend_name
- description
- value
- price
- currency
- quantity
- event_id


Рішення очищає конфіденційні дані відстеження, такі як корисне навантаження, IP-адресу клієнта та агент користувача. Ви можете контролювати період, після якого виконується очищення. За замовчуванням це 30 днів.
Крім того, ви можете активувати опцію "Повністю видалити записи журналу, старші за вказаний період", щоб видалити всі внутрішні записи журналу відстеження після закінчення цього часу.
Якщо ви збираєтеся використовувати розширене зіставлення та надсилати імена клієнтів вашого веб-сайту в даних відстеження, вкажіть порядок імені та прізвища. Оскільки в деяких країнах ім'я партнера може починатися з імені, а в інших — з прізвища.
Натисніть на посилання «Керувати сервісами відстеження» або перейдіть до меню "Налаштування" - "Відстеження" - "Сервіси" і створіть новий сервіс відстеження подій для вашого веб-сайту Odoo.

Налаштуйте сервіс відстеження подій наступним чином:
- Вкажіть веб-сайт (якщо у вас середовище з кількома веб-сайтами).
- Виберіть тип сервісу "TikTok Pixel".
- Введіть свій TikTok Pixel ID у поле Ключ.
- Активуйте опцію "Внутрішні логи".
Внутрішнє логування є обов'язковою опцією для інтеграції TikTok Events API, його необхідно ввімкнути.
Крім того, воно забезпечує внутрішню аналітику відстеження подій. Щоб переглянути записи журналу, пов'язані з поточним сервісом, натисніть кнопку "Логи" у верхній частині форми.
- Активуйте опцію "API".
Згідно з інструкціями TikTok щодо веб-аналітики, рекомендується "налаштувати одночасно TikTok Pixel та Events API, щоб максимізувати ефективність вимірювання та результативність ваших кампаній".
Цей модуль Odoo реалізує таку поведінку за замовчуванням, але ви можете деактивувати скрипт TikTok Pixel на своєму веб-сайті за допомогою опції "Видалити скрипт JS Pixel".
У разі, якщо обидва види відстеження активні, рішення надсилає додатковий параметр Event ID для усунення дублювання на стороні TikTok.
Активуйте Автоматичне розширене зіставлення для вашого TikTok Events API в Odoo на вкладці "Розширене зіставлення".

Якщо ви дозволяєте гостям здійснювати покупки без реєстрації на порталі Odoo, це може призвести до нестачі даних про користувачів для розширеного зіставлення.
Вибравши опцію "Партнер з замовлення на продаж", ви можете доповнити дані про користувачів інформацією про клієнтів із їхніх замовлень на продаж.
Оскільки діяльність внутрішніх користувачів Odoo на веб-сайті не повинна відстежуватися, є кілька порад щодо тестування:
- Ви не побачите жодних внутрішніх журналів відстеження, якщо ви увійшли в Odoo і маєте права доступу внутрішнього користувача.
- Вам потрібно вийти з Odoo, або використовувати режим інкогніто чи інший браузер для тестування відстеження подій веб-сайту.
Після налаштування TikTok Conversion API, здійсніть оплату в Odoo eCommerce. Пройдіть всі етапи оформлення замовлення: від перегляду списку товарів, додавання товарів до кошика, початку процесу оформлення замовлення та завершення на сторінці підтвердження. Поверніться до Odoo та відкрийте логи сервісу відстеження подій TikTok, ви повинні побачити записи журналу відстеження для всіх подій eCommerce.

Виберіть TikTok Pixel у Events Manager і на вкладці Test Events скопіюйте код тестової події:

Вставте цей код у сервіс відстеження подій TikTok в Odoo.

Після цього виконайте кілька дій на своєму веб-сайті та надішліть ці події відстеження наступним чином:

У TikTok Ads Manager події з'являться у списку Event Activity.

Відстежуйте інтеграцію TikTok Events API за допомогою TikTok Ads Manager, щоб отримувати аналітичні дані та інформацію про ефективність і помилки.
Відкрийте Events Manager, перейшовши в меню "Інструменти" - "Керування" - "Події" та виберіть джерело даних.

Список змін
16.0.1.0.0 2024-06-04
- Init version.
17.0.1.0.0 2024-10-30
- Migration from 16.0.
18.0.1.0.0 2025-01-14
- Migration from 17.0.