В этом руководстве показано, как использовать Google Mobile Ads SDK для загрузки и отображения рекламы из IronSource Ads с помощью медиации , а также каскадной интеграции. В нем рассказывается, как добавить IronSource Ads в конфигурацию медиации рекламного блока, а также как интегрировать IronSource Ads SDK и адаптер в Unity приложение.
Поддерживаемые интеграции и форматы объявлений
AdMob Адаптер медиации для IronSource Ads обладает следующими возможностями:
Интеграция | |
---|---|
Торги | 1 |
Водопад | |
Форматы | |
Баннер | 2 |
Межстраничный | |
Награжден | |
Межстраничное объявление с вознаграждением | 2 |
1 Интеграция назначения ставок находится на стадии закрытого бета-тестирования. Чтобы запросить доступ, обратитесь к менеджеру своего аккаунта.
2 Этот формат поддерживается только при каскадной интеграции.
Требования
- Последняя версия Google Mobile Ads SDK
- Юнити 4 или выше
- [Для назначения ставок]: чтобы интегрировать все поддерживаемые форматы объявлений в назначение ставок, используйте плагин посредничества Google Mobile Ads для IronSource 3.0.0 или более поздней версии ( рекомендуется последняя версия ).
- Развертывание на Android
- Android API уровня 21 или выше
- Развертывание на iOS
- Цель развертывания iOS 12.0 или выше
- Рабочий Unity проект, настроенный с помощью Google Mobile Ads SDK. Подробности см. в разделе « Начало работы ».
- Пройдите руководство по началу работы с медиацией
Шаг 1. Настройте конфигурации в пользовательском интерфейсе IronSource Ads.
Зарегистрируйтесь и войдите в свою учетную запись IronSource Ads.
Чтобы добавить свое приложение на панель управления IronSource Ads, нажмите кнопку « Новое приложение» .
Введите данные приложения
Выберите Live App , введите название своего приложения и нажмите «Импортировать информацию о приложении» .
Если ваше приложение недоступно, выберите «Приложение не доступно» в магазине приложений и укажите временное имя для вашего приложения. Выберите свою платформу .
Заполните остальную часть формы и нажмите «Добавить приложение» .
Запишите свой новый ключ приложения , который отображается после добавления приложения. Это значение понадобится вам для настройки идентификатора рекламного блока AdMob. Выберите форматы рекламы, которые поддерживает ваше приложение. Затем нажмите Продолжить .
Андроид
iOS
Создать экземпляр
Затем настройте сетевой экземпляр для добавленного вами приложения.
Торги
Перейдите в LevelPlay > Настройка > Сети SDK , затем выберите свое приложение. В разделе «Ставки » нажмите значок редактирования, чтобы просмотреть идентификатор экземпляра назначения ставок.
Андроид
iOS
Обратите внимание на идентификатор экземпляра .
Андроид
iOS
Водопад
Перейдите в «Объявления» > «Настройка» > «Экземпляры» . Выберите приложение и нажмите «Создать экземпляр» .
Введите необходимые данные и нажмите «Сохранить и закрыть» .
После создания экземпляра идентификатор экземпляра отображается в поле «Идентификатор экземпляра» .
Найдите свой ключ API отчетности
Торги
Этот шаг не требуется для интеграции ставок.
Водопад
Помимо ключа приложения и идентификатора экземпляра , вам также понадобится секретный ключ IronSource Ads и токен обновления , чтобы настроить идентификатор рекламного блока AdMob.
Перейдите в раздел «Моя учетная запись» на панели издателя IronSource Ads, затем перейдите на вкладку API . Запишите свой секретный ключ и токен обновления .
Включите тестовый режим
Следуйте инструкциям в руководстве по интеграционному тестированию IronSource Ads о том, как включить тестовые объявления IronSource Ads.
Шаг 2. Настройте спрос на рекламу IronSource в AdMob пользовательский интерфейс
Настройте параметры медиации для своего рекламного блока
Андроид
Инструкции см. в шаге 2 руководства для Android .
iOS
Инструкции см. в шаге 2 руководства для iOS .
Добавлять ironSource Mobile в соответствии с GDPR и списком рекламных партнеров США.
Следуйте инструкциям в настройках GDPR и настройках государственного регулирования США , чтобы добавить IronSource Mobile в список рекламных партнеров GDPR и государственного регулирования США в пользовательском интерфейсе AdMob.
Шаг 3. Импортируйте IronSource Ads SDK и адаптер.
OpenUPM-CLI
Если у вас установлен OpenUPM-CLI , вы можете установить плагин посредничества IronSource Ads Mediation Google Mobile Ads для Unity в свой проект, выполнив следующую команду из корневого каталога вашего проекта:
openupm add com.google.ads.mobile.mediation.ironsource
ОпенУПМ
В редакторе проекта Unity выберите «Правка» > «Настройки проекта» > «Диспетчер пакетов» , чтобы открыть настройки диспетчера пакетов Unity .
На вкладке «Регистрации с ограниченной областью» добавьте OpenUPM в качестве реестра с ограниченной областью действия со следующими сведениями:
- Имя:
OpenUPM
- URL-адрес:
https://package.openupm.com
. - Область применения:
com.google
Затем перейдите в «Окно» > «Диспетчер пакетов» , чтобы открыть диспетчер пакетов Unity , и выберите «Мои реестры» в раскрывающемся меню.
Выберите пакет Google Mobile Ads IronSource Ads Mediation и нажмите «Установить» .
Пакет Единства
Загрузите последнюю версию плагина-посредника Google Mobile Ads для IronSource Ads по ссылке для скачивания в журнале изменений и извлеките пакет GoogleMobileAdsIronSourceMediation.unitypackage
из ZIP-файла.
В редакторе проекта Unity выберите «Активы» > «Импортировать пакет» > «Пользовательский пакет» и найдите загруженный вами файл GoogleMobileAdsIronSourceMediation.unitypackage
. Убедитесь, что все файлы выбраны, и нажмите «Импортировать» .
Затем выберите «Активы» > «Диспетчер внешних зависимостей» > «Android Resolver» > «Принудительное разрешение» . Библиотека диспетчера внешних зависимостей выполнит разрешение зависимостей с нуля и скопирует объявленные зависимости в каталог Assets/Plugins/Android
вашего приложения Unity.
Шаг 4. Внедрите настройки конфиденциальности в IronSource Ads SDK.
Согласие ЕС и GDPR
В соответствии с Политикой согласия пользователей Google из ЕС вы должны гарантировать, что пользователям в Европейской экономической зоне (ЕЭЗ) будет предоставлена определенная информация и получено от них согласие на использование идентификаторов устройств и личных данных. Эта политика отражает требования Директивы ЕС об электронной конфиденциальности и Общего регламента защиты данных (GDPR). При запросе согласия вы должны указать каждую рекламную сеть в вашей цепочке посредничества, которая может собирать, получать или использовать персональные данные, а также предоставлять информацию об использовании каждой сети. В настоящее время Google не может автоматически передавать выбор согласия пользователя в такие сети.
Плагин посредничества Google Mobile Ads для IronSource Adsверсия 1.0.0включает в себяIronSource.SetConsent()
метод. В следующем примере кода показано, как передать информацию о согласии в IronSource Ads SDK. Если вы решите вызвать этот метод, рекомендуется сделать это до запроса рекламы через Google Mobile Ads SDK.
using GoogleMobileAds.Api.Mediation.IronSource;
// ...
IronSource.SetConsent(true);
Дополнительную информацию см. в документации IronSource Ads по расширенным настройкам регулирования .
Законы штата США о конфиденциальности
Законы о конфиденциальности штатов США требуют предоставления пользователям права отказаться от «продажи» их «личной информации» (согласно определению этих условий в законе), при этом отказ предлагается через заметную ссылку «Не продавать мою личную информацию» на странице «продажа». " Домашняя страница партии. Руководство по соблюдению законов о конфиденциальности штатов США предлагает возможность включить ограниченную обработку данных для показа рекламы Google, но Google не может применить этот параметр к каждой рекламной сети в вашей цепочке медиации. Таким образом, вы должны определить каждую рекламную сеть в вашей цепочке посредничества, которая может участвовать в продаже личной информации, и следовать инструкциям каждой из этих сетей, чтобы обеспечить соблюдение требований.
Плагин посредничества Google Mobile Ads для IronSource Adsверсия 2.2.4включает в себяIronSource.SetMetaData()
метод. В следующем примере кода показано, как передать информацию о согласии в IronSource Ads SDK. Эти параметры необходимо установить до инициализации Google Mobile Ads SDK , чтобы обеспечить их правильную пересылку в IronSource Ads SDK.
using GoogleMobileAds.Api.Mediation.IronSource;
// ...
IronSource.SetMetaData("do_not_sell", "true");
Дополнительную информацию и значения, которые можно указать в методе, см. в документации IronSource Ads по расширенным настройкам регулирования для Android и iOS .
Шаг 5. Добавьте необходимый код.
Андроид
Правила Прогарда
Если вы сжимаете, запутываете и оптимизируете свое приложение , IronSource Ads потребует дополнительных правил ProGuard для вашего проекта.
При создании проекта выберите Android в качестве платформы . Затем откройте «Настройки проигрывателя» и проверьте «Файл User Proguard» на вкладке «Настройки публикации» . Unity должен показать, где был создан пользовательский файл proguard-user.txt
, который вы можете изменить.
Обратитесь к руководству по интеграции Android SDK компании IronSource Ads для получения дополнительной информации о том, какие правила ProGuard необходимы для вашего проекта, и добавьте эти правила в файл proguard-user.txt
.
iOS
Интеграция со SKAdNetwork
Следуйте документации IronSource Ads , чтобы добавить идентификаторы SKAdNetwork в файл Info.plist
вашего проекта.
Шаг 6. Проверьте свою реализацию
Включить тестовые объявления
Убедитесь, что вы зарегистрировали свое тестовое устройство для AdMob и включили тестовый режим в пользовательском интерфейсе IronSource Ads.
Проверьте тестовые объявления
Чтобы убедиться, что вы получаете тестовые объявления от IronSource Ads, включите тестирование одного источника объявлений в инспекторе объявлений, используя источники объявлений IronSource Ads (Biddding) и IronSource Ads (Waterfall) .
Коды ошибок
Если адаптеру не удается получить рекламу от IronSource Ads, издатели могут проверить основную ошибку из ответа на объявление, используя ResponseInfo
в следующих классах:
Андроид
com.google.ads.mediation.ironsource.IronSourceAdapter
com.google.ads.mediation.ironsource.IronSourceRewardedAdapter
iOS
GADMAdapterIronSource
GADMAdapterIronSourceRewarded
Вот коды и сопутствующие сообщения, выдаваемые адаптером IronSource Ads, когда объявление не загружается:
Андроид
Код ошибки | Причина |
---|---|
101 | Параметры сервера IronSource Ads, настроенные в AdMob Пользовательский интерфейс отсутствует/недействителен. |
102 | IronSource Ads требует контекст активности для инициализации своего SDK. |
103 | IronSource Ads может загружать только 1 объявление для каждого идентификатора экземпляра IronSource. |
105 | Запрошенный размер баннерной рекламы не поддерживается IronSource Ads. |
106 | IronSource Ads SDK не инициализирован. |
501-1056 | Ошибки IronSource Ads SDK. Более подробную информацию смотрите в документации . |
iOS
Код ошибки | Причина |
---|---|
101 | Параметры сервера IronSource Ads, настроенные в AdMob Пользовательский интерфейс отсутствует/недействителен. |
102 | IronSource Ads Adaptor не поддерживает запрошенный формат объявления. |
103 | Для этой конфигурации сети уже загружено объявление IronSource. |
104 | Запрошенный размер баннерной рекламы не поддерживается IronSource Ads. |
508-1037 | Ошибки IronSource Ads SDK. Более подробную информацию смотрите в документации . |
Журнал изменений плагина IronSource Unity Mediation
Версия 3.4.0
- Поддерживает адаптер IronSource Android версии 8.4.0.0 .
- Поддерживает адаптер IronSource iOS версии 8.4.0.0.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 9.2.1.
Версия 3.3.1
- Поддерживает адаптер IronSource Android версии 8.3.0.0 .
- Поддерживает адаптер IronSource iOS версии 8.3.0.0.1 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 9.2.0.
Версия 3.3.0
- Поддерживает адаптер IronSource Android версии 8.3.0.0 .
- Поддерживает адаптер IronSource iOS версии 8.3.0.0.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 9.2.0.
Версия 3.2.1
-
DummyClient
переименован вPlaceholderClient
. - Поддерживает адаптер IronSource Android версии 8.2.1.0 .
- Поддерживает адаптер IronSource iOS версии 8.2.0.0.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 9.2.0.
Версия 3.2.0
- Поддерживает адаптер IronSource Android версии 8.2.0.0 .
- Поддерживает адаптер IronSource iOS версии 8.2.0.0.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 9.1.1.
Версия 3.1.1
- Поддерживает адаптер IronSource Android версии 8.1.0.0 .
- Поддерживает адаптер IronSource iOS версии 8.1.1.0.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 9.1.1.
Версия 3.1.0
- Поддерживает адаптер IronSource Android версии 8.1.0.0 .
- Поддерживает адаптер IronSource iOS версии 8.1.0.0.1 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 9.1.0.
Версия 3.0.1
- Поддерживает адаптер IronSource Android версии 8.0.0.1 .
- Поддерживает адаптер IronSource iOS версии 8.0.0.0.1 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 9.1.0.
Версия 3.0.0
- Поддерживает адаптер IronSource Android версии 8.0.0.0 .
- Поддерживает адаптер IronSource iOS версии 8.0.0.0.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 9.0.0.
Версия 2.6.1
- Поддерживает адаптер IronSource Android версии 7.9.0.0 .
- Поддерживает адаптер IronSource iOS версии 7.9.1.0.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 9.0.0.
Версия 2.6.0
- Поддерживает адаптер IronSource Android версии 7.9.0.0 .
- Поддерживает адаптер IronSource iOS версии 7.9.0.0.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 9.0.0.
Версия 2.5.0
- Поддерживает адаптер IronSource Android версии 7.6.0.0 .
- Поддерживает адаптер IronSource iOS версии 7.6.0.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 8.6.0.
Версия 2.4.0
- Поддерживает адаптер IronSource Android версии 7.5.2.0 .
- Поддерживает адаптер IronSource iOS версии 7.5.1.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 8.6.0.
Версия 2.3.1
- Поддерживает адаптер IronSource Android версии 7.3.1.0 .
- Поддерживает адаптер IronSource iOS версии 7.3.1.0.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 8.3.0.
Версия 2.3.0
- Содержимое адаптера перенесено в
GoogleMobileAds/Mediation/IronSource/
. - Пространство имен адаптера изменено для использования
GoogleMobileAds.Mediation.IronSource
. - Поддерживает адаптер IronSource Android версии 7.3.0.1.0 .
- Поддерживает адаптер IronSource iOS версии 7.3.0.0.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 8.1.0.
Версия 2.2.7
- Поддерживает адаптер IronSource Android версии 7.2.7.0 .
- Поддерживает адаптер IronSource iOS версии 7.2.7.0.1 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 7.4.1.
Версия 2.2.6
- Поддерживает адаптер IronSource Android версии 7.2.6.0 .
- Поддерживает адаптер IronSource iOS версии 7.2.6.0.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 7.3.1.
Версия 2.2.5
- Поддерживает адаптер IronSource Android версии 7.2.5.0 .
- Поддерживает адаптер IronSource iOS версии 7.2.5.1.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 7.3.0.
Версия 2.2.4
- Добавлен метод
IronSource.SetMetaData(string, string)
. - Поддерживает адаптер IronSource Android версии 7.2.3.1.0 .
- Поддерживает адаптер IronSource iOS версии 7.2.4.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 7.2.0.
Версия 2.2.3
- Поддерживает адаптер IronSource Android версии 7.2.3.1.0 .
- Поддерживает адаптер IronSource iOS версии 7.2.3.1.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 7.1.0.
Версия 2.2.2
- Поддерживает адаптер IronSource Android версии 7.2.2.1.0 .
- Поддерживает адаптер IronSource iOS версии 7.2.2.1.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 7.0.2.
Версия 2.2.1
- Поддерживает адаптер IronSource Android версии 7.2.1.1.0 .
- Поддерживает адаптер IronSource iOS версии 7.2.1.2.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 7.0.0.
Версия 2.2.0
- Поддерживает адаптер IronSource Android версии 7.2.1.0 .
- Поддерживает адаптер IronSource iOS версии 7.2.1.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 7.0.0.
Версия 2.1.5
- Поддерживает адаптер IronSource Android версии 7.1.14.0 .
- Поддерживает адаптер IronSource iOS версии 7.1.14.0 .
Версия 2.1.4
- Поддерживает адаптер IronSource Android версии 7.1.13.0 .
- Поддерживает адаптер IronSource iOS версии 7.1.13.0 .
Версия 2.1.3
- Поддерживает адаптер IronSource Android версии 7.1.12.0 .
- Поддерживает адаптер IronSource iOS версии 7.1.12.0 .
Версия 2.1.2
- Поддерживает адаптер IronSource Android версии 7.1.11.1.0 .
- Поддерживает адаптер IronSource iOS версии 7.1.11.1.0 .
Версия 2.1.1
- Поддерживает адаптер IronSource Android версии 7.1.8.0 .
- Поддерживает адаптер IronSource iOS версии 7.1.8.0 .
Версия 2.1.0
- Поддерживает адаптер IronSource Android версии 7.1.6.0 .
- Поддерживает адаптер IronSource iOS версии 7.1.6.1.0 .
Версия 2.0.3
- Поддерживает адаптер IronSource Android версии 7.0.3.1.0 .
- Поддерживает адаптер IronSource iOS версии 7.0.3.0 .
Версия 2.0.2
- Поддерживает адаптер IronSource Android версии 7.0.2.0 .
- Поддерживает адаптер IronSource iOS версии 7.0.2.0 .
Версия 2.0.1
- Поддерживает адаптер IronSource Android версии 7.0.1.1.0 .
- Поддерживает адаптер IronSource iOS версии 7.0.1.0 .
Версия 2.0.0
- Поддерживает адаптер IronSource Android версии 7.0.0.0 .
- Поддерживает адаптер IronSource iOS версии 7.0.0.0 .
Версия 1.10.0
- Поддерживает адаптер IronSource Android версии 6.18.0.0 .
- Поддерживает адаптер IronSource iOS версии 6.18.0.0 .
Версия 1.9.1
- Поддерживает адаптер IronSource Android версии 6.17.0.1 .
- Поддерживает адаптер IronSource iOS версии 6.17.0.1.0 .
Версия 1.9.0
- Поддерживает адаптер IronSource Android версии 6.17.0.0 .
- Поддерживает адаптер IronSource iOS версии 6.16.3.0 .
Версия 1.8.2
- Поддерживает адаптер IronSource Android версии 6.16.2.0 .
- Поддерживает адаптер IronSource iOS версии 6.16.2.0 .
Версия 1.8.1
- Поддерживает адаптер IronSource Android версии 6.16.1.0 .
- Поддерживает адаптер IronSource iOS версии 6.16.1.0 .
Версия 1.8.0
- Поддерживает адаптер IronSource Android версии 6.16.0.0 .
- Поддерживает адаптер IronSource iOS версии 6.16.0.0 .
Версия 1.7.0
- Поддерживает адаптер IronSource Android версии 6.15.0.1.0 .
- Поддерживает адаптер IronSource iOS версии 6.15.0.1.0 .
Версия 1.6.0
- Поддерживает адаптер IronSource Android версии 6.14.0.1.0 .
- Поддерживает адаптер IronSource iOS версии 6.14.0.0 .
Версия 1.5.0
- Поддерживает адаптер IronSource Android версии 6.13.0.1.0 .
- Поддерживает адаптер IronSource iOS версии 6.13.1.0.0 .
Версия 1.4.0
- Поддерживает адаптер IronSource Android версии 6.12.0.0 .
- Поддерживает адаптер IronSource iOS версии 6.12.0.0 .
Версия 1.3.2
- Поддерживает адаптер IronSource Android версии 6.10.0.0 .
- Поддерживает адаптер IronSource iOS версии 6.8.7.0 .
Версия 1.3.1
- Поддерживает адаптер IronSource Android версии 6.10.0.0.
- Поддерживает адаптер IronSource iOS версии 6.8.6.0.
Версия 1.3.0
- Поддерживает адаптер IronSource Android версии 6.10.0.0.
- Поддерживает адаптер IronSource iOS версии 6.8.4.1.0.
Версия 1.2.0
- Поддерживает адаптер IronSource Android версии 6.9.0.1.
- Поддерживает адаптер IronSource iOS версии 6.8.4.1.0.
Версия 1.1.2
- Поддерживает адаптер IronSource Android версии 6.8.4.1.
- Поддерживает адаптер IronSource iOS версии 6.8.4.1.
Версия 1.1.1
- Поддерживает адаптер IronSource Android версии 6.8.4.1.
- Поддерживает адаптер IronSource iOS версии 6.8.3.0.
Версия 1.1.0
- Обновлен плагин для поддержки новой открытой бета-версии Rewarded API.
- Поддерживает адаптер IronSource Android версии 6.8.1.2.
- Поддерживает адаптер IronSource iOS версии 6.8.0.1.
Версия 1.0.4
- Поддерживает адаптер IronSource Android версии 6.7.11.0.
- Поддерживает адаптер IronSource iOS версии 6.7.11.0.
Версия 1.0.3
- Поддерживает адаптер IronSource Android версии 6.7.10.0.
- Поддерживает адаптер IronSource iOS версии 6.7.10.0.
Версия 1.0.2
- Поддерживает адаптер IronSource Android версии 6.7.9.1.1.
- Поддерживает адаптер IronSource iOS версии 6.7.10.0.
- Исправлен конфликт с плагином-посредником Chartboost Unity.
Версия 1.0.1
- Поддерживает адаптер IronSource Android версии 6.7.9.0.
- Поддерживает адаптер IronSource iOS версии 6.7.9.2.0.
Версия 1.0.0
- Первый выпуск!
- Поддерживает адаптер IronSource Android версии 6.7.9.0.
- Поддерживает адаптер IronSource iOS версии 6.7.9.1.0.
В этом руководстве показано, как использовать Google Mobile Ads SDK для загрузки и отображения рекламы из IronSource Ads с помощью медиации , а также каскадной интеграции. В нем рассказывается, как добавить IronSource Ads в конфигурацию медиации рекламного блока, а также как интегрировать IronSource Ads SDK и адаптер в Unity приложение.
Поддерживаемые интеграции и форматы объявлений
AdMob Адаптер медиации для IronSource Ads обладает следующими возможностями:
Интеграция | |
---|---|
Торги | 1 |
Водопад | |
Форматы | |
Баннер | 2 |
Межстраничный | |
Награжден | |
Межстраничное объявление с вознаграждением | 2 |
1 Интеграция назначения ставок находится на стадии закрытого бета-тестирования. Чтобы запросить доступ, обратитесь к менеджеру своего аккаунта.
2 Этот формат поддерживается только при каскадной интеграции.
Требования
- Последняя версия Google Mobile Ads SDK
- Юнити 4 или выше
- [Для назначения ставок]: чтобы интегрировать все поддерживаемые форматы объявлений в назначение ставок, используйте плагин посредничества Google Mobile Ads для IronSource 3.0.0 или более поздней версии ( рекомендуется последняя версия ).
- Развертывание на Android
- Android API уровня 21 или выше
- Развертывание на iOS
- Цель развертывания iOS 12.0 или выше
- Рабочий Unity проект, настроенный с помощью Google Mobile Ads SDK. Подробности см. в разделе « Начало работы ».
- Пройдите руководство по началу работы с медиацией
Шаг 1. Настройте конфигурации в пользовательском интерфейсе IronSource Ads.
Зарегистрируйтесь и войдите в свою учетную запись IronSource Ads.
Чтобы добавить свое приложение на панель управления IronSource Ads, нажмите кнопку « Новое приложение» .
Введите данные приложения
Выберите Live App , введите название своего приложения и нажмите «Импортировать информацию о приложении» .
Если ваше приложение недоступно, выберите «Приложение не доступно» в магазине приложений и укажите временное имя для вашего приложения. Выберите свою платформу .
Заполните остальную часть формы и нажмите «Добавить приложение» .
Запишите свой новый ключ приложения , который отображается после добавления приложения. Это значение понадобится вам для настройки идентификатора рекламного блока AdMob. Выберите форматы рекламы, которые поддерживает ваше приложение. Затем нажмите Продолжить .
Андроид
iOS
Создать экземпляр
Затем настройте сетевой экземпляр для добавленного вами приложения.
Торги
Перейдите в LevelPlay > Настройка > Сети SDK , затем выберите свое приложение. В разделе «Ставки » нажмите значок редактирования, чтобы просмотреть идентификатор экземпляра назначения ставок.
Андроид
iOS
Обратите внимание на идентификатор экземпляра .
Андроид
iOS
Водопад
Перейдите в «Объявления» > «Настройка» > «Экземпляры» . Выберите приложение и нажмите «Создать экземпляр» .
Введите необходимые данные и нажмите «Сохранить и закрыть» .
После создания экземпляра идентификатор экземпляра отображается в поле «Идентификатор экземпляра» .
Найдите свой ключ API отчетности
Торги
Этот шаг не требуется для интеграции ставок.
Водопад
Помимо ключа приложения и идентификатора экземпляра , вам также понадобится секретный ключ IronSource Ads и токен обновления , чтобы настроить идентификатор рекламного блока AdMob.
Перейдите в раздел «Моя учетная запись» на панели издателя IronSource Ads, затем перейдите на вкладку API . Запишите свой секретный ключ и токен обновления .
Включите тестовый режим
Следуйте инструкциям в руководстве по интеграционному тестированию IronSource Ads о том, как включить тестовые объявления IronSource Ads.
Шаг 2. Настройте спрос на рекламу IronSource в AdMob пользовательский интерфейс
Настройте параметры медиации для своего рекламного блока
Андроид
Инструкции см. в шаге 2 руководства для Android .
iOS
Инструкции см. в шаге 2 руководства для iOS .
Добавлять ironSource Mobile в соответствии с GDPR и списком рекламных партнеров США.
Следуйте инструкциям в настройках GDPR и настройках государственного регулирования США , чтобы добавить IronSource Mobile в список рекламных партнеров GDPR и государственного регулирования США в пользовательском интерфейсе AdMob.
Шаг 3. Импортируйте IronSource Ads SDK и адаптер.
OpenUPM-CLI
Если у вас установлен OpenUPM-CLI , вы можете установить плагин посредничества IronSource Ads Mediation Google Mobile Ads для Unity в свой проект, выполнив следующую команду из корневого каталога вашего проекта:
openupm add com.google.ads.mobile.mediation.ironsource
ОпенУПМ
В редакторе проекта Unity выберите «Правка» > «Настройки проекта» > «Диспетчер пакетов» , чтобы открыть настройки диспетчера пакетов Unity .
На вкладке «Регистрации с ограниченной областью» добавьте OpenUPM в качестве реестра с ограниченной областью действия со следующими сведениями:
- Имя:
OpenUPM
- URL-адрес:
https://package.openupm.com
. - Область применения:
com.google
Затем перейдите в «Окно» > «Диспетчер пакетов» , чтобы открыть диспетчер пакетов Unity , и выберите «Мои реестры» в раскрывающемся меню.
Выберите пакет Google Mobile Ads IronSource Ads Mediation и нажмите «Установить» .
Пакет Единства
Загрузите последнюю версию плагина-посредника Google Mobile Ads для IronSource Ads по ссылке для скачивания в журнале изменений и извлеките пакет GoogleMobileAdsIronSourceMediation.unitypackage
из ZIP-файла.
В редакторе проекта Unity выберите «Активы» > «Импортировать пакет» > «Пользовательский пакет» и найдите загруженный вами файл GoogleMobileAdsIronSourceMediation.unitypackage
. Убедитесь, что все файлы выбраны, и нажмите «Импортировать» .
Затем выберите «Активы» > «Диспетчер внешних зависимостей» > «Android Resolver» > «Принудительное разрешение» . Библиотека диспетчера внешних зависимостей выполнит разрешение зависимостей с нуля и скопирует объявленные зависимости в каталог Assets/Plugins/Android
вашего приложения Unity.
Шаг 4. Внедрите настройки конфиденциальности в IronSource Ads SDK.
Согласие ЕС и GDPR
В соответствии с Политикой согласия пользователей Google из ЕС вы должны гарантировать, что пользователям в Европейской экономической зоне (ЕЭЗ) будет предоставлена определенная информация и получено от них согласие на использование идентификаторов устройств и личных данных. Эта политика отражает требования Директивы ЕС об электронной конфиденциальности и Общего регламента защиты данных (GDPR). При запросе согласия вы должны указать каждую рекламную сеть в вашей цепочке посредничества, которая может собирать, получать или использовать персональные данные, а также предоставлять информацию об использовании каждой сети. В настоящее время Google не может автоматически передавать выбор согласия пользователя в такие сети.
Плагин посредничества Google Mobile Ads для IronSource Adsверсия 1.0.0включает в себяIronSource.SetConsent()
метод. В следующем примере кода показано, как передать информацию о согласии в IronSource Ads SDK. Если вы решите вызвать этот метод, рекомендуется сделать это до запроса рекламы через Google Mobile Ads SDK.
using GoogleMobileAds.Api.Mediation.IronSource;
// ...
IronSource.SetConsent(true);
Дополнительную информацию см. в документации IronSource Ads по расширенным настройкам регулирования .
Законы штата США о конфиденциальности
Законы о конфиденциальности штатов США требуют предоставления пользователям права отказаться от «продажи» их «личной информации» (согласно определению этих условий в законе), при этом отказ предлагается через заметную ссылку «Не продавать мою личную информацию» на странице «продажа». " Домашняя страница партии. Руководство по соблюдению законов о конфиденциальности штатов США предлагает возможность включить ограниченную обработку данных для показа рекламы Google, но Google не может применить этот параметр к каждой рекламной сети в вашей цепочке медиации. Таким образом, вы должны определить каждую рекламную сеть в вашей цепочке посредничества, которая может участвовать в продаже личной информации, и следовать инструкциям каждой из этих сетей, чтобы обеспечить соблюдение требований.
Плагин посредничества Google Mobile Ads для IronSource Adsверсия 2.2.4включает в себяIronSource.SetMetaData()
метод. В следующем примере кода показано, как передать информацию о согласии в IronSource Ads SDK. Эти параметры необходимо установить до инициализации Google Mobile Ads SDK , чтобы обеспечить их правильную пересылку в IronSource Ads SDK.
using GoogleMobileAds.Api.Mediation.IronSource;
// ...
IronSource.SetMetaData("do_not_sell", "true");
Дополнительную информацию и значения, которые можно указать в методе, см. в документации IronSource Ads по расширенным настройкам регулирования для Android и iOS .
Шаг 5. Добавьте необходимый код.
Андроид
Правила Прогарда
Если вы сжимаете, запутываете и оптимизируете свое приложение , IronSource Ads потребует дополнительных правил ProGuard для вашего проекта.
При создании проекта выберите Android в качестве платформы . Затем откройте «Настройки проигрывателя» и проверьте «Файл User Proguard» на вкладке «Настройки публикации» . Unity должен показать, где был создан пользовательский файл proguard-user.txt
, который вы можете изменить.
Обратитесь к руководству по интеграции Android SDK компании IronSource Ads для получения дополнительной информации о том, какие правила ProGuard необходимы для вашего проекта, и добавьте эти правила в файл proguard-user.txt
.
iOS
Интеграция со SKAdNetwork
Следуйте документации IronSource Ads , чтобы добавить идентификаторы SKAdNetwork в файл Info.plist
вашего проекта.
Шаг 6. Проверьте свою реализацию
Включить тестовые объявления
Убедитесь, что вы зарегистрировали свое тестовое устройство для AdMob и включили тестовый режим в пользовательском интерфейсе IronSource Ads.
Проверьте тестовые объявления
Чтобы убедиться, что вы получаете тестовые объявления от IronSource Ads, включите тестирование одного источника объявлений в инспекторе объявлений, используя источники объявлений IronSource Ads (Biddding) и IronSource Ads (Waterfall) .
Коды ошибок
Если адаптеру не удается получить рекламу от IronSource Ads, издатели могут проверить основную ошибку из ответа на объявление, используя ResponseInfo
в следующих классах:
Андроид
com.google.ads.mediation.ironsource.IronSourceAdapter
com.google.ads.mediation.ironsource.IronSourceRewardedAdapter
iOS
GADMAdapterIronSource
GADMAdapterIronSourceRewarded
Вот коды и сопутствующие сообщения, выдаваемые адаптером IronSource Ads, когда объявление не загружается:
Андроид
Код ошибки | Причина |
---|---|
101 | Параметры сервера IronSource Ads, настроенные в AdMob Пользовательский интерфейс отсутствует/недействителен. |
102 | IronSource Ads требует контекст активности для инициализации своего SDK. |
103 | IronSource Ads может загружать только 1 объявление для каждого идентификатора экземпляра IronSource. |
105 | Запрошенный размер баннерной рекламы не поддерживается IronSource Ads. |
106 | IronSource Ads SDK не инициализирован. |
501-1056 | Ошибки IronSource Ads SDK. Более подробную информацию смотрите в документации . |
iOS
Код ошибки | Причина |
---|---|
101 | Параметры сервера IronSource Ads, настроенные в AdMob Пользовательский интерфейс отсутствует/недействителен. |
102 | IronSource Ads Adaptor не поддерживает запрошенный формат объявления. |
103 | Для этой конфигурации сети уже загружено объявление IronSource. |
104 | Запрошенный размер баннерной рекламы не поддерживается IronSource Ads. |
508-1037 | Ошибки IronSource Ads SDK. Более подробную информацию смотрите в документации . |
Журнал изменений плагина IronSource Unity Mediation
Версия 3.4.0
- Поддерживает адаптер IronSource Android версии 8.4.0.0 .
- Поддерживает адаптер IronSource iOS версии 8.4.0.0.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 9.2.1.
Версия 3.3.1
- Поддерживает адаптер IronSource Android версии 8.3.0.0 .
- Поддерживает адаптер IronSource iOS версии 8.3.0.0.1 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 9.2.0.
Версия 3.3.0
- Поддерживает адаптер IronSource Android версии 8.3.0.0 .
- Поддерживает адаптер IronSource iOS версии 8.3.0.0.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 9.2.0.
Версия 3.2.1
-
DummyClient
переименован вPlaceholderClient
. - Поддерживает адаптер IronSource Android версии 8.2.1.0 .
- Поддерживает адаптер IronSource iOS версии 8.2.0.0.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 9.2.0.
Версия 3.2.0
- Поддерживает адаптер IronSource Android версии 8.2.0.0 .
- Поддерживает адаптер IronSource iOS версии 8.2.0.0.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 9.1.1.
Версия 3.1.1
- Поддерживает адаптер IronSource Android версии 8.1.0.0 .
- Поддерживает адаптер IronSource iOS версии 8.1.1.0.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 9.1.1.
Версия 3.1.0
- Поддерживает адаптер IronSource Android версии 8.1.0.0 .
- Поддерживает адаптер IronSource iOS версии 8.1.0.0.1 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 9.1.0.
Версия 3.0.1
- Поддерживает адаптер IronSource Android версии 8.0.0.1 .
- Поддерживает адаптер IronSource iOS версии 8.0.0.0.1 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 9.1.0.
Версия 3.0.0
- Поддерживает адаптер IronSource Android версии 8.0.0.0 .
- Поддерживает адаптер IronSource iOS версии 8.0.0.0.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 9.0.0.
Версия 2.6.1
- Поддерживает адаптер IronSource Android версии 7.9.0.0 .
- Поддерживает адаптер IronSource iOS версии 7.9.1.0.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 9.0.0.
Версия 2.6.0
- Поддерживает адаптер IronSource Android версии 7.9.0.0 .
- Поддерживает адаптер IronSource iOS версии 7.9.0.0.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 9.0.0.
Версия 2.5.0
- Поддерживает адаптер IronSource Android версии 7.6.0.0 .
- Поддерживает адаптер IronSource iOS версии 7.6.0.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 8.6.0.
Версия 2.4.0
- Поддерживает адаптер IronSource Android версии 7.5.2.0 .
- Поддерживает адаптер IronSource iOS версии 7.5.1.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 8.6.0.
Версия 2.3.1
- Поддерживает адаптер IronSource Android версии 7.3.1.0 .
- Поддерживает адаптер IronSource iOS версии 7.3.1.0.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 8.3.0.
Версия 2.3.0
- Содержимое адаптера перенесено в
GoogleMobileAds/Mediation/IronSource/
. - Пространство имен адаптера изменено для использования
GoogleMobileAds.Mediation.IronSource
. - Поддерживает адаптер IronSource Android версии 7.3.0.1.0 .
- Поддерживает адаптер IronSource iOS версии 7.3.0.0.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 8.1.0.
Версия 2.2.7
- Поддерживает адаптер IronSource Android версии 7.2.7.0 .
- Поддерживает адаптер IronSource iOS версии 7.2.7.0.1 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 7.4.1.
Версия 2.2.6
- Поддерживает адаптер IronSource Android версии 7.2.6.0 .
- Поддерживает адаптер IronSource iOS версии 7.2.6.0.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 7.3.1.
Версия 2.2.5
- Поддерживает адаптер IronSource Android версии 7.2.5.0 .
- Поддерживает адаптер IronSource iOS версии 7.2.5.1.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 7.3.0.
Версия 2.2.4
- Добавлен метод
IronSource.SetMetaData(string, string)
. - Поддерживает адаптер IronSource Android версии 7.2.3.1.0 .
- Поддерживает адаптер IronSource iOS версии 7.2.4.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 7.2.0.
Версия 2.2.3
- Поддерживает адаптер IronSource Android версии 7.2.3.1.0 .
- Поддерживает адаптер IronSource iOS версии 7.2.3.1.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 7.1.0.
Версия 2.2.2
- Поддерживает адаптер IronSource Android версии 7.2.2.1.0 .
- Поддерживает адаптер IronSource iOS версии 7.2.2.1.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 7.0.2.
Версия 2.2.1
- Поддерживает адаптер IronSource Android версии 7.2.1.1.0 .
- Поддерживает адаптер IronSource iOS версии 7.2.1.2.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 7.0.0.
Версия 2.2.0
- Поддерживает адаптер IronSource Android версии 7.2.1.0 .
- Поддерживает адаптер IronSource iOS версии 7.2.1.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 7.0.0.
Версия 2.1.5
- Поддерживает адаптер IronSource Android версии 7.1.14.0 .
- Поддерживает адаптер IronSource iOS версии 7.1.14.0 .
Версия 2.1.4
- Поддерживает адаптер IronSource Android версии 7.1.13.0 .
- Поддерживает адаптер IronSource iOS версии 7.1.13.0 .
Версия 2.1.3
- Поддерживает адаптер IronSource Android версии 7.1.12.0 .
- Поддерживает адаптер IronSource iOS версии 7.1.12.0 .
Версия 2.1.2
- Поддерживает адаптер IronSource Android версии 7.1.11.1.0 .
- Поддерживает адаптер IronSource iOS версии 7.1.11.1.0 .
Версия 2.1.1
- Поддерживает адаптер IronSource Android версии 7.1.8.0 .
- Поддерживает адаптер IronSource iOS версии 7.1.8.0 .
Версия 2.1.0
- Поддерживает адаптер IronSource Android версии 7.1.6.0 .
- Поддерживает адаптер IronSource iOS версии 7.1.6.1.0 .
Версия 2.0.3
- Поддерживает адаптер IronSource Android версии 7.0.3.1.0 .
- Поддерживает адаптер IronSource iOS версии 7.0.3.0 .
Версия 2.0.2
- Поддерживает адаптер IronSource Android версии 7.0.2.0 .
- Поддерживает адаптер IronSource iOS версии 7.0.2.0 .
Версия 2.0.1
- Поддерживает адаптер IronSource Android версии 7.0.1.1.0 .
- Поддерживает адаптер IronSource iOS версии 7.0.1.0 .
Версия 2.0.0
- Поддерживает адаптер IronSource Android версии 7.0.0.0 .
- Поддерживает адаптер IronSource iOS версии 7.0.0.0 .
Версия 1.10.0
- Поддерживает адаптер IronSource Android версии 6.18.0.0 .
- Поддерживает адаптер IronSource iOS версии 6.18.0.0 .
Версия 1.9.1
- Поддерживает адаптер IronSource Android версии 6.17.0.1 .
- Поддерживает адаптер IronSource iOS версии 6.17.0.1.0 .
Версия 1.9.0
- Поддерживает адаптер IronSource Android версии 6.17.0.0 .
- Поддерживает адаптер IronSource iOS версии 6.16.3.0 .
Версия 1.8.2
- Поддерживает адаптер IronSource Android версии 6.16.2.0 .
- Поддерживает адаптер IronSource iOS версии 6.16.2.0 .
Версия 1.8.1
- Поддерживает адаптер IronSource Android версии 6.16.1.0 .
- Поддерживает адаптер IronSource iOS версии 6.16.1.0 .
Версия 1.8.0
- Поддерживает адаптер IronSource Android версии 6.16.0.0 .
- Поддерживает адаптер IronSource iOS версии 6.16.0.0 .
Версия 1.7.0
- Поддерживает адаптер IronSource Android версии 6.15.0.1.0 .
- Поддерживает адаптер IronSource iOS версии 6.15.0.1.0 .
Версия 1.6.0
- Поддерживает адаптер IronSource Android версии 6.14.0.1.0 .
- Поддерживает адаптер IronSource iOS версии 6.14.0.0 .
Версия 1.5.0
- Поддерживает адаптер IronSource Android версии 6.13.0.1.0 .
- Поддерживает адаптер IronSource iOS версии 6.13.1.0.0 .
Версия 1.4.0
- Поддерживает адаптер IronSource Android версии 6.12.0.0 .
- Поддерживает адаптер IronSource iOS версии 6.12.0.0 .
Версия 1.3.2
- Поддерживает адаптер IronSource Android версии 6.10.0.0 .
- Поддерживает адаптер IronSource iOS версии 6.8.7.0 .
Версия 1.3.1
- Поддерживает адаптер IronSource Android версии 6.10.0.0.
- Поддерживает адаптер IronSource iOS версии 6.8.6.0.
Версия 1.3.0
- Поддерживает адаптер IronSource Android версии 6.10.0.0.
- Поддерживает адаптер IronSource iOS версии 6.8.4.1.0.
Версия 1.2.0
- Поддерживает адаптер IronSource Android версии 6.9.0.1.
- Поддерживает адаптер IronSource iOS версии 6.8.4.1.0.
Версия 1.1.2
- Поддерживает адаптер IronSource Android версии 6.8.4.1.
- Поддерживает адаптер IronSource iOS версии 6.8.4.1.
Версия 1.1.1
- Поддерживает адаптер IronSource Android версии 6.8.4.1.
- Поддерживает адаптер IronSource iOS версии 6.8.3.0.
Версия 1.1.0
- Обновлен плагин для поддержки новой открытой бета-версии Rewarded API.
- Поддерживает адаптер IronSource Android версии 6.8.1.2.
- Поддерживает адаптер IronSource iOS версии 6.8.0.1.
Версия 1.0.4
- Поддерживает адаптер IronSource Android версии 6.7.11.0.
- Поддерживает адаптер IronSource iOS версии 6.7.11.0.
Версия 1.0.3
- Поддерживает адаптер IronSource Android версии 6.7.10.0.
- Поддерживает адаптер IronSource iOS версии 6.7.10.0.
Версия 1.0.2
- Поддерживает адаптер IronSource Android версии 6.7.9.1.1.
- Поддерживает адаптер IronSource iOS версии 6.7.10.0.
- Исправлен конфликт с плагином-посредником Chartboost Unity.
Версия 1.0.1
- Поддерживает адаптер IronSource Android версии 6.7.9.0.
- Поддерживает адаптер IronSource iOS версии 6.7.9.2.0.
Версия 1.0.0
- Первый выпуск!
- Поддерживает адаптер IronSource Android версии 6.7.9.0.
- Поддерживает адаптер IronSource iOS версии 6.7.9.1.0.