Google Mobile Ads SDK находится в режиме технического обслуживания. Для получения последних обновлений и новых функций выполните миграцию и настройку GMA Next-Gen SDK .

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

Как интегрировать Unity Ads с медиацией

Выберите платформу: Android iOS Unity Flutter Android (устаревшая версия)

В этом руководстве рассказывается, как использовать Google Mobile Ads SDK (Legacy) для загрузки и показа объявлений из Unity Ads с помощью медиации, а также рассматривается интеграция назначения ставок и каскада. В ней рассказывается, как добавить Unity Ads в конфигурацию медиации рекламного блока, а также как интегрировать SDK и адаптер Unity Ads в приложение для Android.

Поддерживаемые интеграции и форматы объявлений

Адаптер медиации для Unity Ads поддерживает следующие возможности:

Интеграция
Ставки
Водопад	¹
Форматы
Баннер
Межстраничное объявление
Бонус предоставлен
Стандартное

Требования

Прежде чем продолжить, убедитесь, что:

Android API уровня 24 или более поздней версии.

[Для назначения ставок] Чтобы интегрировать все поддерживаемые форматы объявлений в назначение ставок, используйте адаптер Unity версии 4.16.0.1 или более поздней (рекомендуется последняя версия).

Последняя версия Google Mobile Ads SDK (Legacy).
Настройте медиацию.

Шаг 1. Задайте настройки в интерфейсе Unity Ads

Зарегистрируйтесь или войдите в аккаунт Unity Ads.

Как создать проект

На панели управления Unity Ads перейдите в раздел Projects (Проекты) и нажмите New (Создать).

Заполните форму и нажмите Создать, чтобы добавить проект.

Перейдите в раздел Unity Ads Monetization (Монетизация Unity Ads) и нажмите Get started (Начать).

В окне New Project (Новый проект) выберите I will use Mediation (Я буду использовать медиацию) и Google AdMob в качестве Mediation Partner (Партнер по медиации), а затем нажмите Next (Далее).

Выберите вариант для настроек рекламы и нажмите Далее.

Выберите настройки места размещения и нажмите Далее.

Ставки

Водопад

Заполните форму и нажмите Добавить проект.

Запишите идентификатор игры.

Создание рекламных блоков и мест размещения

Перейдите в раздел Unity Ads Monetization (Монетизация Unity Ads) > Placements (Места размещения), выберите проект и нажмите Add ad unit (Добавить рекламный блок).

Укажите название рекламного блока, а затем выберите платформу и формат объявления.

Перейдите в раздел Монетизация > Места размещения и нажмите Добавить рекламный блок.

Укажите название рекламного блока, а затем выберите платформу и формат объявления.

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

Запишите идентификатор места размещения.

Нажмите Добавить рекламный блок, чтобы сохранить рекламный блок и место размещения.

Как найти ключ API Reporting для Unity Ads

Ставки

Для интеграции с назначением ставок этот шаг не требуется.

Водопад

Перейдите в раздел Unity Ads Monetization (Монетизация Unity Ads) > API management (Управление API) и найдите API Key (Ключ API) в разделе Monetization Stats API Access (Доступ к API статистики монетизации).

Затем перейдите в раздел Unity Ads Monetization (Монетизация Unity Ads) > Organization Settings (Настройки организации) и запишите основной идентификатор организации.

Обновите файл app-ads.txt

Решение Authorized Sellers for Apps (app-ads.txt), разработанное IAB Tech Lab, позволяет издателям указывать авторизованных продавцов своего рекламного инвентаря. Чтобы избежать значительного снижения дохода от рекламы, используйте файл app-ads.txt. Если вы ещё этого не сделали, создайте файл app-ads.txt для Менеджера рекламы.

Чтобы реализовать app-ads.txt для Unity Ads, ознакомьтесь с инструкциями по первой настройке файла app-ads.txt.

Включить тестовый режим

Режим тестирования можно включить на панели управления Unity Ads. Перейдите в раздел Unity Ads Monetization (Монетизация Unity Ads) > Testing (Тестирование).

Чтобы принудительно включить тестовый режим для приложения, нажмите кнопку редактирования рядом с пунктом Google Play, активируйте параметр Переопределить тестовый режим клиента и выберите Принудительно включить тестовый режим (т.е. использовать тестовые объявления) для всех устройств.

Вы также можете включить тестовый режим для определенных устройств, нажав Добавить тестовое устройство.

Укажите сведения о тестовом устройстве и нажмите Сохранить.

Шаг 2. Настройте спрос Unity Ads в интерфейсе Менеджера рекламы

Войдите в аккаунт Менеджера рекламы.

Добавьте Unity Ads в разделе "Компании"

Ставки

Для интеграции с назначением ставок этот шаг не требуется.

Водопад

Перейдите в раздел Администрирование > Компании и на вкладке Все компании нажмите кнопку Новая компания. Выберите Рекламная сеть.

