Чтобы переводить контент на ваш предпочитаемый язык, Google использует технологии на основе искусственного интеллекта. Переводы от ИИ могут содержать ошибки.

Как интегрировать ironSource с медиацией

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

В этом руководстве рассказывается, как использовать GMA Next-Gen SDK для загрузки и показа объявлений из ironSource Ads с помощью медиации, в том числе каскадной интеграции. В нем рассказывается, как добавить ironSource Ads в конфигурацию медиации рекламного блока, настроить оптимизацию источника объявлений и интегрировать ironSource Ads SDK и адаптер в приложение для Android.

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

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

Интеграция
Ставки
Водопад
Форматы
Баннер
Межстраничное объявление
Бонус предоставлен
Межстраничное объявление с вознаграждением	¹
Стандартное

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

Требования

Прежде чем продолжить, убедитесь, что:

Android API уровня 24 или более поздней версии.

[Для назначения ставок] Чтобы интегрировать все поддерживаемые форматы объявлений в назначение ставок, используйте адаптер IronSource версии 8.5.0.1 или более поздней (рекомендуется последняя версия).

Последняя версия GMA Next-Gen SDK.
Настройте медиацию.

Шаг 1. Настройте конфигурации в интерфейсе ironSource Ads

Зарегистрируйтесь и войдите в аккаунт Рекламы в ironSource.

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

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

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

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

Создание экземпляра

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

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

Ставки

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

Запишите идентификатор экземпляра.

Водопад

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

Запишите идентификатор экземпляра.

Как найти ключ Reporting API

Ставки

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

Водопад

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

Как обновить файл app-ads.txt

Authorized Sellers for Apps (Авторизованные продавцы приложений), или app-ads.txt, – это инициатива IAB Tech Lab, которая позволяет издателям указывать авторизованных продавцов своего рекламного инвентаря. Чтобы избежать значительного снижения дохода от рекламы, используйте файл app-ads.txt. Если вы ещё этого не сделали, создайте файл app-ads.txt для Менеджера рекламы.

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

Как включить режим тестирования

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

Шаг 2. Настройте источник спроса ironSource Ads в интерфейсе Менеджера рекламы

Как настроить медиацию для рекламного блока

Войдите в аккаунт Менеджера рекламы.

Откройте раздел Выполнение > Группы доходности и нажмите кнопку Новая группа доходности.

Укажите уникальное название группы доходности, задайте Статус Активный, выберите Формат объявлений и задайте Тип инвентаря Мобильное приложение. В разделе Таргетинг > Инвентарь выберите рекламный блок в разделе Инвентарь и Мобильное приложение, в который вы хотите добавить медиацию.

Затем нажмите кнопку Добавить партнера по группе доходности.

Если у вас уже есть партнер по группе доходности для ironSource Ads, выберите его. В противном случае выберите Создать нового партнера по группе доходности.

Выберите ironSource Ads в качестве рекламной сети, введите уникальное название и включите медиацию.

Включите Автоматический сбор данных и введите Секретный ключ и Токен обновления, полученные в предыдущем разделе.

После того как вы выберете партнера по доходности, укажите Медиация с использованием Mobile SDK в качестве типа интеграции, Android в качестве платформы и Активно в качестве статуса. Введите ключ приложения и идентификатор экземпляра, полученные в предыдущем разделе. Затем введите стандартную цену за тысячу показов.

Нажмите Сохранить внизу страницы.

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

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

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

Интеграция с Android Studio (рекомендуется)

В файле settings.gradle.kts на уровне проекта добавьте следующие репозитории:

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

В файл gradle на уровне приложения добавьте следующие зависимости и конфигурации:

Kotlin

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.5.0")
    implementation("com.google.ads.mediation:ironsource:9.6.0.1")
}

configurations.configureEach {
    exclude(group = "com.google.android.gms", module = "play-services-ads")
    exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}

Groovy

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.5.0'
    implementation 'com.google.ads.mediation:ironsource:9.6.0.1'
}

configurations.configureEach {
    exclude group: 'com.google.android.gms', module: 'play-services-ads'
    exclude group: 'com.google.android.gms', module: 'play-services-ads-lite'
}

Интеграция с настройкой вручную

Скачайте последнюю версию ironSource Ads Android SDK и добавьте ее в свой проект.
Перейдите к артефактам адаптера ironSource Ads в хранилище Google Maven. Выберите последнюю версию, скачайте файл адаптера IronSource .aar и добавьте его в проект.

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

Согласие пользователей из ЕС и GDPR

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

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

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

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

В версии 6.14.0 SDK ironSource Ads добавлен API, поддерживающий требования CCPA. В приведенном ниже образце кода показано, как передать информацию о согласии в ironSource Ads SDK. Эти параметры необходимо задать до инициализации GMA Next-Gen SDK, чтобы они были правильно переданы в SDK ironSource Ads.

Java

LevelPlay.setMetaData("do_not_sell", "true");IronSourceMediationSnippets.java

Kotlin

LevelPlay.setMetaData("do_not_sell", "true")IronSourceMediationSnippets.kt

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

Шаг 5. Добавьте обязательный код

Загрузка объявления с контекстом активности

Передавайте контекст Activity при загрузке баннеров, межстраничных объявлений и объявлений с вознаграждением. Без контекста действия загрузка объявления невозможна.

Правила ProGuard

Если вы сжимаете, обфусцируете и оптимизируете приложение, для работы ironSource Ads в проект необходимо добавить дополнительные правила ProGuard. Подробную информацию можно найти в руководстве по интеграции Android SDK для ironSource Ads.

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

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

Зарегистрируйте тестовое устройство в Менеджере рекламы и включите тестовый режим в интерфейсе ironSource Ads.

Как проверить тестовые объявления

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

Коды ошибок

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

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

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

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