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

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

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

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

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

¹ Интеграция назначения ставок находится на стадии закрытого бета-тестирования. Чтобы запросить доступ, обратитесь к менеджеру своего аккаунта.

Требования

• Последняя версия Google Mobile Ads SDK
• Флаттер 3.7.0 или выше
• Развертывание на Android
  • Android API уровня 21 или выше
• Развертывание на iOS
  • Цель развертывания iOS 12.0 или выше
• Рабочий Flutter проект, настроенный с помощью Google Mobile Ads SDK. Подробности см. в разделе « Начало работы ».
• Пройдите руководство по началу работы с медиацией

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

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

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

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

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

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

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

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

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

Обратите внимание на идентификатор игры .

Создать рекламный блок

Перейдите в «Монетизация» > «Рекламные блоки» , затем нажмите «Добавить рекламный блок» .

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

Андроид

iOS

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

Добавить место размещения

Торги

Свяжитесь с менеджером своего аккаунта Google, чтобы создать места размещения для ставок.

Водопад

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

Заполните необходимые данные и нажмите «Добавить место размещения» .

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

Андроид

iOS

Найдите ключ API отчетов Unity Ads.

Торги

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

Водопад

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

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

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

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

Тестовый режим можно включить из панели управления Unity Ads . В настройках вашего проекта выберите вкладку «Тестирование» .

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

Андроид

iOS

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

Заполните форму и нажмите Сохранить .

Шаг 2. Настройте спрос на Unity Ads в Ad Manager пользовательский интерфейс

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

Андроид

Инструкции см. в шаге 2 руководства поАндроид .

iOS

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

Добавлять Unity Ads в соответствии с GDPR и списком рекламных партнеров США.

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

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

Примечание. Невозможность интеграции совместимых версий Unity Ads и Google Mobile Ads SDK может привести к проблемам при сборке.

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

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

dependencies:
  gma_mediation_unity: ^1.0.0

Ручная интеграция

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

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

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

Согласие ЕС и GDPR

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

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

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

GmaMediationUnity.setGDPRConsent(true);

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

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

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

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

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

GmaMediationUnity.setCCPAConsent(true);

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

Андроид

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

iOS

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

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

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

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

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

Важно: отключите тестовый режим для 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 завершил работу с состоянием ОШИБКА.
200-204	Баннер UnityAds: конкретная ошибка. См. код для более подробной информации.

iOS

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

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

Версия 1.1.0

• Проверенная совместимость с адаптером Unity Android версии 4.12.3.0.
• Проверенная совместимость с адаптером Unity iOS версии 4.12.3.1.
• Создано и протестировано с помощью плагина Google Mobile Ads Flutter версии 5.2.0.

Версия 1.0.0

• Первоначальный выпуск.
• Проверенная совместимость с адаптером Unity Android версии 4.10.0.0.
• Проверенная совместимость с адаптером Unity iOS версии 4.10.0.0.
• Создано и протестировано с помощью плагина Google Mobile Ads Flutter версии 5.0.0.