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

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

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

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

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

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

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

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

Требования

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

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

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

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

Шаг 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 в интерфейсе AdMob

Как настроить медиацию для рекламного блока

Вам нужно добавить Unity Ads в конфигурацию медиации для рекламного блока.

Войдите в аккаунт AdMob. Затем перейдите на вкладку Медиация. Если у вас уже есть группа медиации, которую вы хотите изменить, нажмите на ее название и перейдите к разделу Как добавить Unity Ads в качестве источника объявлений.

Чтобы создать новую группу медиации, нажмите Создать группу медиации.

Укажите формат и платформу объявления и нажмите Продолжить.

Укажите название группы медиации и выберите целевые местоположения. Затем установите для группы медиации статус Включено и нажмите Добавить рекламные блоки.

Свяжите эту группу медиации с одним или несколькими существующими рекламными блоками AdMob. Затем нажмите Готово.

На карточке "Рекламные блоки" появятся выбранные вами рекламные блоки.

Как добавить Unity Ads в качестве источника объявлений

Ставки

В разделе Источники объявлений найдите карточку Назначение ставок и нажмите Добавить источник объявлений. Затем выберите Unity Ads.

Нажмите Как подписать партнерское соглашение и настройте партнерство с назначением ставок с Unity Ads.

Нажмите Подтвердить и принять, а затем – Продолжить.

Если у вас уже есть сопоставление для Unity Ads, выберите его. В противном случае нажмите Добавить сопоставление.

Затем введите идентификатор игры и идентификатор места размещения, полученные в предыдущем разделе. Затем нажмите Готово.

Водопад

На карточке Каскад в разделе Источники объявлений выберите Добавить источник объявлений.

Выберите Unity Ads и включите переключатель Оптимизировать. Введите ключ API и основной идентификатор организации, полученные в предыдущем разделе, чтобы настроить оптимизацию источника объявлений для Unity Ads. Затем введите эффективную цену за тысячу показов для Unity Ads и нажмите Продолжить.

Примечание. Для оптимизации источников объявлений требуется несколько дней, чтобы собрать достаточно данных для точного расчета эффективной цены за тысячу показов для сети медиации. Пока оптимизация источника объявлений не завершена, ее статус – PENDING. Вам нужно вручную задать эффективную цену за тысячу показов для сети. После того как эффективная цена за тысячу показов будет рассчитана, источник объявлений начнет автоматически обновлять ее.

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

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

Шаг 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. Проверьте реализацию

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

Убедитесь, что вы зарегистрировали тестовое устройство в AdMob и включили тестовый режим в интерфейсе 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, настроенные в интерфейсе AdMob, отсутствуют или недействительны.
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. Подробнее о коде…