Интегрируйте Unity Ads с медиацией

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

Поддерживаемые интеграции и форматы рекламы

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

Интеграция
Торги 1
Водопад
Форматы
Баннер
Интерстициальный
Награжден

1 Интеграция торгов находится в стадии открытого бета-тестирования.

Требования

  • Последняя версия Google Mobile Ads SDK
  • Unity 4 или выше
  • [Для торгов]: Чтобы интегрировать все поддерживаемые форматы рекламы в торги, используйте плагин-медиатор Google Mobile Ads для Unity Ads 3.11.1 или выше ( рекомендуется последняя версия ).
  • Для развертывания на Android
    • Android API уровня 23 или выше
  • Для развертывания на iOS
    • Цель развертывания iOS 12.0 или выше
  • Рабочий проект Unity, настроенный с использованием Google Mobile Ads SDK. Подробности см. в разделе «Начало работы» .
  • Завершить посредничество . Руководство по началу работы.

Шаг 1: Настройте конфигурации в пользовательском интерфейсе Unity Ads

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

Создать проект

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

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

Перейдите в раздел «Монетизация рекламы в Unity» , затем нажмите « Начать» .

В модальном окне «Новый проект» выберите «Я буду использовать посредничество и Google Admob в качестве партнера-посредника» , затем нажмите «Далее» .

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

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

Торги

Водопад

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

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

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

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

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

Андроид

iOS

Торги

Выберите «Торги» для настройки . В разделе «Размещение» введите название размещения .

Обратите внимание на идентификатор размещения .

Водопад

Выберите «Водопад» в разделе «Настройка» . В разделе «Размещение» введите имя места размещения , геотеги и цель .

Обратите внимание на идентификатор размещения .

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

Найдите ключ API Unity Ads Reporting

Торги

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

Водопад

Перейдите в раздел «Монетизация Unity Ads» > «Управление API» и запишите ключ API в разделе «Доступ к API статистики монетизации» .

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

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

Файл app-ads.txt для авторизованных продавцов приложений — это инициатива IAB Tech Lab, которая помогает гарантировать, что рекламный инвентарь вашего приложения будет продаваться только через каналы, которые вы указали как авторизованные. Чтобы предотвратить значительную потерю дохода от рекламы, вам необходимо внедрить файл app-ads.txt . Если вы ещё этого не сделали, настройте файл app-ads.txt для своего приложения .

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

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

Тестовый режим можно включить на панели инструментов Unity Ads . Перейдите в раздел «Монетизация Unity Ads» > «Тестирование» .

Вы можете принудительно включить тестовый режим для своего приложения, нажав кнопку редактирования для каждой платформы, включив опцию Переопределить тестовый режим клиента и выбрав ВКЛ. тестового режима (т. е. использовать тестовые объявления) для всех устройств .

Андроид

iOS

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

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

Шаг 2: Настройте спрос на Unity Ads в пользовательском интерфейсе AdMob

Настройте параметры медиации для вашего рекламного блока

Андроид

Инструкции см. в шаге 2 руководства для Android .

iOS

Инструкции см. в шаге 2 руководства для iOS .

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

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

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

OpenUPM-CLI

Если у вас установлен OpenUPM-CLI , вы можете установить плагин Google Mobile Ads Unity Ads Mediation Plugin для Unity в свой проект, выполнив следующую команду из корневого каталога вашего проекта:

openupm add com.google.ads.mobile.mediation.unityads

OpenUPM

В редакторе проектов Unity выберите Правка > Настройки проекта > Менеджер пакетов , чтобы открыть настройки менеджера пакетов Unity .

На вкладке Scoped Registries добавьте OpenUPM как scoped registry со следующими данными:

  • Имя: OpenUPM
  • URL-адрес: https://package.openupm.com
  • Область(ы): com.google

Подробности OpenUPM

Затем перейдите в Окно > Диспетчер пакетов , чтобы открыть диспетчер пакетов Unity, и выберите Мои реестры в раскрывающемся меню.

Реестры Unity

Выберите пакет Google Mobile Ads UnityAds Mediation и нажмите «Установить» .

Установить из OpenUPM

Пакет Unity

