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

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

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

Выберите платформу: Android (бета-версия)

Android iOS Unity Flutter

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

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

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

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

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

Требования

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

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

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

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

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

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

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

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

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

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

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

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

Торги

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

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

Водопад

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

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

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

Торги

Этот шаг не требуется для интеграции с системами торгов.

Водопад

На странице «Мой аккаунт» перейдите на вкладку «API» и запишите свой секретный ключ и токен обновления .

Обновите файл app-ads.txt.

Файл app-ads.txt, созданный в рамках инициативы IAB Tech Lab для авторизованных продавцов приложений , помогает гарантировать, что рекламный инвентарь вашего приложения продается только через авторизованные вами каналы. Чтобы предотвратить значительные потери дохода от рекламы, вам потребуется внедрить файл app-ads.txt . Если вы еще этого не сделали, создайте файл app-ads.txt для Ad Manager .

Для внедрения файла app-ads.txt для ironSource обратитесь к авторизованным реселлерам ironSource .

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

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

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

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

Войдите в свой аккаунт в Ad Manager .

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

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

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

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

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

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

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

После завершения нажмите кнопку «Сохранить» внизу страницы.

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

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

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

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

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

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

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

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

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

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

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

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

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

Начиная с версии 7.7.0 SDK ironSource, ironSource автоматически считывает согласия GDPR, установленные платформами управления согласием, поддерживающими спецификацию Google Additional Consent , включая UMP SDK . Для получения дополнительной информации см. раздел «Поддержка Google UMP и CMP, поддерживающих Google Additional Consent» .

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

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

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

Java

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

Котлин

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

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

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

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

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

Правила Proguard

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

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

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

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