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

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

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

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

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

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

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

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

Требования

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

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

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

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

Шаг 1. Задайте настройки в интерфейсе ironSource Ads

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

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

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

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

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

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

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

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

Ставки

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

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

Водопад

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

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

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

Ставки

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

Водопад

Нажмите на вкладку API на странице My Account (Мой аккаунт) и запишите секретный ключ и токен обновления.

Обновите файл 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 в интерфейсе AdMob

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

Вам нужно добавить Рекламу в ironSource в конфигурацию медиации для рекламного блока.

Войдите в аккаунт AdMob. Перейдите на вкладку Медиация. Если вы хотите изменить существующую группу медиации, нажмите на ее название и перейдите к разделу Добавьте ironSource Ads в качестве источника объявлений.

Чтобы создать новую группу медиации, нажмите Создать группу медиации.

Укажите формат объявления и платформу, а затем нажмите Продолжить.

Укажите название группы медиации и выберите местоположения для таргетинга. Затем установите для группы медиации статус Включено и нажмите Добавить рекламные блоки.

Свяжите эту группу медиации с одним или несколькими рекламными блоками AdMob. Затем нажмите Готово.

Выбранные рекламные блоки появятся на карточке:

Как добавить ironSource Ads в качестве источника объявлений

Ставки

В разделе Источники объявлений найдите карточку Назначение ставок и выберите Добавить источник объявлений. Затем выберите Реклама в ironSource.

Нажмите Как подписать партнерское соглашение и установите партнерскую связь с назначением ставок с ironSource Ads.

Нажмите Подтвердить и согласиться, а затем – Продолжить.

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

Затем введите ключ приложения и идентификатор экземпляра, полученные в предыдущем разделе. Затем нажмите Готово.

Водопад

На карточке Каскад в разделе Источники объявлений выберите Добавить источник объявлений.

Выберите ironSource Ads и сдвиньте переключатель Оптимизировать вправо. Чтобы настроить оптимизацию источника объявлений для ironSource Ads, введите секретный ключ и токен обновления, полученные в предыдущем разделе. Затем укажите эффективную цену за тысячу показов для ironSource Ads и нажмите Продолжить.

Примечание. Чтобы собрать достаточно данных для точного расчета эффективной цены за тысячу показов в сети медиации, требуется несколько дней. Пока статус оптимизации источника объявлений – PENDING, вам нужно вручную задать значение эффективной цены за тысячу показов для сети. После этого источник объявлений начнет автоматически обновлять эффективную цену за тысячу показов от вашего имени.

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

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

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

Интеграция с 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.1.0")
}

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.1.0'
}

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 в репозитории Maven от Google. Выберите последнюю версию, скачайте файл .aar адаптера IronSource и добавьте его в проект.

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

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

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

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

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

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

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

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. Проверьте реализацию

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

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