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

Настройка RTB House

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

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

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

Требования

iOS | Android | Windows | Unity | React Native | Flutter | Adobe Air | Cordova | Marmalade | Xamarin | Cocos2d-x | Titanium | Corona

Выберите RTB House и свое приложение в Campaign Lab

  1. В разделе Campaign Lab выберите Партнеры .
  2. Выберите Новый партнер > RTB House . Выберите Далее , чтобы перейти к следующему экрану.
  3. На экране Выбор приложения выберите приложение, для которого вы хотите создать ссылку и включите интеграцию, чтобы поделиться данными с RTB House.
  4. Нажмите Далее .

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

Включите обмен данными, чтобы активировать интеграцию с RTB House. Чтобы включить обмен данными:

  1. Включите «Включено».

После включения обмена данными с RTB House, Adjust автоматически отправляет RTB House следующие данные (по умолчанию).

  • установка
  • сеанс
  • удаление приложения
  • переустановка
  • повторная атрибуция переустановки
  • реатрибуция
  • событие
  • Отклоненная установка
  • Отклоненная реатрибуция

Настройте параметры обмена данными

При работе с мультиплатформенными приложениями с возможностью совместного использования данных для нескольких платформ вы можете:

  1. Разделить параметры обмена данными на уровне платформы, выбрав Использовать настройки для определенной платформы .
  2. Установить одинаковые настройки обмена данными для нескольких платформ, выбрав Использовать глобальные настройки .

В разделе К чему будет предоставлен доступ? отметьте действия, которые Adjust будет передавать RTB House по умолчанию.

  • установка
  • сеанс
  • удаление приложения
  • переустановка
  • повторная атрибуция переустановки
  • реатрибуция
  • событие
  • Отклоненная установка
  • Отклоненная реатрибуция

Отправка дополнительных данных

Выберите объем и тип данных для передачи RTB House посредством колбэков. RTB House может использовать эту информацию для оптимизации производительности.

  1. В разделе Какими источниками данных вы хотите поделиться? выберите источник атрибуции данных, которые вы хотите передавать RTB House:
  • Данные из всех источников атрибуции
  • Только данные, атрибутированные партнеру RTB House

Сессии

Adjust не отправляет автоматически колбэки сессий из-за большого количества сессий. Передача данных о сессиях позволяет RTB House получать данные о сессиях в вашем приложении.

Удаления или повторные установки

Передача данных об удалениях и переустановках позволяет RTB House получать данные об удалениях и переустановках вашего приложения, измеренные Adjust.

Примечание:

Для приложений под управлением iOS можно ожидать небольшого количества удалений и/или переустановок. Дополнительные сведения см. в разделе Оценка удалений и переустановок.

Доход в приложении (от покупок в приложении)

Передача данных о доходе в приложении позволяет RTB House получать данные не только о сумме дохода, но и о событии дохода. Чтобы делиться этими данными, необходимо сопоставить события, генерирующие доход.

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

Сопоставьте события, которые хотите передавать, со значениями, которые RTB House может получать. Данные событий, которые вы не сопоставили, не могут быть переданы RTB House.

Составить отдельные события

Если у вас мультиплатформенное приложение, вы можете выбрать разные события для каждой платформы и поделиться ими RTB House. Это позволяет вам:

  • настроить отдельные события для управления стратегиями кампаний для каждой платформы;
  • настроить обмен данными для каждой платформы.

В разделе Сопоставление событий выполните следующие действия, чтобы выбрать события в приложении, данные о которых следует передавать RTB House:

  1. Выберите Сопоставить событие .

  2. В списке Событие Adjust выберите событие Adjust, которым вы хотите поделиться с RTB House.

  3. В разделе «Событие партнера» необходимо выбрать событие RTB House, соответствующее событию Adjust.

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

      • Нажмите «Использовать сопоставление конкретной платформы» , чтобы сопоставить отдельные события на уровне платформы или не сопоставлять события для определенных платформ.
      • Нажмите «Использовать глобальное сопоставление» , чтобы отобразить одни и те же события для всех платформ.
    2. В списке Событие партнера выберите или введите имя настраиваемого события, которое нужно сопоставить с событием Adjust.

  4. Нажмите Применить .

Теперь RTB House будет получать данные о событии в приложении по каждому связанному событию.

Сопоставить все события

Если RTB House поддерживает автоматическое сопоставление всех событий, в разделе «Сопоставление событий» нажмите «Сопоставить все события». Это экономит время при сопоставлении отдельных событий.

Теперь RTB House будет получать данные о событии в приложении по каждому из ваших связанных событий.

