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

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

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

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

Интеграция
Торги
Водопад
Форматы
Баннер 1
Интерстициальный
Награжден
Вознагражденный интерстициальный 1

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

Требования

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

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

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

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

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

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

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

Андроид

iOS

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

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

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

Торги

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

Андроид

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 в пользовательском интерфейсе Менеджера рекламы

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

Андроид

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

iOS

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

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

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

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

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

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

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

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

dependencies:
  gma_mediation_ironsource: ^2.0.1

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

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

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

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

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

Начиная с версии 2.6.0 плагина Unity для адаптера ironSource, ironSource автоматически считывает согласие GDPR, установленное платформами управления согласием, поддерживающими спецификацию дополнительного согласия Google , включая UMP SDK . Подробнее см. в разделе «Поддержка Google UMP и CMP, поддерживающих дополнительное согласие Google» .

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

Законы США о конфиденциальности требуют предоставления пользователям права отказаться от «продажи» их «личной информации» (как этот термин определен в законе). Отказ осуществляется через заметную ссылку «Не продавайте мою личную информацию» на главной странице «продающей» стороны. Руководство по соблюдению законов США о конфиденциальности предлагает возможность включить ограниченную обработку данных для показа рекламы 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: Добавьте необходимый код

Андроид

Правила Proguard

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

Дополнительную информацию о том, какие правила ProGuard требуются для вашего проекта, см. в руководстве по интеграции Android SDK от IronSource Ads , а затем добавьте эти правила в файл 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: Проверьте свою реализацию

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

Обязательно зарегистрируйте свое тестовое устройство в Ad Manager и включите тестовый режим в пользовательском интерфейсе 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, настроенные в пользовательском интерфейсе менеджера объявлений, отсутствуют или недействительны.
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, настроенные в пользовательском интерфейсе Менеджера объявлений, отсутствуют/недействительны.
102 ironSource Ads Adapter не поддерживает запрошенный формат рекламы.
103 Реклама ironSource уже загружена для этой конфигурации сети.
104 Запрошенный размер баннерной рекламы не поддерживается ironSource Ads.
508-1037 Ошибки ironSource Ads SDK. Подробнее см. в документации .

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

Версия 2.0.0

Версия 1.5.0

Версия 1.4.1

Версия 1.4.0

Версия 1.3.1

Версия 1.3.0

Версия 1.2.0

Версия 1.1.0

Версия 1.0.0