Эта страница переведена с помощью 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.

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

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

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

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

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

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

Перейдите в Ads > Setup > Instances . Выберите приложение и нажмите Create instance .

Торги

Заполните форму и выберите Торги для ценообразования . Нажмите Сохранить и закрыть .

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

Водопад

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

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

Найдите свой ключ 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» .

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

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

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

Далее введите App Key и Instance ID, полученные в предыдущем разделе. Затем нажмите Done .

Водопад

Под карточкой Waterfall в разделе Ad Sources выберите Add Ad Source . Затем выберите ironSource Ads .

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

Далее введите App Key и Instance ID, полученные в предыдущем разделе. Затем нажмите Done .

Примечание : Оптимизации источника рекламы требуется несколько дней, чтобы собрать достаточно данных для точного расчета 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.9.1.0")
}

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

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

Шаг 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. Подробности смотрите в документации .