Настройка интеграции с ChatGPT Ads (OpenAI)

Краткий обзор: ChatGPT Ads — рекламная платформа OpenAI и интегрированный партнер AppsFlyer . Настройте интеграцию, чтобы измерять и атрибутировать установки мобильного приложения, события внутри приложения и конверсии на веб-сайте, полученные из ваших кампаний ChatGPT Ads. 

Об интеграции с ChatGPT Ads

Интеграция AppsFlyer с ChatGPT Ads (OpenAI) позволяет измерять и атрибутировать установки приложений, события внутри приложения, события в приложении и конверсии на веб-сайте, полученные в результате ваших кампаний в ChatGPT Ads. Он поддерживает измерение как мобильного приложения, так веб-сайтов.

  • Мобильное приложение — AppsFlyer атрибутирует установки и повторные взаимодействия вашим кампаниям ChatGPT Ads, а также отправляет постбэки о событиях внутри приложения.
  • Веб-сайт — AppsFlyer передает веб-события (например, просмотры страниц, просмотры контента и покупки), зафиксированные с помощью Web SDK AppsFlyer , в Conversions API (CAPI) сервиса ChatGPT Ads — в дополнение к JavaScript-пикселю ChatGPT Ads (или вместо него).

Если вы также запускаете пиксель ChatGPT Ads на своем сайте, система ChatGPT Ads выполняет дедупликацию событий, передаваемых с сервера (CAPI), и событий пикселя на основе общего идентификатора события); благодаря этому вы можете запускать оба метода одновременно, не завышая при этом показатели конверсии .

Настройка интеграции

Настройте интеграцию отдельно для каждого мобильного приложения и веб-сайта, которые вы хотите измерять. Для каждого из них вам понадобятся ID пикселя и API -ключ из вашего аккаунта в Ads Manager ChatGPT Ads (OpenAI).

Обязательные требования:

  • Перед настройкой интеграция создайте аккаунт в ChatGPT Ads.
  • Ваши мобильное и веб-приложения настроены в AppsFlyer. Узнать больше

Для настройки интеграции:

  1. Чтобы активировать: В AppsFlyer в боковом меню выберите Сотрудничество > Партнерские интеграции > Marketplace .
    Чтобы отредактировать: В AppsFlyer в боковом меню выберите Сотрудничество > Партнерские интеграции > Активные интеграции .
  2. Настройте интеграцию для вашего:
  • Мобильное приложение — атрибуция установок, повторных взаимодействий и события в приложении кампаниям ChatGPT Ads.
  • Веб-сайт — передача событий веб-конверсии в Conversions API для ChatGPT Ads с дедупликацией данных относительно пикселя ChatGPT Ads.

Интегрируйте свое мобильное приложение

Чтобы настроить атрибуцию и постбэки событий в приложении для ChatGPT Ads, потребуются следующие действия в вашем мобильном приложении. 

Чтобы интегрировать ваше мобильное приложение:

  1. В AppsFlyer в боковом меню выберите Сотрудничество > Партнерские интеграции > Marketplace .
  2. Выберите свое мобильное приложение из выпадающего меню.
    Примечание: Вам потребуется повторить эти действия для каждой платформы, на которой работает ваше приложение (например, для версий на Android и iOS) .
  3. Найдите ChatGPT Ads (OpenAI) и нажмите «Интегрировать» .
  4. Выполните настройку на вкладках, как описано ниже.

Вкладка «Интеграция»

Активация партнёра

Чтобы активировать интеграцию:

Включите переключатель Активировать партнёра.

Важно! Переключатель должен оставаться включенным, пока вы работаете с ChatGPT Ads. Деактивация интеграции отключит атрибуцию и постбэки для ваших кампаний.
Подробнее об активации партнёров.

Общие настройки

Введите следующие учетные данные:

  • ID пикселя — пиксель создается в вашем ChatGPT Ads Manager. Получите его на вкладке «Конверсии» в вашем аккаунте Ads Manager.
  • Ключ API — ключ API необходим для аутентификации вызовов Events API . Получите его на вкладке «Конверсии» в вашем аккаунте ChatGPT Ads Manager. 
    Примечание: Убедитесь, что используете ключ конверсий API , а не ключ API для управления рекламой, поскольку требуемые права привязаны именно к ключу CAPI.

