Меню документації

OpenAI Ads (ChatGPT)

Керування згодою пікселя OpenAI (реклама в ChatGPT): увімкнення, черга oaiq, завантаження SDK лише після згоди та перевірка.

OpenAI Measurement Pixel (реклама в ChatGPT)

CookieHug може керувати згодою вимірювального пікселя OpenAI (oaiq) — пікселя конверсій для реклами, що показується в ChatGPT. Дві властивості цього пікселя роблять просте копіювання офіційного сніпета незаконним у ЄЕЗ:

  • піксель стартує з увімкненою згодою — без oaiq("consent", false) перед init він одразу надсилає дані,
  • події, надіслані за вимкненої згоди, відкидаються, а не ставляться в чергу — OpenAI не повторює їх після пізнішої згоди.

Функція типово вимкнена й вмикається для кожного домену окремо. CookieHug не потребує ідентифікатора пікселя — він створює чергу команд oaiq, бере на себе команду згоди та вирішує, *коли* завантажити SDK пікселя (oaiq.min.js).

Увімкнення

  • Відкрийте домен у панелі → Розширені → розділ Політика згоди.
  • Знайдіть картку OpenAI Measurement Pixel (реклама в ChatGPT) і ввімкніть перемикач — збереження автоматичне.
  • Зміна потрапляє до скрипта банера під час наступного завантаження (кеш скрипта: до 5 хвилин).
  • Сніпет CookieHug має стояти на сторінці перед сніпетом пікселя OpenAI.

Як працює сигнал

На старті SDK CookieHug створює заглушку черги window.oaiq і ставить на її початок запис згоди відповідно до рішення відвідувача. Офіційний сніпет пікселя починається з if (w.oaiq) return;, тож, побачивши нашу чергу, він лише додає свої виклики init і measure — а SDK OpenAI CookieHug завантажує лише тоді, коли є згода на категорію Маркетинг:

// старт без збереженого рішення — нічого від OpenAI не завантажується:
window.oaiq.q  // → [['consent', false]]

// сніпет сайту (після CookieHug) додає:
oaiq('init', { pixelId: '…' });
oaiq('measure', 'page_viewed');

// «Прийняти все» → CookieHugOnConsentReady:
window.oaiq.q  // → [['consent', true], ['init', …], ['measure', 'page_viewed']]
// і лише тепер на сторінку потрапляє https://bzrcdn.openai.com/sdk/oaiq.min.js

Завдяки цьому події, поставлені в чергу до рішення (зазвичай page_viewed), надсилаються після згоди, а не губляться. У разі відмови нічого від OpenAI не завантажується взагалі. При повторному візиті зі збереженою згодою SDK завантажується одразу на старті сторінки. Коли SDK уже працює, кожне наступне рішення надходить до нього як oaiq('consent', true | false) — відмова в редакторі зупиняє вимірювання, а відкликання перезавантажує сторінку. Джерелом сигналу є категорія Маркетинг, та сама, що керує ad_storage у Google Consent Mode.

Якщо ви керуєте згодою самостійно

За ввімкненого перемикача не викликайте oaiq("consent", …) з коду сайту — ця команда належить CookieHug. Якщо у вас уже є власна обробка (напр. схема: consent false → init → у слухачі CookieHugOnConsentReady consent true і повторне надсилання подій поточної сторінки), залиште перемикач вимкненим — ваш код працює, бо CookieHugOnConsentReady спрацьовує після кожного рішення та при повторних візитах зі збереженою згодою.

Якщо сніпет пікселя стоїть перед CookieHug, SDK OpenAI завантажує сніпет сайту. CookieHug усе одно ставить запис згоди на початок ще не обробленої черги, але вже не може відкласти завантаження SDK. Якщо піксель запускається через Google Tag Manager, використовуйте тригер, прив'язаний до маркетингової згоди — перемикач залишається безпечним, але момент завантаження визначає GTM.

Перевірка

У DevTools на сторінці з увімкненою функцією:

// одразу після входу (до рішення):
window.oaiq.q
// → [['consent', false], ['init', {…}], ['measure', 'page_viewed']]
// Вкладка Network: жодних запитів до bzrcdn.openai.com / bzr.openai.com

// після «Прийняти все»:
// → ['consent', true] на початку черги, у DOM з'являється <script src="…/oaiq.min.js">
window.oaiq.loaded   // → true, коли SDK замінив заглушку

Якщо window.oaiq не існує, перемикач ще не активний у скрипті (зачекайте на оновлення кешу) або сторінка завантажує старіший скрипт.