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 в конфигурацию медиации рекламного блока и как интегрировать Unity Ads SDK и адаптер в приложение Android.

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

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

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

Требования

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

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

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

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

Шаг 1. Настройте конфигурации в интерфейсе Unity Ads

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

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

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

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

Нажмите Монетизация Unity Ads > Начать.

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

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

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

Ставки

Водопад

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

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

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

Нажмите Unity Ads Monetization > Placements, выберите проект и нажмите Add ad unit (Добавить рекламный блок).

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

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

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

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

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

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

Как найти ключ API для отчетов Unity Ads

Ставки

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

Водопад

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

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

Как обновить файл 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 Store, установите флажок Переопределить тестовый режим клиента и выберите Включить тестовый режим (т.е. использовать тестовую рекламу) для всех устройств.

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

Введите данные тестового устройства и нажмите Сохранить.

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

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

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

Ставки

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

Водопад

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

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

Вводить имя пользователя или пароль не нужно. Когда все будет готово, нажмите Сохранить.

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

Ставки

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

Водопад

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

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

Ставки

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

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

Водопад

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

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

Ставки

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

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

Водопад

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

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

Ставки

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

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

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

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

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

Водопад

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

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

Ставки

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

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

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

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

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

Водопад

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

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

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

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

Как добавить Unity Ads в список рекламных партнеров для GDPR и законов штатов США в отношении конфиденциальности

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

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

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

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

Kotlin

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

Groovy

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

Настраиваемые вручную интеграции

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

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

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

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

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

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

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

В версии 2.0.0 SDK Unity Ads добавили API для поддержки настроек конфиденциальности. В приведенном ниже образце кода показано, как передать информацию о согласии в Unity Ads SDK. Если вы решите передавать информацию о согласии в 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 о соблюдении закона о конфиденциальности потребителей.

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

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

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

Шаг 5. Добавьте обязательный код

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

Передавайте контекст 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	SDK UnityAds вернул ошибку. Подробнее о коде…
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. Подробнее о коде…