Обмен данными с расширенным сопоставлением: Включите передачу полей расширенного сопоставления — хэшированного email, номера телефона, имени и фамилии — в ChatGPT Ads, если эти поля включены в данные о событии, отправляемые в AppsFlyer. Более подробную информацию см. здесь: Обмен данными с расширенным сопоставлением.

Постбэки по умолчанию

Постбэк — это уведомление, передаваемое напрямую между серверами (server-to-server), которое AppsFlyer отправляет в ChatGPT Ads для отчета об атрибутированном событии (например, об установке или действии в приложении). В этом разделе отображаются ваши постбэки. Узнайте, как настроить постбэки для установки и реатрибуции .

Узнать больше о настройке постбэков по умолчанию .

Настройки внутренних событий приложения

Чтобы отправлять постбэки о событии в приложении в ChatGPT Ads, введите необходимые учетные данные:

  • ID пикселя:
  • Ключ API

Подробности см. в разделе «Общие настройки» выше.

Постбэки событий внутри приложения

Настройте отправку постбэков о внутреннее событие приложения, in-app событие в ChatGPT Ads. Узнать больше

Активируйте постбэки по событиям в приложении.

Включите переключатель постбэков для событий в приложении .

Окно постбэков по внутренним событиям

Определите период после установки, повторной атрибуции или повторного вовлечения, в течение которого AppsFlyer отправляет постбэки событий в приложении в ChatGPT Ads. Узнать больше

Составьте карту событий

Чтобы убедиться, что ваши события соответствуют аналогичным событиям в ChatGPT Ads, сопоставьте названия события. . Узнать больше

ChatGPT Ads поддерживает следующие стандартные события, а также любое пользовательское резервное событие, не включенное в список ниже:

Название события ChatGPT Ads Когда использовать
page_viewed Пользователь переходит на важную страницу или просматривает её.
contents_viewed Пользователь просматривает конкретный товар, объявление, статью или единицу контента.
items_added Пользователь добавляет один или несколько товаров в корзину, комплект или подборку.
checkout_started Пользователь начинает оформление заказа.
order_created Покупка завершена
registration_completed Пользователь завершает регистрацию учетной записи или событие.
lead_created Пользователь отправляет форму для сбора лидов или запрашивает обратную связь.
appointment_scheduled Пользователь записывается на встречу, заказывает демонстрацию или консультацию.
trial_started Начался бесплатный пробный период
subscription_created Начинается платная подписка.
app_opened Мобильное приложение открыто.
custom Любое событие, не охваченное стандартной таксономией.

Вкладка «Ссылки атрибуции»

ChatGPT Ads (OpenAI) поддерживают ссылки для атрибуции.

Выберите тип атрибуции

Решите, использовать ли ссылку атрибуции одной платформы или OneLink в качестве конечного URL, исходя из потребностей вашей кампании.

  • Если вы используете ссылку атрибуции для одной платформы, убедитесь, что конечный URL прозрачен, например af_r={store URL}.
  • Вы не можете настроить отдельную кампанию для каждой ОС, так как ChatGPT Ads не поддерживает нативный таргетинг на iOS или Android.
  • Если вы используете OneLink, ваша оценка качества может снизиться, что отразится на показах рекламы, поскольку процесс проверки объявлений в ChatGPT Ads включает сканирование конечного URL.

Рекомендуется: используйте целевую страницу в качестве места назначения рекламы, а также Smart Script или Smart Banner для перенаправления пользователя в App Store или Google Play.

Выберите параметр

Выберите параметры ссылки атрибуции, которые вы хотите включить.

  • Выберите параметры ссылки атрибуции, которые вы хотите включить (например, Название кампании и ID сайта), и установите окно ретроспективного учёта кликов (7 дней — это рекомендуемое AppsFlyer значение по умолчанию). AppsFlyer автоматически создает вашу атрибуционную ссылку для использования в кампаниях ChatGPT Ads.
  • Следующие параметры URL могут быть автоматически заполнены с помощью ChatGPT с использованием этих динамических макросов URL:
    • af_partner_account_id={ad_account_id}
    • af_c_id={campaign_id}
    • af_adset_id={ad_group_id}
    • af_ad_id={ad_id}
    • clickid={oppref}
  • Важно: Чтобы AppsFlyer мог захватить ID клика ChatGPT Ads и отправить его обратно в ChatGPT Ads, убедитесь, что вы используете clickid={oppref}, если ваши объявления ведут напрямую в App Store или Google Play. Когда целевая страница объявления использует Smart Script, убедитесь, что входящий oppref параметр сохраняется и сопоставьте его с clickid в исходящем URL.

  • Макросы поля названия не поддерживаются.

