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

Интегрируйте IronSource с Mediation

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

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

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

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

¹ Интеграция назначения ставок находится на стадии закрытого бета-тестирования. Чтобы запросить доступ, обратитесь к менеджеру своего аккаунта.

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

Требования

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

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

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

Зарегистрируйтесь и войдите в свою учетную запись IronSource Ads.

Чтобы добавить свое приложение на панель управления IronSource Ads, нажмите кнопку « Новое приложение» .

Введите данные приложения

Выберите Live App , введите URL-адрес вашего приложения в Google Play и нажмите «Импортировать информацию о приложении» .

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

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

Запишите свой новый ключ приложения , который отображается после добавления приложения. Это значение понадобится вам для настройки идентификатора рекламного блока Менеджера рекламы. Выберите форматы рекламы, которые поддерживает ваше приложение. Затем нажмите Продолжить .

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

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

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

Введите необходимые данные и нажмите «Сохранить и закрыть» .

После создания экземпляра идентификатор экземпляра отображается в поле «Идентификатор экземпляра» .

Найдите свой ключ API отчетности

Помимо ключа приложения и идентификатора экземпляра , вам также понадобится секретный ключ IronSource Ads и токен обновления, чтобы настроить идентификатор рекламного блока Менеджера рекламы.

Перейдите в раздел «Моя учетная запись» на панели издателя IronSource Ads, затем перейдите на вкладку API . Запишите свой секретный ключ и токен обновления .

Включите тестовый режим

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

Шаг 2. Настройте спрос на объявления IronSource в интерфейсе Менеджера рекламы.

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

Войдите в свою учетную запись Менеджера рекламы .

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

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

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

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

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

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

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

Когда закончите, нажмите «Сохранить» внизу страницы.

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

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

Шаг 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:23.6.0")
    implementation("com.google.ads.mediation:ironsource:8.5.0.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. Добавьте необходимый код.

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

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

Правила Прогарда

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

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

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

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

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

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

Коды ошибок

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

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

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

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

Журнал изменений адаптера-посредника IronSource для Android