Загрузите последнюю версию плагина-медиатора Google Mobile Ads для Unity Ads по ссылке в журнале изменений и извлеките пакет GoogleMobileAdsUnityAdsMediation.unitypackage из zip-файла.

В редакторе проекта Unity выберите «Активы» > «Импорт пакета» > «Пользовательский пакет» и найдите загруженный вами файл GoogleMobileAdsUnityAdsMediation.unitypackage . Убедитесь, что выбраны все файлы, и нажмите «Импорт» .

Импорт из Unity

Затем выберите Assets > External Dependency Manager > Android Resolver > Force Resolve . Библиотека External Dependency Manager выполнит разрешение зависимостей с нуля и скопирует объявленные зависимости в каталог Assets/Plugins/Android вашего приложения Unity.

Сила Решения

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

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

Плагин медиации Google Mobile Ads для Unity Ads версии 3.3.0 включает метод UnityAds.SetConsentMetaData() . В следующем примере кода показано, как передать информацию о согласии в Unity Ads SDK. Если вы решите вызвать этот метод, рекомендуется сделать это до запроса рекламы через Google Mobile Ads SDK.

using GoogleMobileAds.Api.Mediation.UnityAds;
// ...

UnityAds.SetConsentMetaData("gdpr.consent", true);

Более подробную информацию и значения, которые можно предоставить в каждом методе, см. в руководствах Unity Ads « Согласие на конфиденциальность и API-интерфейсы данных» , а также «Соблюдение GDPR».

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

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

Плагин медиации Google Mobile Ads для Unity Ads версии 3.3.0 включает метод UnityAds.SetConsentMetaData() . В следующем примере кода показано, как передать информацию о согласии в Unity Ads SDK. Если вы решите вызвать этот метод, рекомендуется сделать это до запроса рекламы через Google Mobile Ads SDK.

using GoogleMobileAds.Api.Mediation.UnityAds;
// ...

UnityAds.SetConsentMetaData("privacy.consent", true);

Дополнительную информацию и значения, которые можно предоставить в каждом методе, см. в руководствах Unity Ads « Согласие на конфиденциальность и API-интерфейсы данных» , а также « Соблюдение CCPA».

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

Андроид

Для интеграции Unity Ads с Android дополнительный код не требуется.

iOS

Интеграция SKAdNetwork

Следуйте документации Unity Ads , чтобы добавить идентификаторы SKAdNetwork в файл Info.plist вашего проекта.

Ошибки компиляции

Для адаптера Unity Ads 3.4.0 или выше необходимо следовать инструкциям по интеграции, приведенным в документации Unity .

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

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

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

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

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

Коды ошибок

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

Андроид 

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

iOS 

GADMAdapterUnity
GADMediationAdapterUnity

Вот коды и сопутствующие сообщения, выдаваемые адаптером UnityAds, когда реклама не загружается:

Андроид

Код ошибки Причина
0-10 UnityAds SDK вернул ошибку. Подробнее см. в коде .
101 Параметры сервера UnityAds, настроенные в пользовательском интерфейсе Admob, отсутствуют или недействительны.
102 UnityAds вернул место размещения со статусом NO_FILL.
103 UnityAds вернул размещение со статусом ОТКЛЮЧЕНО.
104 UnityAds попытался показать рекламу с нулевым контекстом.
105 Контекст, используемый для инициализации, загрузки и/или показа рекламы из Unity Ads, не является экземпляром Activity.
106 UnityAds попыталась показать рекламу, которая не готова к показу.
107 UnityAds не поддерживается на этом устройстве.
108 UnityAds может загружать только одно объявление на одно место размещения одновременно.
109 UnityAds завершил работу с состоянием ERROR.
200-204 Баннер UnityAds — определённая ошибка. Подробнее см. в коде .

iOS

