Ready2GEO Реклама в ChatGPT

Pixel ChatGPT Ads и Conversions API: настройка отслеживания конверсий

Последнее обновление: 24 августа 2026 года, проверено по официальной документации OpenAI. Названия событий и параметров, приведённые здесь, взяты из документации для разработчиков OpenAI и могут измениться в ходе беты.

Без измерения конверсий кампания ChatGPT Ads остаётся слепой: вы знаете, сколько тратите, но не знаете, что получаете. И главное, вы не можете включить оптимизацию под конверсии. На этой странице разобраны оба официальных метода, браузерный pixel и серверный Conversions API, и то, как заставить их работать вместе. Общая картина есть в нашем гайде ChatGPT Ads.

2 мин чтения

J Josh Эксперт по SEO и GEO в Ready2GEO

ИИ-системы, релевантные для этой страницы

ChatGPT

2 официальных источника измерения: JavaScript pixel и серверный Conversions API

Почему измерение является требованием, а не опцией

Три причины, одна из них блокирующая:

Блокирующая: оптимизация под конверсии (oCPC) требует, чтобы отслеживание уже было настроено, через JavaScript pixel, Conversions API или оба сразу. Без сигнала системе нечего оптимизировать.
В отчётности Ads Manager есть столбец конверсии, который остаётся пустым, если ничего не подключено.
Расчёт вашей стоимости привлечения полностью зависит от этих данных: без них вы управляете по CPC, то есть по расходу, а не по результату.

Общий принцип, заданный OpenAI, простой: вы создаёте источник данных (data source) в Ads Manager, а затем отправляете в него конверсионные события через pixel, API или оба канала.

Pixel или Conversions API: что выбрать?

	JavaScript pixel	Conversions API
Где выполняется	В браузере посетителя	Только на вашем сервере
Внедрение	Скрипт, который нужно разместить в head	Разработка на стороне бэкенда
Надёжность	Чувствителен к блокировщикам и ограничениям браузера	OpenAI описывает его как более надёжный источник, чем один только pixel
Рекомендация OpenAI	Точка старта	Использовать, когда это возможно, ради более точных данных

Прагматичный ответ не «одно или другое», а «оба, с дедупликацией». Pixel ставится за час и сразу оживляет кампании; API подключается следом и надёжно закрепляет измерение.

Установка измерительного pixel

Измерительный pixel ChatGPT Ads является браузерным SDK, предназначенным для измерения событий вашего сайта, которые можно отнести к рекламе в ChatGPT. Скрипт загружается асинхронно с https://bzrcdn.openai.com/sdk/oaiq.min.js, размещать его нужно в секции <head>, после чего он инициализируется с вашим идентификатором pixel:

oaiq("init", { pixelId: "ВАШ-PIXEL-ID" });

Параметр pixelId обязателен, он создаётся в Ads Manager. Необязательный параметр debug выводит активность SDK в консоль браузера, что удобно на этапе приёмки.

Дальше всё измерение идёт через одну команду: oaiq("measure", eventName, eventData, options).

Стандартные события, пользовательские события и их ограничения

Каждое стандартное событие ожидает объект данных, у которого поле type должно соответствовать событию. Документация для разработчиков OpenAI группирует их так:

Группа	События	Ожидаемое поле type
Коммерция	order_created, items_added, checkout_started	contents
Контент	page_viewed, contents_viewed	contents
Лиды и регистрации	lead_created, registration_completed, appointment_scheduled	customer_action
Подписки	subscription_created, trial_started	plan_enrollment

Для событий типа contents в число документированных полей входят amount, currency и массив contents, состоящий из записей с полями id, name, content_type и quantity. События типа plan_enrollment ожидают plan_id. Документация уточняет, что для amount и quantity нужно использовать целые значения.

Когда ни одно стандартное событие не подходит, пользовательское событие объявляется через третий аргумент и объект опций:

oaiq("measure", "custom", { type: "custom" }, { custom_event_name: "quote_requested" })

Имена пользовательских событий должны подчиняться строгим правилам: от 1 до 64 символов, только буквы, цифры, нижние подчёркивания и дефисы, причём начинаться и заканчиваться они должны буквенно-цифровым символом.

Обратите внимание на структурное ограничение: пользовательское событие не может служить целью оптимизации oCPC. Если оптимизацией должна управлять ваша бизнес-конверсия, её нужно передавать как стандартное событие.

Подключение Conversions API на стороне сервера

API используется исключительно с вашего сервера. Документированные пункты внедрения:

Вы создаёте веб-источник конверсий и его Pixel ID через точку входа POST /conversions/pixels.
Вы генерируете ключ, способный отправлять серверные события от имени текущего рекламного аккаунта.
Этот ключ должен храниться в серверном менеджере секретов. Документация категорична: никогда не помещайте его в браузерный код, в переменные окружения, видимые на клиенте, в логи или в репозиторий кода.
API принимает пакеты до 1 000 событий. Критический момент для вашей обработки ошибок: если хотя бы одно событие пакета не проходит, падает весь пакет.

