Odoo OpenAI Ads Conversions API

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

• Увійдіть у свій акаунт OpenAI Ads Manager
• Відкрийте меню Settings — Conversions
• Натисніть Create, щоб додати джерело даних
• На вкладці Data Source відкрийте одне з джерел та скопіюйте Pixel ID

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

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

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

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

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

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

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

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

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

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

Активація API конверсій

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

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

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

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

Як і Pixel ID, отримайте ключ API конверсій у розділі Conversions вашого акаунту OpenAI Ads Manager.

Розширені конверсії

Розширені конверсії оптимізують ваші рекламні оголошення, надаючи OpenAI дані про користувачів. Відкрийте вкладку Advanced Matching та натисніть кнопку Enable allowed, яка дозволяє увімкнути всі доступні опції для цього сервіса відстеження:

Дані користувачів надсилаються у захищеному вигляді, оскільки вони хешуються відповідно до вимог OpenAI.

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

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

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

В рамках інформації про подію, через Conversions API відправляються наступні дані користувачів:

• OpenAI OppRef (oppref): унікальний ідентифікатор кліку або рекламного перенаправлення з ChatGPT
• User IP Address: IP адреса користувача для визначення географії цільової аудиторії
• User Agent: фіксує операційну систему, браузер та тип пристрою користувача

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

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

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

• 01
  Зайдіть на ваш сайт з іншого браузера та виконайте якусь дію, наприклад, додавання товару до кошика. Таким чином створюється внутрішній запис у журналі подій сервісу відстеження.
• 02
  Далі поверніться до списку подій та відправте цю подію, натиснувши кнопку Send event:

Після надсилання статус події може змінитись на Warning або Error у разі відсутності даних або з інших причин. Відкрийте вкладку Technical та отримайте детальну інформацію в полі API Response:

Якщо статус події Sent, це означає, що відправка з Odoo через API була успішною.

Наступним кроком є перевірка отримання події відстеження на боці OpenAI. Для цього:

• Авторизуйтесь у Ads Manager
• Перевірте чи з’явилась відправлена подія з Odoo
• Якщо подія з’явилась, перегляньте колонку Source (браузер/сервер)
• Усунення дублювання подій відбувається за допомогою параметра Event ID