Сопоставьте параметры

Чтобы делиться настраиваемыми данными с RTB House, обычно требуется сопоставить параметры.

Параметры партнера (доступно в Adjust SDK версии 4.0+) позволяют Adjust собирать настраиваемые наборы данных в вашем приложении и перенаправлять их непосредственно RTB House. Таким образом RTB House будет получать указанные сведения по каждому связанному событию.

Прежде чем добавлять новые параметры партнера в Adjust SDK, убедитесь, что ни один из ранее введенных параметров партнера не соответствует вашим требованиям.

Чтобы передавать RTB House параметры партнера, выполните следующие действия:

  1. Настройте параметры партнера в Adjust SDK.

    • Проверьте раздел Начало работы для всех ссылок на платформу разработки SDK.
  2. В разделе Выберите параметры обмена данными нажмите Параметры .

  3. В разделе Сопоставить параметры можно указать способ отправки в сеть параметров партнера, заданных в SDK:

    1. Выберите Сопоставить параметр .
    2. В поле Параметр SDK укажите имя параметра SDK, который следует отправить в сеть.
    3. В поле Параметр партнера укажите параметр сети, соответствующий параметру SDK.
Примечание:

Примечание. Если параметры партнера настроены в Adjust SDK без настройки передачи параметров на панели управления, Adjust будет передавать эти параметры с тем же названием, что и в Adjust SDK.

Сконфигурируйте ссылки и настройки

Вы можете настроить следующие параметры:

Создайте ссылку и поделитесь ей с RTB House

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

  • Выбранное приложение
  • Параметры обмена данными
  • Параметры структуры ссылки
  • Места назначения пользователей
  • Настройки атрибуции

Нажмите Создать ссылку , чтобы создать URL клика, URL показа, QR-код и токен ссылки. При создании ссылки также включается обмен данными и интеграция с RTB House.

После того как ссылка создана, поделитесь ей с RTB House для размещения в кампании.

Инструкции по настройке для конкретных партнеров

Creating a User with RTB House Email for Custom Permissions

To enable RTB House access to the Links section of your application, you will need to create a user using an email address provided by RTB House (in the @rtbhouse.com domain). Please contact your RTB House representative to obtain the appropriate email address. Once the email address is received, you can create the user following the steps outlined in the Manage users section of this documentation. During user creation, assign custom permissions to the RTB House user, specifically granting access to RTB House in the Partners section (see screenshot below). For detailed instructions on assigning permissions, refer to the Set custom permissions section.

Integrated partner image

Список всех параметров, передаваемых RTB House

RTB House требует от Adjust отправлять следующие параметры (точки данных) вместе с колбэками:

ПлейсхолдерИнформация
{android_id}Android ID (только для Android)
{city}Город, в котором используется устройство
{country_subdivision}Подраздел устройства по стране, например штат или область
{country}Код страны устройства из двух символов
{currency}Исходный валютный код ISO 4217, отправленный из Adjust SDK
{deeplink}URL-адрес диплинка, добавленный в конец URL-адреса для клика
{device_name}Номер модели устройства
{device_type}Тип устройства
{event_name}Имя события, как задано на панели управления
{gclid}Идентификатор клика Google
{gps_adid}Рекламный идентификатор магазина Google Play
{idfa}Идентификатор IDFA (только для iOS)
{ip_address}IP-адрес устройства
{language}Код языка устройства из двух символов
{os_name}Операционная система устройства
{os_version}Номер версии операционной системы
{partner_parameters}Пользовательские параметры партнера, собираемые запросом Adjust SDK или S2S и передаваемые сторонним поставщикам с помощью постбэков
{revenue_float}Доход в том виде, в котором он отправлен из Adjust SDK, в целых валютных единицах
{revenue_usd}Доход в долларах США
{tracking_enabled}1 — если отслеживание включено, 0 — если нет
{user_agent}Входящий необработанный user agent
{activity_kind}Тип действия пользователя
{adgroup_name}Название группы объявлений (как прописано в трекере)
{app_id}Идентификатор App Store или Google Play Store
{app_version}Номер версии приложения (Android), номер версии сборки пакета (iOS)
{campaign_name}Название кампании (как прописано в трекере)
{click_time}Временная отметка атрибутированного клика
{engagement_time}Временная отметка вовлечения
{impression_based}1 — если вовлечение на основе просмотра, 0 — если нет
{is_organic}1 — если трафик органический, 0 — если неорганический
{reattributed_at}Временная отметка реатрибуции
{rejection_reason}Причина отклонения атрибуции
{store}Целевой магазин клика
{tracker_name}Текущее название трекера