Примечание: Ваша сгенерированная ссылка содержит (ID интеграции ChatGPT Ads в AppsFlyer).

Подробнее о ссылках атрибуции.

Вкладка «Стоимость»

В настоящее время для ChatGPT Ads нет интеграции с API затрат. 

Вкладка «Доходы от рекламы»

Данные о доходах от рекламы невозможно получить из ChatGPT Ads. Используйте постбэки или сигналы UA для передачи данных о доходах с целью оптимизации кампании.

Вкладка «Разрешения»

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

Узнать больше о разрешениях .

Интегрируйте свой сайт

Используйте следующие шаги, чтобы настроить серверную пересылку событий на ChatGPT Ads для вашего сайта.

Для интеграции вашего сайта:

  1. В AppsFlyer в боковом меню выберите Сотрудничество > Партнерские интеграции > Marketplace .
  2. Выберите ваше веб-приложение из выпадающего меню.
  3. Найдите ChatGPT Ads (OpenAI) и нажмите «Интегрировать» .
  4. Завершите настройку на вкладке интеграция , как описано ниже.

Вкладка «Интеграция»

Активация партнёра

Чтобы активировать интеграцию:

Включите переключатель Активировать партнёра.

Важно! Переключатель должен оставаться включенным, пока вы работаете с ChatGPT Ads. Деактивация интеграции отключит пересылку события для вашего сайта.
Подробнее об активации партнёров.

Настройки внутренних событий приложения

Чтобы иметь возможность отправлять постбэки о событии в ChatGPT Ads, введите следующие учетные данные:

  • ID пикселя — пиксель создается в вашем ChatGPT Ads Manager. Получите его на вкладке «Конверсии» в вашем аккаунте Ads Manager.
  • Ключ API — ключ API необходим для аутентификации вызовов Events API . Получите его на вкладке «Конверсии» в вашем аккаунте ChatGPT Ads Manager.

Обмен данными с расширенным сопоставлением: Включите передачу полей расширенного сопоставления — хэшированного email, номера телефона, имени и фамилии — в ChatGPT Ads, если эти поля включены в данные о событии, отправляемые в AppsFlyer. Более подробную информацию см. здесь: Обмен данными с расширенным сопоставлением.

Постбэки событий внутри приложения

Настройте отправку постбэков о событии в ChatGPT Ads. Узнать больше

Чтобы включить постбэки события:

Включите переключатель постбэков для событий в приложении .

Составьте карту событий

Чтобы убедиться, что ваши события соответствуют аналогичным событиям в ChatGPT Ads, сопоставьте названия события. . Смотрите таблицу стандартных событий выше, чтобы узнать, какие события поддерживает ChatGPT Ads. Узнать больше

Вкладка «Ссылки атрибуции»

ChatGPT Ads (OpenAI) не использует внешние ссылки атрибуции для интеграции сайтов. Web SDK от AppsFlyer отслеживает веб-события и передает их напрямую в Conversions API ChatGPT Ads, поэтому настройка атрибуции на основе ссылок не требуется.

Вкладка «Стоимость»

Данные о стоимости недоступны для интеграций сайтов с ChatGPT Ads.

Вкладка «Доходы от рекламы»

Данные о рекламной выручке недоступны для веб-интеграций с ChatGPT Ads.

Вкладка «Разрешения»

Настройки разрешений недоступны для интеграции сайтов с ChatGPT Ads.

Характеристики и ограничения

Характеристика Описание
Поддерживаемые страны В настоящее время ChatGPT Ads поддерживает кампании только в следующих странах: США, Канада, Австралия, Новая Зеландия, Великобритания, Япония и Южная Корея. Мексика и Бразилия — скоро.