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

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

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

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

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

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

Требования

• Последняя версия 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. Выберите форматы рекламы, которые поддерживает ваше приложение. Затем нажмите Продолжить .

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

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

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

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

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

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

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

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

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

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

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

Шаг 3. Импортируйте IronSource 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

Шаг 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. Добавьте необходимый код.

@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)
}

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

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

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

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

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

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

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

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

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

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

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

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

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

Коды ошибок

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

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

GADMAdapterIronSource
GADMAdapterIronSourceRewarded

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

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

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.
• Проверенная совместимость с адаптером IronSource iOS версии 8.0.0.0.0.
• Создано и протестировано с помощью плагина Google Mobile Ads Flutter версии 5.1.0.