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

Интеграция ironSource с посредником

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

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

Адаптер-посредник Ad Manager для IronSource имеет следующие возможности:

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

Требования

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

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

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

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

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

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

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

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

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

Обратите внимание на ваш новый КЛЮЧ ПРИЛОЖЕНИЯ , который отображается после добавления приложения. Это значение понадобится вам для настройки идентификатора рекламного блокаAd Manager . Выберите форматы рекламы, которые поддерживает ваше приложение. Затем нажмите Продолжить .

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

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

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

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

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

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

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

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

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

Шаг 2. Настройте запрос IronSource в пользовательском интерфейсе Ad Manager .

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

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

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

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

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

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

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

Включите Автоматический сбор данных и введитеSecret Key and Refresh Tokenполученный в предыдущем разделе.

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

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

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

Выполните действия, описанные вНастройки GDPRиНастройки правил штата США, чтобы добавить ironSource Mobile в список рекламных партнеров GDPR и правил штата США. в пользовательском интерфейсе Ad Manager .

Шаг 3. Импортируйте IronSource SDK и адаптер.

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

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

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

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

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

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

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

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

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

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

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

Джава

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

IronSource.setConsent(true);

Котлин

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

IronSource.setConsent(true)

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

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

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

В SDK версии 6.14.0 компания IronSource добавила API для поддержки правил CCPA. В следующем примере кода показано, как передать эту информацию о согласии в IronSource SDK. Эти параметры необходимо установить до инициализации Google Mobile Ads SDK, чтобы обеспечить их правильную пересылку в IronSource 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 следующим образом:

Джава

@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 потребует для вашего проекта дополнительных правил ProGuard. Для получения дополнительной информации обратитесь к руководству по интеграции Android SDK от IronSource .

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

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

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

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

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

Коды ошибок

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

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

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

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