Интегрируйте IronSource с посредничеством

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

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

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

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

Требования

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

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

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

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

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

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

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

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

Обратите внимание на ваш новый КЛЮЧ ПРИЛОЖЕНИЯ , который отображается после добавления приложения. Это значение понадобится вам для настройки идентификатора рекламного блокаAdMob . Выберите форматы рекламы, которые поддерживает ваше приложение. Затем нажмите Продолжить .

Андроид

iOS

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

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

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

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

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

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

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

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

Примечание. Только пользователи с правами участника или администратора могут использовать эти API.

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

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

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

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

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

Андроид

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

iOS

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

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

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

Выполните действия, описанные вНастройки GDPRиНастройки правил штата США, чтобы добавить ironSource Mobile в список рекламных партнеров GDPR и правил штата США. в пользовательском интерфейсе AdMob .

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

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

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

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

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

Добавьте следующую зависимость с последними версиями SDKironSource и адаптера в файл 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 SDK.

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

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

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

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

GmaMediationIronsource().setConsent(true);

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

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

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

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

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

GmaMediationIronsource().setDoNotSell(true);

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

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

Андроид

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

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

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

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

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

Джава

@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 , чтобы добавить идентификаторы SKAdNetwork в файл Info.plist вашего проекта.

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

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

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

Важно: отключите тестовый режим для AdMob иironSource перед выпуском приложения.

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

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

Коды ошибок

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

Андроид

com.google.ads.mediation.ironsource.IronSourceAdapter
com.google.ads.mediation.ironsource.IronSourceRewardedAdapter

iOS

GADMAdapterIronSource
GADMAdapterIronSourceRewarded

Вот коды и сопутствующие сообщения, выдаваемые адаптером IronSource, когда объявление не загружается:

Андроид

Код ошибки	Причина
101	Параметры сервера IronSource, настроенные в пользовательском интерфейсе AdMob отсутствуют/недействительны.
102	IronSource требует контекст активности для инициализации своего SDK.
103	IronSource может загрузить только 1 объявление на каждый идентификатор экземпляра IronSource.
105	Запрошенный размер баннерной рекламы не поддерживается IronSource.
106	IronSource SDK не инициализирован.
501-1056	Ошибки IronSource SDK. Более подробную информацию смотрите в документации .

iOS

Код ошибки	Причина
101	Параметры сервера IronSource, настроенные в пользовательском интерфейсе AdMob отсутствуют/недействительны.
102	Адаптер IronSource не поддерживает запрошенный формат объявления.
103	Для этой конфигурации сети уже загружено объявление IronSource.
104	Запрошенный размер баннерной рекламы не поддерживается IronSource.
508-1037	Ошибки IronSource SDK. Более подробную информацию смотрите в документации .

Журнал изменений адаптера-посредника IronSource Flutter

1.0.0

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