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

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

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

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

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

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

Требования

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

  • Последняя версия Google Mobile Ads Flutter Plugin.
  • Фреймворк Flutter 3.7.0 или более поздней версии.
  • [Для назначения ставок] Чтобы интегрировать все поддерживаемые форматы объявлений в назначение ставок, используйте плагин медиации Google Mobile Ads для Unity Ads версии 1.1.0 или более поздней (рекомендуется последняя версия).
  • Чтобы развернуть приложение на устройстве Android:
    • Android API уровня 24 или более поздней версии.
  • Чтобы развернуть приложение на iOS:
    • Целевая версия iOS для развертывания – 13.0 или более поздняя.
  • Рабочий проект Flutter, настроенный с помощью Google Mobile Ads Flutter Plugin. Подробные сведения приведены в статье Как настроить Google Mobile Ads Flutter Plugin.
  • Настройте медиацию.

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

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

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

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

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

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

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

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

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

    Ставки

    Водопад

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

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

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

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

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

    Android

    iOS

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

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

    Android

    iOS

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

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

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

    Как найти ключ 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 (Тестирование).

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

    Android

    iOS

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

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

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

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

    Android

    Инструкции приведены в разделе "Шаг 2" Android.

    iOS

    Инструкции приведены в разделе "Шаг 2" руководства для iOS.

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

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

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

    Интеграция через pub.dev

    Добавьте в файл pubspec.yaml пакета следующую зависимость с последними версиями рекламного SDK Unity Ads и адаптера:

    dependencies:
  gma_mediation_unity: ^1.11.1

    Интеграция с настройкой вручную

    Скачайте последнюю версию плагина медиации Google Mobile Ads для Unity Ads, извлеките скачанный файл и добавьте извлеченную папку плагина (и ее содержимое) в проект Flutter. Затем добавьте в файл pubspec.yaml следующую зависимость:

    dependencies:
  gma_mediation_unity:
    path: path/to/local/package

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

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

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

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

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

    Плагин медиации Google Mobile Ads для Unity Ads включает метод GmaMediationUnity.setCCPAConsent(). В следующем образце кода показано, как передать информацию о согласии в рекламный SDK Unity Ads. Если вы решите вызвать этот метод, рекомендуем сделать это до запроса объявлений через Google Mobile Ads Flutter Plugin.

    import 'package:gma_mediation_unity/gma_mediation_unity.dart';
// ...

GmaMediationUnity.setCCPAConsent(true);

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

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

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

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

    Android

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

    iOS

    Интеграция с SKAdNetwork

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

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

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

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

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

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

    Коды ошибок

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

    Android

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

    iOS

    GADMAdapterUnity
GADMediationAdapterUnity

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

    Android

    Код ошибки Причина
    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 Banner: определенная ошибка. Подробнее о коде…

    iOS

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

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

    Версия 1.11.1

    Версия 1.11.0

    Версия 1.10.0

    Версия 1.9.0

    Версия 1.8.1

    Версия 1.8.0

    Версия 1.7.0

    Версия 1.6.5

    • Создано и протестировано с помощью Google Mobile Ads Flutter Plugin версии 6.0.0.

    Версия 1.6.4

    Версия 1.6.3

    • Создано и протестировано с помощью Google Mobile Ads Flutter Plugin версии 6.0.0.

    Версия 1.6.2

    • Создано и протестировано с помощью Google Mobile Ads Flutter Plugin версии 6.0.0.

    Версия 1.6.1

    • Создано и протестировано с помощью Google Mobile Ads Flutter Plugin версии 6.0.0.

    Версия 1.6.0

    • Создано и протестировано с помощью Google Mobile Ads Flutter Plugin версии 6.0.0.

    Версия 1.5.1

    • Создано и протестировано с помощью Google Mobile Ads Flutter Plugin версии 6.0.0.

    Версия 1.5.0

    • Создано и протестировано с помощью Google Mobile Ads Flutter Plugin версии 6.0.0.

    Версия 1.4.1

    • Создано и протестировано с помощью Google Mobile Ads Flutter Plugin версии 6.0.0.

    Версия 1.4.0

    • Создано и протестировано с помощью плагина Google Mobile Ads для Flutter версии 6.0.0.

    Версия 1.3.0

    • Создано и протестировано с помощью плагина Google Mobile Ads для Flutter версии 5.3.1.

    Версия 1.2.0

    • Создано и протестировано с помощью плагина Google Mobile Ads для Flutter версии 5.3.1.

    Версия 1.1.0

    • Создано и протестировано с помощью Google Mobile Ads Flutter Plugin версии 5.2.0.

    Версия 1.0.0

    • Создано и протестировано с помощью Google Mobile Ads Flutter Plugin версии 5.0.0.