Настройка Unity Ads
Unity Ads — рекламная сеть, интегрированная с Adjust. Интеграция с нашей системой позволяет передавать в Unity Ads данные об атрибуции и событиях в приложении посредством автоматических колбэков.
Из этой статьи вы узнаете, как настроить измерение с помощью Unity Ads для вашего приложения. Речь пойдет об активации интеграции, создании ссылки на кампанию и выборе данных, которые Adjust может передавать Unity Ads.
Перед началом работы
Требования
- Доступ к администрированию, редактированию или настраиваемый доступ к редактированию в Adjust.
- Adjust SDK версии 4.0.0 и более поздних версий для сопоставления параметров SDK с параметрами Unity Ads. Для использования этой функции следуйте приведенным ниже инструкциям.
iOS | Android | Windows | Unity | React Native | Flutter | Adobe Air | Cordova | Marmalade | Xamarin | Cocos2d-x | Titanium | Corona
Учетные данные
GAME ID
- Чтобы узнать, как найти ваши учетные данные, обратитесь к своему представителю Unity Ads.
Выберите Unity Ads и свое приложение в Campaign Lab
- В разделе Campaign Lab выберите Партнеры.
- Выберите Новый партнер > Unity Ads. Выберите Далее, чтобы перейти к следующему экрану.
- На экране Выбор приложения выберите приложение, для которого вы хотите создать ссылку и включите интеграцию, чтобы поделиться данными с Unity Ads.
- Нажмите Далее.
Включение обмена данными
Включите обмен данными, чтобы активировать интеграцию с Unity Ads. Чтобы включить обмен данными:
- Введите GAME ID.
После включения обмена данными с Unity Ads, Adjust автоматически отправляет Unity Ads следующие данные (по умолчанию).
- установка
- сеанс
- реатрибуция
- событие
- Отклоненная установка
Настройте параметры обмена данными
При работе с мультиплатформенными приложениями с возможностью совместного использования данных для нескольких платформ вы можете:
- Разделить параметры обмена данными на уровне платформы, выбрав Использовать настройки для определенной платформы.
- Установить одинаковые настройки обмена данными для нескольких платформ, выбрав Использовать глобальные настройки.
В разделе К чему будет предоставлен доступ? отметьте действия, которые Adjust будет передавать Unity Ads по умолчанию.
- установка
- сеанс
- реатрибуция
- событие
- Отклоненная установка
Отправка дополнительных данных
Выберите объем и тип данных для передачи Unity Ads посредством колбэков. Unity Ads может использовать эту информацию для оптимизации производительности.
- В разделе Какими источниками данных вы хотите поделиться? выберите источник атрибуции данных, которые вы хотите передавать Unity Ads:
- Данные из всех источников атрибуции
- Только данные, атрибутированные партнеру Unity Ads
Рекламный доход (от просмотров рекламы)
Передача данных о доходе от рекламы позволит Unity Ads получать данные о доходе от рекламы по пользователям. Таким образом Unity Ads может использовать данные о доходе от рекламы для оптимизации кампаний и таргетинга пользователей.
Эта функция доступна при включенной услуге Adjust «Рекламный доход». Для покупки этой услуги свяжитесь с вашим представителем отдела продаж.
Для передачи данных о рекламном доходе Unity Ads выберите один или несколько источников дохода от рекламы (Ad Revenue Sources).
- Если оставить это поле пустым, мы будем отправлять вам данные о доходах от рекламы из всех интегрированных источников медиации.
Сессии
Adjust не отправляет автоматически колбэки сессий из-за большого количества сессий. Передача данных о сессиях позволяет Unity Ads получать данные о сессиях в вашем приложении.
Доход в приложении (от покупок в приложении)
Передача данных о доходе в приложении позволяет Unity Ads получать данные не только о сумме дохода, но и о событии дохода. Чтобы делиться этими данными, необходимо сопоставить события, генерирующие доход.
Сопоставление событий
Сопоставьте события, которые хотите передавать, со значениями, которые Unity Ads может получать. Данные событий, которые вы не сопоставили, не могут быть переданы Unity Ads.
Составить отдельные события
Если у вас мультиплатформенное приложение, вы можете выбрать разные события для каждой платформы и поделиться ими Unity Ads. Это позволяет вам:
- настроить отдельные события для управления стратегиями кампаний для каждой платформы;
- настроить обмен данными для каждой платформы.
В разделе Сопоставление событий выполните следующие действия, чтобы выбрать события в приложении, данные о которых следует передавать Unity Ads:
Выберите Сопоставить событие.
В списке Событие Adjust выберите событие Adjust, которым вы хотите поделиться с Unity Ads.
В разделе «Событие партнера» необходимо выбрать событие Unity Ads, соответствующее событию Adjust.
Для одноплатформенных и многоплатформенных приложений, в которых обмен данными включен только для одной платформы, выполняется сопоставление событий только для этой платформы. Для мультиплатформенных приложений с возможностью совместного использования данных для нескольких платформ вы можете:
- Нажмите «Использовать сопоставление конкретной платформы», чтобы сопоставить отдельные события на уровне платформы или не сопоставлять события для определенных платформ.
- Нажмите «Использовать глобальное сопоставление», чтобы отобразить одни и те же события для всех платформ.
В списке Событие партнера выберите или введите имя настраиваемого события, которое нужно сопоставить с событием Adjust.
Нажмите Применить.
Теперь Unity Ads будет получать данные о событии в приложении по каждому связанному событию.
Сопоставить все события
Если Unity Ads поддерживает автоматическое сопоставление всех событий, в разделе «Сопоставление событий» нажмите «Сопоставить все события». Это экономит время при сопоставлении отдельных событий.
Теперь Unity Ads будет получать данные о событии в приложении по каждому из ваших связанных событий.
Сопоставьте параметры
Чтобы делиться настраиваемыми данными с Unity Ads, обычно требуется сопоставить параметры.
Параметры партнера (доступно в Adjust SDK версии 4.0+) позволяют Adjust собирать настраиваемые наборы данных в вашем приложении и перенаправлять их непосредственно Unity Ads. Таким образом Unity Ads будет получать указанные сведения по каждому связанному событию.
Прежде чем добавлять новые параметры партнера в Adjust SDK, убедитесь, что ни один из ранее введенных параметров партнера не соответствует вашим требованиям.
Чтобы передавать Unity Ads параметры партнера, выполните следующие действия:
Настройте параметры партнера в Adjust SDK.
- Проверьте раздел Начало работы для всех ссылок на платформу разработки SDK.
В разделе Выберите параметры обмена данными нажмите Параметры.
В разделе Сопоставить параметры можно указать способ отправки в сеть параметров партнера, заданных в SDK:
- Выберите Сопоставить параметр.
- В поле Параметр SDK укажите имя параметра SDK, который следует отправить в сеть.
- В поле Параметр партнера укажите параметр сети, соответствующий параметру SDK.
Примечание. Если параметры партнера настроены в Adjust SDK без настройки передачи параметров на панели управления, Adjust будет передавать эти параметры с тем же названием, что и в Adjust SDK.
Сконфигурируйте ссылки и настройки
Вы можете настроить следующие параметры:
Создайте ссылку и поделитесь ей с Unity Ads
На экране Проверка настройки вы можете просмотреть выбранные варианты. Вы можете вернуться и внести изменения в следующие настройки:
- Выбранное приложение
- Параметры обмена данными
- Параметры структуры ссылки
- Места назначения пользователей
- Настройки атрибуции
Нажмите Создать ссылку, чтобы создать URL клика, URL показа, QR-код и токен ссылки. При создании ссылки также включается обмен данными и интеграция с Unity Ads.
После того как ссылка создана, поделитесь ей с Unity Ads для размещения в кампании.
Инструкции по настройке для конкретных партнеров
Для поддержки сценариев с аккаунтами агентств, которые содержат несколько параметров game_ids из Unity Ads Platform, следуйте приведенным ниже инструкциям:
Если одним из параметров game_id агентства является abcde, вы можете добавить &unityads_game_id=abcde в URL трекера Adjust, который в свою отправит атрибутированный колбэк в Unity Ads с параметром game_id: abcde.
Список всех параметров, передаваемых Unity Ads
Unity Ads требует от Adjust отправлять следующие параметры (точки данных) вместе с колбэками:
Плейсхолдер | Информация |
{android_id_md5} | Идентификатор Android в нижнем регистре с шестнадцатеричным MD5 хэшированием |
{android_id} | Android ID (только для Android) |
{api_level} | Уровень API (только Android) |
{country} | Код страны устройства из двух символов |
{currency} | Исходный валютный код ISO 4217, отправленный из Adjust SDK |
{device_name} | Номер модели устройства |
{device_type} | Тип устройства |
{idfa||gps_adid} | Идентификатор IDFA или GPS ADID ID, если IDFA пуст |
{ip_address} | IP-адрес устройства |
{is_reattributed} | 1 — если пользователь был реатрибутирован хотя бы раз из более раннего источника. 0 — если пользователь никогда не был реатрибутирован |
{language} | Код языка устройства из двух символов |
{match_type} | Метод атрибуции |
{os_name} | Операционная система устройства |
{os_version} | Номер версии операционной системы |
{revenue_float} | Доход в том виде, в котором он отправлен из Adjust SDK, в целых валютных единицах |
{revenue_usd} | Доход в долларах США |
{tracking_enabled} | 1 — если отслеживание включено, 0 — если нет |
{user_agent} | Входящий необработанный user agent |
{app_id} | Идентификатор App Store или Google Play Store |
{app_name_dashboard} | Имя приложения на панели Adjust |
{app_name} | Имя приложения |
{app_version_raw} | Номер версии приложения (Android), номер версии сборки пакета (iOS) |
{app_version} | Номер версии приложения (Android), номер версии сборки пакета (iOS) |
{click_time} | Временная отметка атрибутированного клика |
{connection_type} | Тип интернет-соединения |
{created_at} | Временная отметка действия |
{fingerprint_attribution_window} | Настройки окна атрибуции для цифрового отпечатка устройства (часы) |
{impression_based} | 1 — если вовлечение на основе просмотра, 0 — если нет |
{is_organic} | 1 — если трафик органический, 0 — если неорганический |
{rejection_reason} | Причина отклонения атрибуции |
{ad_impressions_count} | Число мобильной рекламы, показанной конечным пользователям |
{ad_revenue_network} | Рекламная сеть, показавшая рекламу |
{ad_revenue_unit} | Рекламная единица, сгенерировавшая доход |
{ad_revenue_placement} | Расположение пользователя в соответствии с данными платформы |
{ad_mediation_platform} | Название платформы медиации |
{ad_revenue_payload} | Данные о доходе на уровне показа (ILRD) в виде JSON-файла |