Это последнее правило стоит учесть уже на этапе проектирования: пакет, целиком отклонённый из-за неверно сформированного поля в одном заказе, может стереть из вашей отчётности 999 корректных конверсий.

Дедупликация pixel и API: правило, которое нельзя пропустить

Если вы отправляете одну и ту же конверсию и из pixel, и из Conversions API, системе нужно об этом сообщить, иначе вы посчитаете её дважды. Документированный метод:

Использовать одно и то же значение как id на стороне API и как event_id на стороне pixel.
Отправлять оба события с одним и тем же Pixel ID.
Для пользовательских событий использовать одинаковый custom_event_name с обеих сторон.

На стороне pixel это выглядит так: oaiq("measure", "order_created", {...}, { event_id: "order_12345" }). Сопоставление опирается на Pixel ID, имя события и event_id; для пользовательского события в этой логике вместо имени события используется custom_event_name.

На практике: используйте свой идентификатор заказа или лида как ключ дедупликации, это единственное значение, естественным образом доступное с обеих сторон.

oppref: его нужно не просто захватить, а сохранить до конверсии

Pixel захватывает oppref, референс клика от OpenAI, и сохраняет его в собственном cookie первого уровня (__oppref). Одного лишь захвата недостаточно: официальная документация настаивает на пункте, который упускают многие внедрения, oppref должен сохраняться через редиректы и навигацию вплоть до страницы, где конверсия действительно измеряется. Платёжная воронка, проходящая через платёжный поддомен, редирект после формы или корзина, которая меняет домен, теряют cookie по пути, если не предусмотреть его передачу.

Второй часто упускаемый момент: Conversions API не захватывает oppref за вас, в отличие от pixel. Если вы вызываете API на стороне сервера, ваш код сам должен найти значение oppref (обычно записанное pixel в cookie или переданное параметром URL) и явно включить его в вызов, когда оно доступно. Без этого шага событие, отправленное только через API, теряет связь с предшествовавшим рекламным кликом.

Архитектура, рекомендуемая OpenAI, состоит из трёх частей: pixel на каждой странице для захвата oppref и лёгких событий, Conversions API для ценных событий, отправляемых с вашего бэкенда (там, где у вас есть заказ и где вызову ничто не может помешать), и оба канала отправляют одну и ту же конверсию с одинаковым event_id.

Автоматический advanced matching

Автоматический advanced matching (AAM) служит для того, чтобы связать конверсии с вашими объявлениями, когда никакой идентификатор клика недоступен. Pixel автоматически определяет распознаваемые данные клиента в формах и других источниках вашего сайта, нормализует их и хеширует по SHA-256 прямо в браузере. Документация уточняет, что никакие сырые данные не передаются.

Вы также можете сами передать хешированные идентификаторы в объекте user при инициализации: email_sha256, phone_number_sha256, external_id_sha256, first_name_sha256, last_name_sha256, а также нехешированные поля country, city, region и postal_code.

Эта функция затрагивает персональные данные: её включение нужно согласовать с вашим ответственным за защиту данных, особенно в Европе.

Согласие, GDPR и управление pixel

SDK предоставляет команду согласия, которую нужно вызывать до инициализации, чтобы блокировать измерение, пока пользователь не дал согласия:

oaiq("consent", false);, затем oaiq("init", { pixelId: "..." });, затем oaiq("consent", true); после получения согласия.

Два момента, которые нужно запомнить. Во-первых, согласие по умолчанию равно true, если оно явно не выставлено в false и если не зафиксирован отказ: значит, на европейском сайте нужно явно вызывать oaiq("consent", false) заранее, а не полагаться на поведение по умолчанию. Во-вторых, когда значение равно false, измерительные события не отправляются.

Кроме того, параметр opt_out позволяет исключить событие из персонализации на уровне пользователя; его значение по умолчанию равно false. SDK также работает с идентификатором, уважающим приватность, oppref, который захватывается из URL и сохраняется в cookie __oppref.

Напоминание о контексте: персонализированная реклама на запуске недоступна в Европейской экономической зоне и в Швейцарии. Это никак не освобождает от работы с согласием на само измерение.

Content Security Policy: домены, которые нужно разрешить

Самая частая причина тихого отказа на сайтах со строгой CSP: SDK блокируется ещё до инициализации. Документированные директивы:

Директива	Разрешаемый источник	Роль
script-src	https://bzrcdn.openai.com	Загрузка SDK
connect-src	https://bzr.openai.com и https://bzrcdn.openai.com	Отправка и получение событий
img-src	https://bzr.openai.com	Резервный вариант через запрос изображения

Если pixel ничего не передаёт, хотя код на месте, откройте консоль с включённым параметром debug: ошибка CSP появится там сразу.

Чего pixel делать не умеет

