В этом руководстве показано, как использовать Google Mobile Ads SDK для загрузки и отображения рекламы из IronSource Ads с использованием медиации , а также каскадной интеграции. В нем рассказывается, как добавить IronSource Ads в конфигурацию медиации рекламного блока, а также как интегрировать IronSource Ads SDK и адаптер в Flutter приложение.
Поддерживаемые интеграции и форматы объявлений
AdMob Адаптер медиации для IronSource Ads обладает следующими возможностями:
Интеграция | |
---|---|
Торги | 1 |
Водопад | |
Форматы | |
Баннер | 2 |
Межстраничный | |
Награжден | |
Межстраничное объявление с вознаграждением | 2 |
1 Интеграция назначения ставок находится на стадии закрытого бета-тестирования. Чтобы запросить доступ, обратитесь к менеджеру своего аккаунта.
2 Этот формат поддерживается только при каскадной интеграции.
Требования
- Последняя версия Google Mobile Ads SDK
- Флаттер 3.7.0 или выше
- Развертывание на Android
- Android API уровня 21 или выше
- Развертывание на iOS
- Цель развертывания iOS 12.0 или выше
- Рабочий Flutter проект, настроенный с помощью Google Mobile Ads SDK. Подробности см. в разделе «Начало работы» .
- Пройдите руководство по началу работы с медиацией
Шаг 1. Настройте конфигурации в пользовательском интерфейсе IronSource Ads.
Шаг 2. Настройте спрос на рекламу IronSource в AdMob пользовательский интерфейс
Настройте параметры медиации для своего рекламного блока
Андроид
Инструкции см. в шаге 2 руководства дляAndroid .
iOS
Инструкции см. в шаге 2 руководства дляiOS .
Добавлять ironSource Mobile в соответствии с GDPR и списком рекламных партнеров США.
Шаг 3. Импортируйте IronSource Ads SDK и адаптер.
Интеграция через pub.dev
(Только для Android) Добавьте следующие репозитории в файл build.gradle
внутри каталога android
вашего проекта:
repositories {
google()
mavenCentral()
maven {
url = uri("https://android-sdk.is.com/")
}
}
Добавьте следующую зависимость с последними версиями
IronSource
SDK и адаптер в файле pubspec.yaml
вашего пакета:
dependencies:
gma_mediation_ironsource: ^1.0.0
Ручная интеграция
Загрузите последнюю версию плагина медиации Google Mobile Ads для
IronSource
, извлеките загруженный файл и добавьте извлеченную папку плагина (и ее содержимое) в свой проект Flutter. Затем укажите ссылку на плагин в файле pubspec.yaml
, добавив следующую зависимость:
dependencies:
gma_mediation_ironsource:
path: path/to/local/package
Шаг 4. Внедрите настройки конфиденциальности в IronSource Ads SDK.
Согласие ЕС и GDPR
В соответствии с Политикой согласия пользователей Google из ЕС вы должны гарантировать, что пользователям в Европейской экономической зоне (ЕЭЗ) будет предоставлена определенная информация и получено от них согласие на использование идентификаторов устройств и личных данных. Эта политика отражает требования Директивы ЕС об электронной конфиденциальности и Общего регламента защиты данных (GDPR). При запросе согласия вы должны указать каждую рекламную сеть в вашей цепочке посредничества, которая может собирать, получать или использовать персональные данные, а также предоставлять информацию об использовании каждой сети. В настоящее время Google не может автоматически передавать выбор согласия пользователя в такие сети.
Плагин посредничества Google Mobile Ads для IronSource Adsвключает в себяGmaMediationIronsource().SetConsent()
метод. В следующем примере кода показано, как передать информацию о согласии в IronSource Ads SDK. Если вы решите вызвать этот метод, рекомендуется сделать это до запроса рекламы через Google Mobile Ads SDK.
import 'package:gma_mediation_ironsource/gma_mediation_ironsource.dart';
// ...
GmaMediationIronsource().setConsent(true);
Дополнительную информацию см. в документации IronSource Ads по расширенным настройкам регулирования .
Законы штата США о конфиденциальности
Законы о конфиденциальности штатов США требуют предоставления пользователям права отказаться от «продажи» их «личной информации» (согласно определению этих условий в законе), при этом отказ предлагается через заметную ссылку «Не продавать мою личную информацию» на странице «продажа». " Домашняя страница партии. Руководство по соблюдению законов о конфиденциальности штатов США предлагает возможность включить ограниченную обработку данных для показа рекламы Google, но Google не может применить этот параметр к каждой рекламной сети в вашей цепочке медиации. Поэтому вы должны определить каждую рекламную сеть в вашей цепочке посредничества, которая может участвовать в продаже личной информации, и следовать указаниям каждой из этих сетей, чтобы обеспечить соблюдение требований.
Плагин посредничества Google Mobile Ads для IronSource Adsвключает в себяGmaMediationIronsource().setDoNotSell
метод. В следующем примере кода показано, как передать информацию о согласии в IronSource Ads SDK. Эти параметры необходимо установить до инициализации Google Mobile Ads SDK, чтобы обеспечить их правильную пересылку в IronSource Ads SDK.
import 'package:gma_mediation_ironsource/gma_mediation_ironsource.dart';
// ...
GmaMediationIronsource().setDoNotSell(true);
Дополнительную информацию и значения, которые можно указать в методе, см. в документации IronSource Ads по расширенным настройкам регулирования для Android и iOS .
Шаг 5. Добавьте необходимый код
Андроид
Правила Прогарда
Если вы сжимаете, запутываете и оптимизируете свое приложение , IronSource Ads потребует дополнительных правил ProGuard для вашего проекта.
Обратитесь к руководству по интеграции Android SDK компании IronSource Ads для получения дополнительной информации о том, какие правила ProGuard необходимы для вашего проекта, и добавьте эти правила в файл proguard-user.txt
.
Жизненный цикл приложения
Переопределите методы 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)
}
iOS
Интеграция со SKAdNetwork
Следуйте документации IronSource Ads , чтобы добавить идентификаторы SKAdNetwork в файл Info.plist
вашего проекта.
Шаг 6. Проверьте свою реализацию
Включить тестовые объявления
Убедитесь, что вы зарегистрировали свое тестовое устройство дляAdMob и включили тестовый режим в пользовательском интерфейсе IronSource .
Проверьте тестовые объявления
Чтобы убедиться, что вы получаете тестовые объявления от IronSource , включите тестирование одного источника объявлений в инспекторе объявлений, используя источники объявлений ironSource Ads (Waterfall) .
Коды ошибок
Если адаптеру не удается получить объявление от IronSource Ads, издатели могут проверить основную ошибку из ответа на объявление, используя ResponseInfo
в следующих классах:
Андроид
com.google.ads.mediation.ironsource.IronSourceAdapter
com.google.ads.mediation.ironsource.IronSourceRewardedAdapter
iOS
GADMAdapterIronSource
GADMAdapterIronSourceRewarded
Вот коды и сопутствующие сообщения, выдаваемые адаптером IronSource Ads, когда объявление не загружается:
Андроид
Код ошибки | Причина |
---|---|
101 | Параметры сервера IronSource Ads, настроенные в AdMob Пользовательский интерфейс отсутствует/недействителен. |
102 | IronSource Ads требует контекст активности для инициализации своего SDK. |
103 | IronSource Ads может загружать только 1 объявление для каждого идентификатора экземпляра IronSource. |
105 | Запрошенный размер баннерной рекламы не поддерживается IronSource Ads. |
106 | IronSource Ads SDK не инициализирован. |
501-1056 | Ошибки IronSource Ads SDK. Более подробную информацию смотрите в документации . |
iOS
Код ошибки | Причина |
---|---|
101 | Параметры сервера IronSource Ads, настроенные в AdMob Пользовательский интерфейс отсутствует/недействителен. |
102 | IronSource Ads Adaptor не поддерживает запрошенный формат объявления. |
103 | Для этой конфигурации сети уже загружено объявление IronSource. |
104 | Запрошенный размер баннерной рекламы не поддерживается IronSource Ads. |
508-1037 | Ошибки IronSource Ads SDK. Более подробную информацию смотрите в документации . |
Журнал изменений адаптера-посредника IronSource Flutter
1.0.0
- Первоначальный выпуск.
- Проверенная совместимость с адаптером IronSource Android версии 8.0.0.0.
- Проверенная совместимость с адаптером IronSource iOS версии 8.0.0.0.0.
- Создано и протестировано с помощью плагина Google Mobile Ads Flutter версии 5.1.0.