Мы постоянно публикуем обновления документации, которые могут быть недоступны на вашем языке. Наиболее актуальные сведения содержатся в версии на английском языке.

Межсерверная настройка CTV-CTV для партнеров SAN

Интеграция Adjust с CTV-CTV SAN позволяет оценить, насколько кампании, проводимые в сетях с самоатрибуцией, способствуют установке вашего приложения Connected TV (CTV).

Здесь представлена информация о том, как подключить Adjust к партнеру по сети с самоатрибуцией и отправить данные между серверами (S2S).

Перед началом работы

Следующие партнеры CTV-CTV действуют как сети с самоатрибуцией и требуют межсерверной настройки:

  • Amazon Fire TV
  • Roku Endemic Media
  • Vizio

Подробные сведения об интеграции

Межсерверную интеграцию Adjust с сетями с самоатрибуцией нельзя использовать в сочетании с Adjust SDK.

Adjust отправляет сети с самоатрибуцией данные обо всех установках вашего приложения, а SAN самостоятельно выполняет атрибуцию с использованием собственных данных о вовлеченности. Затем Adjust проверяет эти данные, чтобы подтвердить источник последнего вовлечения.

Решение для роста:
Измерения CTV-CTV доступны только для аккаунтов с CTV AdVision. Свяжитесь с вашим представителем в Adjust, если хотите узнать больше.

1. Добавьте приложение CTV

Чтобы измерить любую кампанию для приложения CTV, сначала нужно добавить приложение в панель управления Adjust.

Подробные инструкции по этому шагу см. в нашем руководстве по настройке приложения CTV.

2. Настройка сети

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

Чтобы активировать интеграцию, выполните в панели управления Adjust следующие действия:

  1. В разделе Campaign Lab выберите Партнеры.
  2. Нажмите Новый партнер.
  3. На экране Выбор партнера выберите свою сеть и нажмите Далее.
  4. На экране Выбор приложения выберите свое приложение и нажмите Далее.

Затем выполните действия, приведенные ниже, чтобы настроить параметры обмена данными. После этого просмотрите настройки и включите сеть для своего приложения.

Включение обмена данными

Обмен данными с сетями позволяет оптимизировать кампании. На экране Обмен данными необходимо предоставить учетные данные для конкретной сети, чтобы платформа Adjust могла начать обмен данными. Чтобы получить больше информации об учетных данных, необходимых для каждой сети, и о возможностях совместного использования, см. ниже.

Amazon Fire
Roku
Vizio
  • Идентификатор приложения Amazon. Идентификатор приложения указан в консоли разработчика Amazon. Следуя инструкциям Amazon, перейдите в раздел «Управление профилем безопасности», перейдите на вкладку «Веб-настройки» и скопируйте идентификатор приложения из полного идентификатора клиента.
    • Пример идентификатора клиента: amzn1.devportal.mobileapp.1234a5b67c8901d2e3456789012f3456
    • Пример идентификатора приложения: 1234a5b67c8901d2e3456789012f3456

После включения обмена данными Adjust по умолчанию начнет отправлять данные об установках и реатрибуциях из всех атрибутированных источников. Сюда относятся данные, атрибутированные Amazon Fire, данные, атрибутированные другим сетям, и органические данные. Кроме того, можно выбрать обмен следующими данными с Amazon Fire:

  • Сессии
  • События

Сопоставление событий

Под каждым событием в приложении, записанным Adjust, находится поле с раскрывающимся меню. Выберите из раскрывающегося меню предварительно заданное событие сети привязанное к событию Adjust. Настраиваемые события отправлять нельзя.

Amazon Fire
Roku
Vizio
  • Добавление в корзину
  • Начало рекламы
  • Окончание рекламы
  • Вовлечение приложения
  • Открытие приложения
  • Взаимодействие с баннером
  • Аутентификация кабеля
  • Взаимодействие с электронной почтой
  • Загрузка электронной почты
  • Взаимодействие с игрой
  • Загрузка игры
  • Реферал в приложении
  • Установка
  • Достижение уровня
  • Рекламная целевая страница
  • Другое
  • Приобретение продукта
  • Кнопка покупки
  • Кнопка подписки
  • Страница подписки
  • Возобновление подписки
  • Новая подписка
  • Начало исследования
  • Окончание исследования
  • Страница начала пробного периода
  • Начало пробного периода
  • Начало видео
  • Окончание видео
  • Взаимодействие с виджетом
  • Загрузка виджета