0-9 UnityAds SDK вернул ошибку. Подробнее см. в документации Unity.
101 Параметры сервера UnityAds, настроенные в пользовательском интерфейсе AdMob, отсутствуют/недействительны.
102 Устройство не поддерживается UnityAds.
103 UnityAds завершил презентацию с состоянием ошибки kUnityAdsFinishStateError .
104 Объект рекламы Unity равен нулю после вызова его инициализатора.
105 Не удалось показать рекламу Unity, так как она не готова.
107 UnityAds вызвал обратный вызов изменения размещения с состоянием размещения kUnityAdsPlacementStateDisabled .
108 Для этого места размещения уже загружено объявление. SDK UnityAds не поддерживает загрузку нескольких объявлений для одного места размещения.
109 Рекламный баннер, возвращенный UnityAds, не соответствует запрошенному размеру.
110 UnityAds вернул ошибку инициализации.
111 Неподдерживаемый формат рекламы.

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

Версия 3.15.1

Версия 3.15.0

Версия 3.14.4

Версия 3.14.3

Версия 3.14.2

Версия 3.14.1

Версия 3.14.0

Версия 3.13.0

Версия 3.12.6

Версия 3.12.5

Версия 3.12.4

Версия 3.12.3

Версия 3.12.2

Версия 3.12.1

Версия 3.12.0

Версия 3.11.1

Версия 3.11.0

Версия 3.10.0

Версия 3.9.1

Версия 3.9.0

Версия 3.8.0

Версия 3.7.1

Версия 3.7.0

Версия 3.6.1

Версия 3.6.0

Версия 3.5.0

Версия 3.4.1

Версия 3.4.0

Версия 3.3.0

Версия 3.2.1

Версия 3.2.0

Версия 3.1.0

Версия 3.0.1

Версия 3.0.0

Версия 2.7.2

Версия 2.7.1

Версия 2.7.0

Версия 2.6.0

Версия 2.5.1

Версия 2.5.0

Версия 2.4.7

Версия 2.4.6

Версия 2.4.5

Версия 2.4.4

Версия 2.4.3

Версия 2.4.2

Версия 2.4.1

Версия 2.4.0

Версия 2.3.0

Версия 2.2.0

Версия 2.1.0

  • Поддерживает адаптер Unity Ads для Android версии 3.1.0.0.
  • Поддерживает адаптер Unity Ads iOS версии 3.1.0.0.

Версия 2.0.3

  • Обновлен плагин для поддержки нового открытого бета-тестирования Rewarded API.
  • Добавляет поддержку баннерной рекламы.
  • Поддерживает адаптер Unity Ads для Android версии 3.0.0.2.
  • Поддерживает адаптер Unity Ads iOS версии 3.0.0.3.

Версия 2.0.2

  • Поддерживает адаптер Unity Ads для Android версии 3.0.0.0.
  • Поддерживает адаптер Unity Ads iOS версии 3.0.0.1.

Версия 2.0.1

  • Исправлена ошибка «несовместимого типа», вызывавшая проблемы при сборке для iOS.

Версия 2.0.0

  • Поддерживает адаптер Unity Ads для Android версии 3.0.0.0.
  • Поддерживает адаптер Unity Ads iOS версии 3.0.0.0.

Версия 1.2.0

  • Поддерживает адаптер Unity Ads для Android версии 2.3.0.0.
  • Поддерживает адаптер Unity Ads iOS версии 2.3.0.0.

Версия 1.1.3

  • Поддерживает адаптер Unity Ads для Android версии 2.2.1.0.
  • Поддерживает адаптер Unity Ads iOS версии 2.2.1.0.

Версия 1.1.2

  • Поддерживает Unity Ads Android SDK версии 2.2.0.
  • Поддерживает Unity Ads iOS SDK версии 2.2.0.
  • Добавлен метод UnityAds.SetGdprConsentMetaData() для ручного запроса согласия пользователя на таргетированную рекламу.

Версия 1.1.1

  • Поддерживает Unity Ads Android SDK версии 2.2.0.
  • Поддерживает Unity Ads iOS SDK версии 2.2.1.

Версия 1.1.0

  • Поддерживает Unity Ads Android SDK версии 2.2.0.
  • Поддерживает Unity Ads iOS SDK версии 2.2.0.

Версия 1.0.0

  • Первый релиз!
  • Поддерживает Unity Ads Android SDK версии 2.1.2.
  • Поддерживает Unity Ads iOS SDK версии 2.1.2.