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

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

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

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

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

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

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

Требования

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

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

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

Последняя версия GMA Next-Gen SDK.
Настройте медиацию AdMob.

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

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

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

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

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

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

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

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

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

Ставки

Водопад

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

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

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

Перейдите в раздел Unity Ads Monetization (Монетизация Unity Ads) > 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 (Настройки организации) и запишите основной идентификатор организации.

Обновите файл 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 в интерфейсе AdMob

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

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

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

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

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

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

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

Выбранные рекламные блоки появятся на карточке:

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

Ставки

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

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

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

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

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

Водопад

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

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

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

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

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

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

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

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

Kotlin

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.5.0")
    implementation("com.unity3d.ads:unity-ads:4.21.0")
    implementation("com.google.ads.mediation:unity:4.21.0.0")
}

configurations.configureEach {
    exclude(group = "com.google.android.gms", module = "play-services-ads")
    exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}

Groovy

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.5.0'
    implementation 'com.unity3d.ads:unity-ads:4.21.0'
    implementation 'com.google.ads.mediation:unity:4.21.0.0'
}

configurations.configureEach {
    exclude group: 'com.google.android.gms', module: 'play-services-ads'
    exclude group: 'com.google.android.gms', module: 'play-services-ads-lite'
}

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

Скачайте последнюю версию 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 вручную, рекомендуем вызывать этот код до запроса объявлений через GMA Next-Gen SDK.

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

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

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

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

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

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

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

Коды ошибок

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

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

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

Код ошибки	Причина
0-10	UnityAds SDK вернул ошибку. Подробную информацию можно найти в коде.
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. Подробную информацию можно найти в коде.

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