Facebook Conversions API

Перед додаванням JS-скрипта на ваш сайт спочатку отримайте Pixel ID. Для цього виконайте такі кроки:

• 01
  Авторизуйтесь у акаунт Meta Ads Manager
• 02
  Перейдіть в меню Менеджер подій — Інтеграції — Meta Pixel


• 03
  У вікні оберіть існуючий набір даних або створіть новий
• 04
  Оберіть опцію Додати код пікселя Meta на сайт самостійно
• 05
  Пропустіть наступні кроки, натискаючи Далі

Перейдіть до розділу Набори даних та скопіюйте ідентифікатор:

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

Модуль містить функцію управління згодою на використання файлів cookie для Meta Pixel, яка інтегрована зі стандартною панеллю cookie Odoo. Щоб скористатися цією функцією, увімкніть Cookies Bar:

За замовчуванням надано всі згоди на використання файлів cookie від Meta. Щоб змінити це та скасувати згоду за замовчуванням для відвідувачів вашого веб-сайту, увімкніть опцію Facebook Pixel — Consent is Revoked (by default). Відтепер згода на використання файлів cookie від Meta надається після того, як відвідувач натисне Я згоден, і скасовується, якщо відвідувач натисне Тільки необхідні.

Для відправки подій електронної комерції до Meta Ads Manager спочатку додайте та налаштуйте сервіс відстеження для вашого веб-сайту Odoo.

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

Перейдіть до меню Веб-сайт – Налаштування – Відстеження – Сервіси та натисніть Новий, щоб додати новий сервіс відстеження подій:

Спочатку заповніть наступні поля в новому сервісі відстеження:

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

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

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

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

Наступна опція – Lead Value на вкладці Options:

Це грошова вартість генерації потенційного клієнта, яку слід встановити відповідно до ваших оцінок.

Налаштування API конверсій

Увімкніть опцію Internal Logs:

Внутрішнє логування є обов'язковою опцією для інтеграції через API.

Перед налаштуванням API на боці Odoo, спочатку отримайте токен доступу у Meta Ads Manager:

• 01
  Відкрийте набір даних на вкладці Налаштування
• 02
  Оберіть опцію Налаштування з API якості набору даних в розділі Conversions API
• 03
  Натисніть кнопку Згенерувати маркер доступу
• 04
  Скопіюйте маркер (токен) доступу

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

• Увімкніть опцію Activate
• Вставте скопійований ключ API конверсій у поле токен доступу

Функція Автоматичне зіставлення (Advanced Matching) оптимізує вашу рекламу в Meta, надаючи Facebook дані про користувачів. Увімкнути автоматичне зіставлення для подій Pixel потрібно з обох боків — як у Meta Ads Manager, так і в Odoo.

Активація в Meta Ads Manager

Перейдіть до Meta Ads Manager, відкрийте меню Набори даних і виберіть вкладку Налаштування для вашого набору даних:

Увімкніть опцію Автоматичне зіставлення із сайтом та вкажіть, яку інформацію про клієнтів слід передавати у Facebook.

Активація в Odoo

Поверніться до Odoo та відкрийте вкладку Advanced Matching у сервісі відстеження Facebook. Повторіть налаштування для даних користувачів, що надаються Facebook:

Інформація про клієнтів захищена хешуванням відповідно до вимог Meta та надсилається разом із даними відстеження товарів для підвищення ефективності роботи.

Джерело даних клієнтів

Використовуйте значення Sales Order Partner для джерела даних про клієнтів, оскільки воно надає більше деталей про користувача у випадку, якщо відвідувачам сайту дозволяється оформлення замовлення без реєстрації:

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

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

Заплановані дії

Події надсилаються періодично за допомогою запланованої дії. За замовчуванням вона виконується кожні 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.

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

Для перевірки інтеграції API конверсій Meta, виконайте наступні дії:

• 01
  Авторизуйтесь у акаунт Meta Ads Manager
• 02
  Відкрийте набір даних на вкладці Тестування подій
• 03
  Виберіть Сайт у списку каналів
• 04
  Відкрийте розділ Переконайтеся, що події вашого сервера налаштовано правильно
• 05
  Скопіюйте test_event_code

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

Виконайте кілька дій на вашому сайті Odoo, наприклад, відкрийте сторінку товару або додайте товар до кошика. Перейдіть до списку логів та відправте ці події вручну.

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

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

Поверніться до Meta Ads Manager та перевірте результат:

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