Явное ограничение, о котором нужно знать до проектирования плана разметки: измерительный pixel не поддерживает события app_installed и app_opened. Эти события нужно отправлять со стороны сервера, через Conversions API.

Кроме того, OpenAI документирует интеграции с партнёрами по измерению, включая партнёров по мобильной аналитике (MMP), для рекламодателей, чья конверсия происходит внутри приложения.

Ещё один момент внимания: использование нескольких Pixel ID на одном сайте требует особой конфигурации, которая документируется OpenAI отдельно.

Атрибуция: что засчитывается и как

OpenAI оценивает конверсионные события с учётом событий, настроенных для вашей кампании, и применимого окна атрибуции. Два правила, которые нужно знать:

Атрибуция после клика (post-click) использует настроенное окно клика.
Конверсии после показа (view-through) используют фиксированное окно в один день после засчитанного показа, независимое от вашего окна клика.

И правило чтения, которое спасает от ошибок в расчётах: основной столбец Конверсии содержит только конверсии после клика. Конверсии после показа являются отдельной дополнительной отчётностью, которую, по словам OpenAI, нельзя прибавлять к конверсиям и нельзя использовать для базовых метрик эффективности вроде CPA.

Чек-лист приёмки перед запуском

Источник данных создан в Ads Manager, Pixel ID получен.
Скрипт загружается в head, инициализация вызывается с правильным Pixel ID.
Согласие подключено до инициализации на европейских сайтах.
Стандартные события срабатывают в нужных местах, с правильным полем type.
Дедупликация настроена, если вы дублируете отправку через API: одно значение в id и event_id, один Pixel ID.
CSP обновлена по всем трём директивам.
Режим debug включён на время приёмки, потом отключён.
Посадочная страница доступна для OAI-AdsBot: заблокированная страница может привести к отклонению объявления независимо от качества разметки. Наш чекер посадочной страницы ChatGPT Ads проверяет этот пункт.
Ровно одно активное стандартное событие выбрано как цель, если вы нацелены на oCPC, с учётом того, что после создания кампании изменить его будет нельзя.

Частые вопросы

Обязательно ли отслеживание конверсий в ChatGPT Ads?

Для показов по CPM или CPC нет, но для оптимизации под конверсии да: oCPC требует, чтобы отслеживание уже было настроено через JavaScript pixel, Conversions API или оба сразу, и чтобы целью служило активное стандартное конверсионное событие.

Забирает ли Conversions API значение oppref самостоятельно?

Нет. Только pixel автоматически захватывает oppref, референс клика от OpenAI, и сохраняет его в cookie. Вызов Conversions API должен явно включать его, когда оно доступно: искать его должен ваш код, API этого за вас не делает. Именно поэтому OpenAI рекомендует использовать pixel и API вместе, а не одно вместо другого.

Нужно ли выбирать между pixel и Conversions API?

Нет, оба могут сосуществовать. OpenAI описывает Conversions API как более надёжный источник, чем один только pixel, и рекомендует использовать его, когда это возможно. Если вы отправляете одну и ту же конверсию с обеих сторон, её нужно дедуплицировать.

Как не посчитать конверсию дважды?

Использовать одно и то же значение как id на стороне API и как event_id на стороне pixel, отправлять оба события с одним и тем же Pixel ID и использовать одинаковый custom_event_name с обеих сторон для пользовательских событий.

Может ли пользовательское событие быть целью oCPC?

Нет. Документация уточняет, что пользовательские события не могут быть целями оптимизации oCPC. Целью должно быть ровно одно активное стандартное конверсионное событие, и после создания кампании изменить его уже нельзя.

Уважает ли pixel согласие пользователя?

SDK предоставляет команду согласия. Что важно знать: согласие по умолчанию равно true, если оно явно не выставлено в false и если не зафиксирован отказ. Значит, на европейском сайте нужно явно вызвать команду со значением false до инициализации, а после получения согласия переключить её в true.

Мой pixel ничего не передаёт, что проверить первым делом?

Content Security Policy. SDK нужны https://bzrcdn.openai.com в script-src, https://bzr.openai.com и https://bzrcdn.openai.com в connect-src и https://bzr.openai.com в img-src. Включите параметр debug при инициализации, чтобы увидеть ошибку в консоли.

Как измерить установку приложения?

Не с помощью pixel: он не поддерживает ни app_installed, ни app_opened. Эти события нужно отправлять со стороны сервера через Conversions API. OpenAI также документирует интеграции с партнёрами по мобильной аналитике.

Какое используется окно атрибуции?

Атрибуция после клика использует настроенное окно клика. Конверсии после показа используют фиксированное окно в один день после засчитанного показа, независимое от окна клика, и отражаются отдельно от основного столбца Конверсии.

Проверьте свой сайт за 30 секунд

Оценка SEO, оценка GEO, производительность и адаптивность: 49 технических проверок, мгновенный вердикт по AI Overviews.

Запустить тест SEO и GEO