В этом руководстве рассказывается, как интегрировать адаптер медиации с приложением Flutter.
Требования
Чтобы интегрировать посредничество для определенного формата объявлений, сначала нужно интегрировать этот формат в приложение:
- Баннеры
- Межстраничные объявления
- Нативные объявления
- Объявления с вознаграждением
- Межстраничные объявления с вознаграждением
Вы только начали работать с медиацией? Прочитайте статью Что такое медиация.
Инициализация Google Mobile Ads Flutter Plugin
В кратком руководстве по началу работы рассказывается, как инициализировать Google Mobile Ads Flutter Plugin. Во время этого вызова инициализации также инициализируются адаптеры медиации. Важно дождаться завершения инициализации, прежде чем загружать объявления, чтобы убедиться, что все рекламные сети участвуют в первом запросе объявления.
В приведенном ниже образце кода показано, как проверить статус инициализации каждого адаптера перед отправкой запроса объявления.
void main() {
WidgetsFlutterBinding.ensureInitialized();
MobileAds.instance.initialize()
.then((initializationStatus) {
initializationStatus.adapterStatuses.forEach((key, value) {
debugPrint('Adapter status for $key: ${value.description}');
});
});
runApp(MyApp());
}
Как обновить настройки Gradle (только для Android)
Добавьте в файл settings.gradle следующие строки, чтобы использовать API Android плагина:
def flutterSdkPath = {
def properties = new Properties()
file("local.properties").withInputStream { properties.load(it) }
def flutterSdkPath = properties.getProperty("flutter.sdk")
assert flutterSdkPath != null, "flutter.sdk not set in local.properties"
return flutterSdkPath
}()
includeBuild("$flutterSdkPath/packages/flutter_tools/gradle")
Как добавить зависимости для партнерских сетей
Адаптеры медиации и их зависимости необходимо добавить в проекты Android и iOS. Их можно добавить, обновив файл build.gradle на уровне приложения в Android и Podfile в iOS. Google предлагает адаптеры с открытым исходным кодом на GitHub для Android и iOS.
Подробные инструкции по добавлению адаптера в приложение приведены в документации для каждой партнерской сети:Android iOS.
Как узнать, какой класс адаптера рекламной сети загрузил объявление
В приведенном ниже образце кода показано, как зарегистрировать название класса рекламной сети для баннера:
final bannerAd = AdManagerBannerAd(
size: [AdSize.banner],
adUnitId: '<your-ad-unit>',
listener: AdManagerBannerAdListener(
onAdLoaded: (ad) {
debugPrint('$ad loaded: ${ad.responseInfo?.mediationAdapterClassName}');
},
),
request: AdManagerAdRequest(),
);
Как использовать баннеры с медиацией
Отключите обновление во всех интерфейсах сторонних источников объявлений для рекламных блоков с баннерами, используемых в медиации. Это предотвращает двойное обновление, поскольку Менеджер рекламы также запускает обновление на основе частоты обновления рекламного блока для баннеров.
Как использовать нативные объявления с медиацией
Ниже приведены рекомендации по реализации медиации для нативных объявлений.
- Правила в отношении показа нативных объявлений
- У каждой рекламной сети свои правила. При использовании медиации важно помнить, что ваше приложение должно соответствовать правилам медиативной сети, которая предоставила объявление.
Законы штатов США о конфиденциальности и GDPR
Если вам нужно соблюдать законы штатов США о конфиденциальности или Генеральный регламент ЕС о защите персональных данных (GDPR), выполните инструкции в разделе Настройки законов штатов США или Настройки GDPR, чтобы добавить партнеров по медиации в список рекламных партнеров для соблюдения законов штатов США или GDPR в разделе "Конфиденциальность и сообщения" Менеджера рекламы. В противном случае партнеры не смогут показывать рекламу в вашем приложении.
Узнайте больше о том, как включить ограничение обработки данных (RDP) и получить согласие по GDPR с помощью Google User Messaging Platform (UMP) SDK.