3. Межсерверная интеграция

Предупреждение:
Эта функция должна быть включена в Adjust. Для этого свяжитесь с вашим техническим аккаунт-менеджером или напишите на адрес support@adjust.com.

Настроив сеть на панели управления Adjust, можно настроить межсерверную интеграцию с Adjust. Таким образом, при помощи межсерверной интеграции API в Adjust направляются данные только о сессиях и событиях внутри приложения.

Поддерживаемые идентификаторы устройств

IDТип IDФормат
Amazon FireFIRE_ADIDНезакодированный рекламный идентификатор Amazon FireНижний регистр, с дефисами
Roku и VizioIDFA (идентификатор для рекламодателей)Необработанный рекламный идентификатор AppleВерхний регистр, с дефисами
GPS_ADIDНезакодированный рекламный идентификатор GoogleНижний регистр, с дефисами
FIRE_ADIDНезакодированный рекламный идентификатор Amazon FireНижний регистр, с дефисами
WIN_ADIDНезакодированный рекламный идентификатор WindowsБез дефисов
RIDAНеобработанный рекламный идентификатор Vizio
  • Пользователи устройств Vizio могут сбросить его в любое время или отключить, чтобы избежать таргетированной рекламы.
Нижний регистр, с дефисами
OAIDНеобработанный рекламный идентификатор HuaweiНижний регистр, с дефисами

Требования

  • Для получения подробной информации о требованиях к вашему решению in-app сверьтесь с контрольным списком атрибуции между серверами Adjust.
  • Все запросы к серверам Adjust должны выполняться в том же последовательном порядке, в котором они происходят на устройстве.
  • В запросах всегда указывайте os_name. Например:
    • android
    • ios
    • fire-tv
    • roku
    • Tizen
    • vizio

Отправка сеансов

Сеансы являются основой всей атрибуции и измерений в Adjust. Они срабатывают, когда пользователь возобновляет работу с приложением из фонового режима или открывает приложение.

Для отправки сессий Adjust используйте наш API межсерверных сессий (S2S).

Конечная точка: https://s2s.adjust.com/session

Отправка событий в приложении

Для отправки Adjust данных о событиях в приложении используйте наш API межсерверных событий (S2S).

Конечная точка: https://s2s.adjust.com/event

4. Экспорт данных

Структура отчета

Amazon Fire
Roku
Vizio
  • Сеть = Amazon
  • Кампания = campaign_name
  • Рекламная группа = ad_name
  • Креатив = creative_id

Чтобы получить доступ на уровне устройства к данным, отправляемым в BI-системы для анализа, настройте экспорт сырых данных.

Плейсхолдеры

Можно использовать следующие плейсхолдеры для получения конкретных точек данных сети в файлах экспорта сырых данных.

Amazon Fire
Roku
Vizio
ПлейсхолдерОписание
{fire_adid}Рекламный идентификатор Fire OS

Данные, не передаваемые из кампаний Amazon

В соответствии с нашим юридически оформленным соглашением с Amazon, Adjust не предоставляет сырые данные о кампаниях Amazon по некоторым видам деятельности. В том числе данные, экспортируемые как в виде колбэков сервера, так и через загрузку в облачное хранилище. Затронутые виды деятельности:

  • Клики
  • Показы
  • Клики SAN
  • Просмотры SAN

Не затрагиваются следующие сервисы:

  • Способность Adjust измерять количество кликов, показов, кликов самоатрибутируемой сети и показов самоатрибутируемой сети.
  • Отчеты об агрегированных кликах и показах.
  • Получение агрегированных данных о кликах и показах посредством Сервиса отчетности.
  • Отчетность и экспорт сырых и агрегированных данных по установке и после установки, атрибутированных к Amazon Fire.

При возникновении вопросов обращайтесь к представителю Amazon.