Выберите Unity Ads в качестве рекламной сети, введите уникальное название и включите медиацию. Включите Автоматический сбор данных и введите ключ API и основной идентификатор организации, полученные в предыдущем разделе.

Поля Имя пользователя и Пароль заполнять не нужно. Нажмите кнопку Сохранить.

Включить передачу защищенных сигналов

Ставки

Нажмите Администрирование > Глобальные настройки. Перейдите на вкладку Настройки аккаунта Ad Exchange и включите функцию Передача защищенных сигналов. Нажмите Save (Сохранить).

Водопад

Этот шаг не требуется для интеграции каскада.

Передавать защищенные сигналы в запросах ставок

Ставки

Нажмите Инвентарь > Защищенные сигналы. В разделе Защищенные сигналы найдите Unity Ads и сдвиньте вправо переключатель Включить интеграцию с приложениями.

Нажмите Сохранить.

Водопад

Этот шаг не требуется для интеграции каскада.

Как разрешить передачу защищенных сигналов для назначения ставок в SDK

Ставки

Нажмите Выполнение > Настройки каналов спроса. На вкладке Настройки по умолчанию сдвиньте переключатель Разрешить передачу защищенных сигналов вправо для параметра Назначение ставок в SDK.

Нажмите Сохранить.

Водопад

Этот шаг не требуется для интеграции каскада.

Как настроить назначение ставок в Unity Ads

Ставки

Перейдите в раздел Выполнение > Системы назначения ставок и нажмите Перейти к назначению ставок в SDK.

Нажмите Новая система назначения ставок.

В качестве системы назначения ставок выберите Unity Ads.

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

Нажмите Готово.

Водопад

Этот шаг не требуется для интеграции каскада.

Как настроить сопоставление рекламных блоков

Ставки

Перейдите в раздел Выполнение > Системы назначения ставок и нажмите Перейти к назначению ставок в SDK.

Выберите компанию для Unity Ads.

Перейдите на вкладку Сопоставление рекламных блоков и нажмите Новое сопоставление рекламных блоков.

Выберите Определенный рекламный блок. Выберите рекламный блок и формат, а также укажите Мобильное приложение в качестве типа инвентаря и мобильное приложение. Затем введите идентификатор игры и идентификатор места размещения, полученные в предыдущем разделе.

Нажмите Сохранить.

Водопад

Перейдите в раздел Выполнение > Группы доходности и нажмите кнопку Новая группа доходности. Выберите Инвентарь и Приложение.

Прокрутите страницу до раздела Партнеры по группе доходности и нажмите Добавить партнера по медиации.

Выберите компанию, которую вы создали для Unity Ads в предыдущем разделе. В качестве типа интеграции выберите Медиация с использованием Mobile SDK, в качестве платформы – Android, а в качестве статуса – Активно.

Введите идентификатор игры и идентификатор места размещения, полученные в предыдущем разделе, а также значение Цена за тысячу показов по умолчанию. Нажмите Сохранить.

Добавьте Unity Ads в список рекламных партнеров, соблюдающих GDPR и законы штатов США

Следуйте инструкциям в статьях Настройки, необходимые для соблюдения европейских регламентов и Настройки, необходимые для соблюдения законов штатов США, чтобы добавить Unity Ads в список рекламных партнеров, соблюдающих европейские регламенты и законы штатов США, в интерфейсе Менеджера рекламы.

Шаг 3. Импортируйте Unity Ads SDK и адаптер

Интеграция с Android Studio (рекомендуется)

В файле gradle на уровне приложения добавьте следующие зависимости реализации:

Kotlin

dependencies {
    implementation("com.google.android.gms:play-services-ads:25.5.0")
    implementation("com.unity3d.ads:unity-ads:4.21.0")
    implementation("com.google.ads.mediation:unity:4.21.0.0")
}

Groovy

dependencies {
    implementation 'com.google.android.gms:play-services-ads:25.5.0'
    implementation 'com.unity3d.ads:unity-ads:4.21.0'
    implementation 'com.google.ads.mediation:unity:4.21.0.0'
}

Интеграция вручную

Скачайте последнюю версию Unity Ads SDK (unity-ads.aar) из хранилища GitHub и добавьте ее в проект.
Перейдите к артефактам адаптера Unity Ads в репозитории Maven от Google. Выберите последнюю версию, скачайте файл .aar адаптера Unity Ads и добавьте его в проект.

Шаг 4. Задайте настройки конфиденциальности в рекламном SDK Unity Ads

Согласие пользователей из ЕС и GDPR

Чтобы соблюдать правила Google в отношении согласия пользователей из ЕС, вы должны предоставлять определенную информацию пользователям из Европейской экономической зоны (ЕЭЗ), Великобритании и Швейцарии и получать их согласие на использование файлов cookie или других средств локального хранения данных, если это требуется по закону, а также на сбор, передачу и использование персональных данных для персонализации рекламы. Эти правила отражают требования, изложенные в Директиве ЕС о конфиденциальности и электронных средствах связи и Генеральном регламенте ЕС о защите персональных данных (GDPR). Вы должны убедиться, что согласие передается каждому источнику объявлений в цепочке медиации.

