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

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

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

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

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

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

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

Требования

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

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

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

Чтобы добавить свое приложение на панель управления IronSource Ads, нажмите кнопку « Новое приложение» .

Введите данные приложения

Выберите Live App , введите название своего приложения и нажмите «Импортировать информацию о приложении» .

Если ваше приложение недоступно, выберите «Приложение не доступно» в магазине приложений и укажите временное имя для вашего приложения. Выберите свою платформу .

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

Запишите свой новый ключ приложения , который отображается после добавления приложения. Это значение понадобится вам для настройки идентификатора рекламного блока AdMob. Выберите форматы рекламы, которые поддерживает ваше приложение. Затем нажмите Продолжить .

Андроид

iOS

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

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

Торги

Перейдите в LevelPlay > Настройка > Сети SDK , затем выберите свое приложение. В разделе «Ставки » нажмите значок редактирования, чтобы просмотреть идентификатор экземпляра назначения ставок.

Андроид

iOS

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

Андроид

iOS

Водопад

Перейдите в «Объявления» > «Настройка» > «Экземпляры» . Выберите приложение и нажмите «Создать экземпляр» .

Введите необходимые данные и нажмите «Сохранить и закрыть» .

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

Ключевой момент: если вы хотите поддерживать межстраничные объявления с вознаграждением, выберите формат видео с вознаграждением и используйте этот идентификатор экземпляра для добавления объявлений IronSource в качестве источника рекламы на шаге 2 . Кроме того, вам нужно будет связаться со службой поддержки IronSource Ads по адресу [e-mail] , чтобы настроить идентификатор экземпляра для вознагражденной межстраничной поддержки.

После создания экземпляра идентификатор экземпляра отображается в поле «Идентификатор экземпляра» .

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

Торги

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

Водопад

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

Перейдите в раздел «Моя учетная запись» на панели издателя IronSource Ads, затем перейдите на вкладку API . Запишите свой секретный ключ и токен обновления .

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

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

Шаг 2. Настройте спрос на рекламу IronSource в AdMob пользовательский интерфейс

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

Андроид

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

iOS

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

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

Важно! Убедитесь, что у вас есть разрешение на управление учетной записью для завершения настройки согласия ЕС, GDPR, CPRA и платформы обмена сообщениями пользователей. Подробности см. в разделе Управление доступом пользователей к вашей учетной записи .

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

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

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

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

(Только для Android) Добавьте следующие репозитории в файл build.gradle внутри каталога android вашего проекта:

  repositories {
      google()
      mavenCentral()
      maven {
          url = uri("https://android-sdk.is.com/")
      }
  }

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

dependencies:
  gma_mediation_ironsource: ^1.0.0

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

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

dependencies:
  gma_mediation_ironsource:
    path: path/to/local/package

,

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

(Только для Android) Добавьте следующие репозитории в файл build.gradle внутри каталога android вашего проекта:

  repositories {
      google()
      mavenCentral()
      maven {
          url = uri("https://android-sdk.is.com/")
      }
  }

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

dependencies:
  gma_mediation_ironsource: ^1.0.0

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

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

dependencies:
  gma_mediation_ironsource:
    path: path/to/local/package

Шаг 4. Внедрите настройки конфиденциальности в IronSource Ads SDK.

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

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

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

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

GmaMediationIronsource().setConsent(true);

Дополнительную информацию см. в документации IronSource Ads по расширенным настройкам регулирования .

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

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

Плагин посредничества Google Mobile Ads для IronSource Adsвключает в себяGmaMediationIronsource().setDoNotSellметод. В следующем примере кода показано, как передать информацию о согласии в IronSource Ads SDK. Эти параметры необходимо установить до инициализации Google Mobile Ads SDK , чтобы обеспечить их правильную пересылку в IronSource Ads SDK.

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

GmaMediationIronsource().setDoNotSell(true);

Дополнительную информацию и значения, которые можно указать в методе, см. в документации IronSource Ads по расширенным настройкам регулирования для Android и iOS .

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

Андроид

Правила Прогарда

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

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

Жизненный цикл приложения

Переопределите методы onPause() и onResume() в каждом из ваших действий, чтобы вызывать соответствующие методы IronSource Ads следующим образом:

Ява

@Override
public void onResume() {
    super.onResume();
    IronSource.onResume(this);
}

@Override
public void onPause() {
    super.onPause();
    IronSource.onPause(this);
}

Котлин

public override fun onResume() {
    super.onResume()
    IronSource.onResume(this)
}

public override fun onPause() {
    super.onPause()
    IronSource.onPause(this)
}

iOS

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

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

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

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

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

Важно: отключите тестовый режим для 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 Flutter

Следующая версия

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

1.1.0

• Проверенная совместимость с адаптером IronSource Android версии 8.2.1.0.
• Проверенная совместимость с адаптером IronSource iOS версии 8.2.0.0.0.
• Создано и протестировано с помощью плагина Google Mobile Ads Flutter версии 5.1.0.

1.0.0

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