Межсерверная настройка 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 следующие действия:

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

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

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

Обмен данными с сетями позволяет оптимизировать кампании. На экране Обмен данными необходимо предоставить учетные данные для конкретной сети, чтобы платформа 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 Fire	FIRE_ADID	Незакодированный рекламный идентификатор Amazon Fire	Нижний регистр, с дефисами
Roku и Vizio	IDFA (идентификатор для рекламодателей)	Необработанный рекламный идентификатор 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-os
- Tizen
- smart-cast

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

Сеансы являются основой всей атрибуции и измерений в 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.