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

Выберите платформу: Android (бета-версия)Новый Android iOS Unity Flutter

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

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

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

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

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

Требования

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

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

Зарегистрируйтесь и войдите в свой аккаунт ironSource Ads.

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

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

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

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

Android

iOS

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

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

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

Торги

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

Android

iOS

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

Android

iOS

Водопад

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

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

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

Торги

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

Водопад

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

Обновите файл app-ads.txt.

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

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

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

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

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

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

Android

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

iOS

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

Добавьте ironSource Mobile в список рекламных партнеров, соответствующих требованиям GDPR и законодательству штатов США.

Чтобы добавить ironSource Mobile в список рекламных партнеров, соответствующих европейским и американским государственным нормативным требованиям, в пользовательском интерфейсе Ad Manager, выполните действия, описанные в настройках европейских и американских нормативных требований.

Шаг 3: Импортируйте SDK и адаптер для рекламы ironSource.

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

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

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

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

dependencies:
  gma_mediation_ironsource: ^2.1.0

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

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

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

Шаг 4: Внедрите настройки конфиденциальности в SDK рекламы ironSource.

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

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

Законы штатов США о защите частной жизни

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

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

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

GmaMediationIronsource().setDoNotSell(true);

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

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

Android

Правила Proguard

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

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

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

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

Java 

@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

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

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

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

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

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

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

коды ошибок

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

Android 

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

iOS 

GADMAdapterIronSource
GADMAdapterIronSourceRewarded

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

Android

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

iOS

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

Список изменений адаптера Flutter Mediation от 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