Стандартные события ChatGPT Ads: полный список и когда какое использовать
Таксономия событий измерения ChatGPT Ads
Каждая конверсия, которую вы отправляете в ChatGPT Ads - браузерным пикселем или серверно, - обязана использовать имя из таксономии событий OpenAI. Список короткий намеренно: двенадцать стандартных событий покрывают покупки, лиды, app-действия, просмотры контента и подписочные флоу, а тип custom впитывает всё, что таксономия пропустила. Имена событий идентичны в measurement-пикселе и в Conversions API - именно это делает возможной дедупликацию по event_id между двумя источниками. Ближайший аналог в экосистеме Meta - концепция стандартных событий, и рекламодатель, пришедший из Meta, узнает форму имен даже там, где детали расходятся.
Стандартные события и что означает каждое
OpenAI группирует таксономию по типам данных. События customer_action - это app_installed, app_opened, appointment_scheduled (запись на встречу, демо или консультацию), lead_created (лид-форма или запрос контакта) и registration_completed (регистрация аккаунта или на событие). События contents описывают шопинговую или контентную воронку: page_viewed для важных загрузок страниц, contents_viewed за просмотр конкретного продукта или единицы контента, включая интеракции после загрузки, items_added за добавление в корзину, checkout_started за начало чекаута и order_created за завершённую покупку. События plan_enrollment - trial_started и subscription_created: старт бесплатного триала и старт платной подписки. Для app-рекламодателей важно одно ограничение: app_installed и app_opened доступны только через Conversions API с action_source равным mobile_app - JavaScript-пиксель их не поддерживает.
Выбор единственного события, которое важно для oCPC
Цель oCPC оптимизирует доставку на одно отслеживаемое событие конверсии, задаваемое при создании кампании через bidding_type conversions с ровно одним активным событием-целью. Это ограничение превращает выбор события из бухгалтерии в стратегию: lead_created - цель лид-воронок, order_created - покупок, subscription_created - рекуррентной выручки. Ставить верх воронки вроде page_viewed целью оптимизации - значит учить аукцион покупать дешёвое внимание вместо результатов. Как цель сочетается с оплатой за клики, разобрано в гайде по oCPC в ChatGPT Ads.
Схемы данных: contents, customer_action, plan_enrollment, custom
Каждый объект данных события обязан нести поле type, совпадающее со схемой: contents, customer_action, plan_enrollment или custom. Денежные суммы подчиняются одному строгому правилу - целые числа в минорной единице ISO 4217 указанной валюты, то есть $129.99 уезжают как 12999 с currency: "USD", и при наличии amount валюта обязательна. Схема contents добавляет массив items, где каждый item поддерживает id, name, content_type (категория вроде product, plan или page), quantity целым числом, item-level amount и currency, плюс два поля, доступных только Conversions API и отбрасываемых JavaScript-пикселем: group_id для родительской группы продуктов и variant_dict для деталей вроде размера или цвета. Иллюстративный payload для order_created собирает всё вместе:
{
"type": "contents",
"amount": 12999,
"currency": "USD",
"contents": [
{
"id": "sku-1042",
"name": "Trail running shoes",
"content_type": "product",
"quantity": 1,
"amount": 12999,
"currency": "USD"
}
]
}
``` Для `plan_enrollment` предусмотрен опциональный `plan_id` рядом с денежными полями - так события триалов и подписок связываются с внутренним каталогом планов.
## Custom-события: запасной выход
<TldrSection>Тип custom забирает всё остальное - имя из строчных букв, подчёркиваний или дефисов, от 1 до 64 символов.</TldrSection>
Когда ни одно стандартное событие не подходит, включается тип `custom` с теми же денежными и item-полями, что и у стандартных схем. Само событие при этом использует встроенное имя `custom`, а ваш идентификатор едет в отдельном поле `custom_event_name`: строчные буквы, цифры, подчёркивания или дефисы, от 1 до 64 символов, без переиспользования встроенных имён. Стратегическая осторожность из всех CAPI-платформ применима и здесь - custom-события работают, но вокруг стандартных событий построены аукцион, отчёты и интеграции, поэтому стандартное событие, которое подходит примерно, обычно обыгрывает точное custom. Как то же напряжение решается на Meta и TikTok, показывает [кроссплатформенная матрица параметров](/guides/cross-platform-conversion-parameter-matrix).
## Маппинг событий Meta на ChatGPT Ads
<TldrSection>У большинства стандартных событий Meta есть прямой аналог в ChatGPT Ads - меняются имена, позиция в воронке не меняется.</TldrSection>
Для воронок, переезжающих с Meta, перевод почти один к одному: `PageView` становится `page_viewed`, `ViewContent` - `contents_viewed`, `AddToCart` - `items_added`, `InitiateCheckout` - `checkout_started`, `Purchase` - `order_created`, `Lead` - `lead_created`, `CompleteRegistration` - `registration_completed`, `Schedule` - `appointment_scheduled`, `StartTrial` - `trial_started`, а `Subscribe` - `subscription_created`. Прямых аналогов вовлечёнческих событий Meta вроде `AddToWishlist` или `Contact` в таксономии OpenAI нет - они уходят в `custom` или в ближайший функциональный матч. Не переводится вовсе пиксельная обвязка: идентификаторы, работа с токенами и ключи дедупа различаются, и Meta-сторону этого переезда разбирает [гайд по pixel и API токену](/guides/facebook-pixel-id-and-access-token).
## Отправка событий: пиксель и CAPI вместе
<TldrSection>Отправляйте одно событие через оба канала с общим event_id - и валидируйтесь до старта спенда.</TldrSection>
Штатная схема - двойная доставка: пиксель ловит браузерные события, а серверная доставка - ваша интеграция или тулза доставки - покрывает то, чего браузер не видит. Гонять оба канала без подготовки - значит задваивать конверсии, и лечится это дисциплиной общего `event_id` из [гайда по ChatGPT Ads conversion tracking](/guides/chatgpt-ads-complete-guide). MOST доставляет отслеженные конверсии серверно в ChatGPT Ads вместе с Meta, TikTok, Reddit, Snapchat и Pinterest, а бесплатный Pixel Activator валидирует одно событие на одиночном лендинге на [pixel.way2.us](https://pixel.way2.us) до запуска регулярной доставки.
<FAQ>
<FAQItem question="Сколько стандартных событий поддерживает ChatGPT Ads?">
Двенадцать стандартных плюс тип custom: пять событий customer_action, пять events contents и два plan_enrollment.
</FAQItem>
<FAQItem question="Какие события ChatGPT Ads работают только через Conversions API?">
app_installed и app_opened. Они требуют action_source равный mobile_app и не поддерживаются JavaScript-пикселем.
</FAQItem>
<FAQItem question="Как отправить денежную сумму вместе с событием?">
Целым числом в минорной единице ISO 4217 указанной валюты - 12999 означает $129.99 при currency равном USD. Валюта обязательна при наличии суммы.
</FAQItem>
<FAQItem question="Какое событие выбрать целью oCPC-кампании?">
Ровно одно активное стандартное событие на кампанию - обычно order_created для покупок, lead_created для лидгена или subscription_created для рекуррентной выручки.
</FAQItem>
<FAQItem question="Можно ли придумать собственное имя события в ChatGPT Ads?">
Да - событие уходит под встроенным именем custom, а ваш идентификатор кладётся в поле custom_event_name: строчные буквы, цифры, подчёркивания или дефисы, от 1 до 64 символов, без переиспользования встроенных имён.
</FAQItem>
</FAQ>
## Sources
<TldrSection>Все ссылки ниже ведут на официальную документацию OpenAI.</TldrSection>
<Sources>
- <a href="https://developers.openai.com/ads/supported-events" rel="nofollow">Supported Events - OpenAI Developers</a>
- <a href="https://developers.openai.com/ads/measurement-pixel" rel="nofollow">Measurement Pixel - OpenAI Developers</a>
- <a href="https://developers.openai.com/ads/conversion-optimized-campaigns" rel="nofollow">Conversion-Optimized Campaigns - OpenAI Developers</a>
</Sources>