Интегрируйте IronSource с посредничеством

Выберите платформу: Android (бета-версия) Новоизбранный Android iOS Unity Flutter

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

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

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

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

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

Требования

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

Шаг 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, вы можете его выбрать. В противном случае нажмите «Добавить сопоставление» .



Next, enter the App Key and Instance ID obtained in the previous section. Then click Done .



Водопад


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

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



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

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


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

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

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

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

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

В файл gradle на уровне приложения добавьте следующие зависимости реализации и конфигурации:

Котлин 

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta02")
    implementation("com.google.ads.mediation:ironsource:9.3.0.1")
}

configurations.configureEach {
    exclude(group = "com.google.android.gms", module = "play-services-ads")
    exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}

Классный 

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta02'
    implementation 'com.google.ads.mediation:ironsource:9.3.0.1'
}

configurations.configureEach {
    exclude group: 'com.google.android.gms', module: 'play-services-ads'
    exclude group: 'com.google.android.gms', module: 'play-services-ads-lite'
}

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

  1. Загрузите последнюю версию Android SDK для рекламы ironSource и добавьте её в свой проект.

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

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

В соответствии с Политикой 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. Эти параметры необходимо установить до инициализации GMA Next-Gen 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: Протестируйте свою реализацию.

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

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

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

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

коды ошибок

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

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

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

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