Google Mobile Ads SDK находится в режиме технического обслуживания. Для получения последних обновлений и новых функций выполните миграцию и настройку GMA Next-Gen SDK .

Эта страница переведена с помощью Cloud Translation API.

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

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

This guide shows you how to use Google Mobile Ads SDK (Legacy) to load and display ads from ironSource Ads using AdMob Mediation , covering waterfall integrations. It covers how to add ironSource Ads to an ad unit's mediation configuration, how to set up ad source optimization, and how to integrate the ironSource Ads SDK and adapter into your Android app.

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

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

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

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

Требования

Android API уровня 23 или выше

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

Последняя версия Google Mobile Ads SDK (Legacy) .
Пройдите руководство по началу процесса медиации.

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

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

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

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

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

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

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

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

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

Торги

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

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

Водопад

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

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

Найдите свой ключ 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 в пользовательском интерфейсе AdMob.

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

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

First, sign in to your AdMob account . Next, navigate to the Mediation tab. If you have an existing mediation group you'd like to modify, click the name of that mediation group to edit it, and skip ahead to Add ironSource Ads as an ad source .

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

Укажите формат и платформу вашей рекламы, затем нажмите «Продолжить» .

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

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

Теперь вы должны увидеть карточку рекламных блоков, заполненную выбранными вами рекламными блоками:

Добавьте ironSource Ads в качестве источника рекламы.

Торги

В разделе «Источники рекламы» на вкладке « Торги » выберите «Добавить источник рекламы» . Затем выберите ironSource Ads .

Нажмите «Как заключить партнерское соглашение и настроить партнерство по размещению рекламы в рамках аукциона» на сайте ironSource Ads.

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

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

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

Водопад

В разделе «Источники рекламы » на вкладке « Водопад » выберите «Добавить источник рекламы» .

Select ironSource Ads and enable the Optimize switch. Enter the Secret Key and Refresh Token obtained in the previous section to set up ad source optimization for ironSource Ads. Then enter an eCPM value for ironSource Ads and click Continue .

Примечание : Оптимизация источника рекламы занимает несколько дней, чтобы собрать достаточно данных для точного расчета eCPM для сети медиации. В это время статус оптимизации источника рекламы — PENDING , поэтому вам необходимо вручную установить значение eCPM для сети. Как только eCPM будет рассчитан, источник рекламы автоматически начнет обновлять значение eCPM от вашего имени.

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

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

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

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

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

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

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

Котлин

dependencies {
    implementation("com.google.android.gms:play-services-ads:25.4.0")
    implementation("com.google.ads.mediation:ironsource:9.4.4.0")
}

Классный

dependencies {
    implementation 'com.google.android.gms:play-services-ads:25.4.0'
    implementation 'com.google.ads.mediation:ironsource:9.4.4.0'
}

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

Загрузите последнюю версию Android SDK для рекламы ironSource и добавьте её в свой проект.
Перейдите к артефактам адаптера ironSource Ads в репозитории Maven Google. Выберите последнюю версию, загрузите файл .aar адаптера IronSource и добавьте его в свой проект.

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

Согласие ЕС и GDPR

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

Starting in ironSource SDK version 7.7.0, ironSource automatically reads GDPR consent set by consent management platforms that support Google's Additional Consent specification , including the UMP SDK . For more information, see Support for Google UMP and CMPs that support Google's Additional Consent .

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

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

In SDK version 6.14.0, ironSource Ads added an API to support CCPA regulations. The following sample code shows how to pass this consent information to the ironSource Ads SDK. These options must be set before you initialize Google Mobile Ads SDK (Legacy) to ensure they get forwarded properly to the ironSource Ads SDK.

Java

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

Котлин

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

Дополнительные сведения и значения, которые можно указать в методе, см. в документации ironSource Ads в разделе «Расширенные настройки регулирования» .

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

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

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

Правила Proguard

If you shrink, obfuscate, and optimize your app , ironSource Ads requires additional ProGuard rules to your project. Consult ironSource Ads's Android SDK Integration guide for more information.

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

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

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

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

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

коды ошибок

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

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

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

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