Чтобы обсудить наши продукты и оставить отзыв, присоединяйтесь к официальному каналу AdMob Discord на сервере Google Advertising and Measurement Community .

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

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

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

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

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

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

¹ Интеграция торгов находится в стадии открытого бета-тестирования.

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

Требования

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

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

Последняя версия Google Mobile Ads SDK
Завершить посредничество . Руководство по началу работы.

Шаг 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 в конфигурацию медиации для вашего рекламного блока.

Сначала войдите в свой аккаунт AdMob . Затем перейдите на вкладку «Медиация» . Если у вас есть группа медиации, которую вы хотите изменить, нажмите на её название, чтобы отредактировать её, и перейдите к разделу «Добавить ironSource Ads в качестве источника рекламы» .

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

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

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

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

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

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

Торги

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

Нажмите «Как подписать соглашение о партнерстве» и настроить партнерство по торгам с ironSource Ads.

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

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

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

Водопад

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

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

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

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

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

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

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

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

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

Затем в файл build.gradle.kts уровня приложения добавьте следующие зависимости и конфигурации реализации. Используйте последние версии ironSource Ads SDK и адаптера:

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

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

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

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

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

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

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

Ява

import com.ironsource.mediationsdk.IronSource;
// ...

IronSource.setConsent(true);

Котлин

import com.ironsource.mediationsdk.IronSource
// ...

IronSource.setConsent(true)

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

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

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

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

Ява

import com.ironsource.mediationsdk.IronSource;
// ...

IronSource.setMetaData("do_not_sell", "true");

Котлин

import com.ironsource.mediationsdk.IronSource
// ...

IronSource.setMetaData("do_not_sell", "true")

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

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

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

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

Переопределите методы 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)
}

Правила Proguard

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

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