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

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

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

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

Интеграция
Торги 1
Водопад
Форматы
Баннер
Интерстициальный
Награжден
Вознагражденный интерстициальный 2
1 Интеграция торгов находится в стадии открытого бета-тестирования.

2 Этот формат поддерживается только при каскадной интеграции.

Требования

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

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

Зарегистрируйтесь и войдите в свою учетную запись ironSource Ads.

Добавить новое приложение

Чтобы добавить новое приложение, перейдите в раздел «Объявления» > «Приложения» и нажмите «Добавить приложение» .

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

Запишите ключ приложения , затем выберите форматы рекламы, которые поддерживает ваше приложение, и нажмите «Продолжить» .

андроид

iOS

Создать экземпляр

Далее настройте экземпляр для добавленного вами приложения.

Перейдите в Ads > Setup > Instances . Выберите приложение и нажмите Create instance .

Торги

Заполните форму и выберите Торги для ценообразования . Нажмите Сохранить и закрыть .

андроид

iOS

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

андроид

iOS

Водопад

Заполните форму и нажмите «Сохранить и закрыть» .

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

Найдите свой ключ API для отчетов

Торги

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

Водопад

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

Обновите свой app-ads.txt

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

Чтобы реализовать app-ads.txt для ironSource, обратитесь к авторизованным реселлерам ironSource .

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

Следуйте инструкциям в руководстве по тестированию интеграции ironSource Ads, чтобы узнать, как включить тестовые объявления ironSource Ads.

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

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

андроид

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

iOS

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

Добавьте ironSource Mobile в список рекламных партнеров GDPR и государственных нормативных актов США

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

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

OpenUPM-CLI

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

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

OpenUPM

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

На вкладке «Реестры с ограниченной областью действия» добавьте OpenUPM как реестр с ограниченной областью действия со следующими данными:

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

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

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

Реестры единства

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

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

Пакет «Единство»

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

В редакторе проекта Unity выберите Assets > Import Package > Custom Package и найдите загруженный вами файл GoogleMobileAdsIronSourceMediation.unitypackage . Убедитесь, что выбраны все файлы, и нажмите Import .

Импорт из Unity

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

Сила Решения

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

В соответствии с Политикой согласия пользователей ЕС 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: Добавьте требуемый код

андроид

Правила Proguard

Если вы сжимаете, запутываете и оптимизируете свое приложение , IronSource Ads потребуются дополнительные правила ProGuard для вашего проекта.

При создании проекта выберите Android в качестве платформы . Затем откройте настройки проигрывателя и проверьте файл User Proguard на вкладке Publishing Settings . Unity должен показать, где был создан пользовательский файл proguard-user.txt который вы можете изменить.

Файл Proguard пользователя Unity

Дополнительную информацию о том, какие правила ProGuard требуются для вашего проекта, можно найти в руководстве по интеграции Android SDK от IronSource Ads , а затем добавить эти правила в файл proguard-user.txt .

iOS

Интеграция SKAdNetwork

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

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

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

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

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

Чтобы убедиться, что вы получаете тестовые объявления от ironSource Ads, включите тестирование одного источника объявлений в инспекторе объявлений, используя источники объявлений ironSource Ads (Bidding) и 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 Для инициализации SDK ironSource Ads требуется контекст Activity.
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 не поддерживает запрошенный формат рекламы.
103 Для этой конфигурации сети уже загружено объявление ironSource.
104 Запрошенный размер баннерной рекламы не поддерживается ironSource Ads.
508-1037 Ошибки ironSource Ads SDK. Подробности смотрите в документации .

Журнал изменений плагина IronSource Unity Mediation

Версия 3.9.0

Версия 3.8.1

Версия 3.8.0

Версия 3.7.0

Версия 3.6.1

Версия 3.6.0

Версия 3.5.2

Версия 3.5.1

Версия 3.5.0

Версия 3.4.0

Версия 3.3.1

Версия 3.3.0

Версия 3.2.1

Версия 3.2.0

Версия 3.1.1

Версия 3.1.0

Версия 3.0.1

Версия 3.0.0

Версия 2.6.1

Версия 2.6.0

Версия 2.5.0

Версия 2.4.0

Версия 2.3.1

Версия 2.3.0

Версия 2.2.7

Версия 2.2.6

Версия 2.2.5

Версия 2.2.4

Версия 2.2.3

Версия 2.2.2

Версия 2.2.1

Версия 2.2.0

Версия 2.1.5

Версия 2.1.4

Версия 2.1.3

Версия 2.1.2

Версия 2.1.1

Версия 2.1.0

Версия 2.0.3

Версия 2.0.2

Версия 2.0.1

Версия 2.0.0

Версия 1.10.0

Версия 1.9.1

Версия 1.9.0

Версия 1.8.2

Версия 1.8.1

Версия 1.8.0

Версия 1.7.0

Версия 1.6.0

Версия 1.5.0

Версия 1.4.0

Версия 1.3.2

Версия 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

  • Обновлен плагин для поддержки нового открытого бета-тестирования API Rewarded.
  • Поддерживает адаптер 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.