Адаптер Unity Ads для Android версии 4.19.0.1 и более поздних поддерживает передачу сигналов согласия по GDPR от платформ для запросов согласия, интегрированных со спецификацией Transparency and Consent Framework (TCF) от IAB, в рекламный SDK Unity Ads. Подробнее о том, как настроить конфигурацию согласия, соответствующую или не соответствующую спецификации TCF…

Законы штатов США о конфиденциальности

Законы штатов США о конфиденциальности требуют предоставлять пользователям право запретить "продажу" их "личной информации" (эти термины определены в тексте закона). Компания, подпадающая под действие закона, обязана разместить на главной странице "продавца" ссылку с текстом "Запретить продажу личных данных". В руководстве по соблюдению законов штатов США о конфиденциальности рассказывается, как включить ограничение обработки данных для показа рекламы Google. Однако Google не может применить эту настройку ко всем рекламным сетям в вашей цепочке медиации. Поэтому вам необходимо определить, какие рекламные сети в вашей цепочке медиации могут участвовать в продаже личной информации, и следовать инструкциям каждой из этих сетей, чтобы обеспечить соблюдение требований.

В SDK версии 2.0.0 Unity Ads добавила API для поддержки настроек конфиденциальности. В приведенном ниже образце кода показано, как передать эту информацию о согласии в рекламный SDK Unity Ads. Если вы хотите передавать информацию о согласии в Unity Ads SDK вручную, рекомендуем вызывать этот код до запроса объявлений через Google Mobile Ads SDK (Legacy).

Java

MetaData ccpaMetaData = new MetaData(this);
ccpaMetaData.set("privacy.consent", true);
ccpaMetaData.commit();UnityAdsMediationSnippets.java

Kotlin

val ccpaMetaData = MetaData(this)
ccpaMetaData["privacy.consent"] = true
ccpaMetaData.commit()UnityAdsMediationSnippets.kt

Дополнительную информацию и значения, которые можно указать в каждом методе, вы найдете в статье Unity Ads Consumer privacy act compliance (Соблюдение законов о защите конфиденциальности потребителей).

Как настроить обработку с учетом возраста

Адаптер медиации Unity Ads версии 4.16.6.0 и более поздних передает в Unity Ads настройку "Контент для детей" и настройку Пользователи, не достигшие минимального возраста.

Чтобы обрабатывать эти сигналы для каждого пользователя, в Unity Ads необходимо включить параметр Mixed Audience (Смешанная аудитория) на панели управления Unity Monetization. Подробнее о том, как указать, что игра предназначена для смешанной аудитории…

Шаг 5. Добавьте необходимый код

Загрузка объявления с контекстом действия

Передавайте контекст Activity при загрузке баннеров, межстраничных и нативных объявлений. Без контекста действия загрузка объявлений не произойдет.

Шаг 6. Проверьте реализацию

Как включить тестовые объявления

Обязательно зарегистрируйте тестовое устройство в Менеджере рекламы и включите тестовый режим в интерфейсе Unity Ads.

Проверьте тестовые объявления

Чтобы убедиться, что вы получаете тестовые объявления от Unity Ads, включите тестирование одного источника объявлений в инспекторе объявлений, используя источники объявлений Unity Ads (назначение ставок) и Unity Ads (каскад).

Коды ошибок

Если адаптер не получает объявление от Unity Ads, издатели могут проверить основную ошибку в ответе на запрос объявления, используя ResponseInfo.getAdapterResponses() в следующих классах:

com.google.ads.mediation.unity.UnityAdapter
com.google.ads.mediation.unity.UnityMediationAdapter

Ниже приведены коды и сообщения об ошибках, которые возвращает адаптер UnityAds, когда не удается загрузить объявление.

Код ошибки	Причина
0-10	UnityAds SDK вернул ошибку. Подробную информацию можно найти в коде.
101	Параметры сервера UnityAds, настроенные в интерфейсе Менеджера рекламы, отсутствуют или недействительны.
102	UnityAds возвращает место размещения со статусом NO_FILL.
103	Сеть UnityAds вернула место размещения со статусом DISABLED.
104	UnityAds попыталась показать объявление с нулевым контекстом.
105	Контекст, используемый для инициализации, загрузки и/или показа объявлений из Unity Ads, не является экземпляром Activity.
106	Сеть UnityAds попыталась показать объявление, которое не готово к показу.
107	UnityAds не поддерживается на устройстве.
108	UnityAds может загружать только одно объявление на место размещения за раз.
109	UnityAds: завершено с ошибкой.
110	Запрошенный размер объявления не соответствует размеру баннера, поддерживаемому UnityAds.
111	UnityAds возвращает ошибку инициализации.
112	Unity Ads возвращает нулевой или пустой токен назначения ставок.
200-204	Ошибка, связанная с баннером UnityAds. Подробную информацию можно найти в коде.

Журнал изменений адаптера Unity Ads Android Mediation