В этом руководстве показано, как интегрировать адаптер-посредник с вашим приложением Flutter.
Предварительные условия
Прежде чем вы сможете интегрировать медиацию для формата рекламы, вам необходимо интегрировать этот формат рекламы в свое приложение:
- Баннерная реклама
- Межстраничные объявления
- Нативная реклама
- Объявления с вознаграждением
- Межстраничные объявления с вознаграждением
Впервые в медиации? Прочтите «Введение в медиацию» .
Инициализируйте SDK мобильной рекламы
В кратком руководстве показано, как инициализировать Mobile Ads SDK . Во время этого вызова инициализации также инициализируются адаптеры-посредники. Прежде чем загружать объявления, важно дождаться завершения инициализации, чтобы обеспечить полное участие каждой рекламной сети при первом запросе объявления.
В следующем примере кода показано, как можно проверить статус инициализации каждого адаптера перед отправкой запроса объявления.
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 flutterProjectRoot = rootProject.projectDir.parentFile.toPath()
def plugins = new Properties()
def pluginsFile = new File(flutterProjectRoot.toFile(), '.flutter-plugins')
if (pluginsFile.exists()) {
pluginsFile.withInputStream { stream -> plugins.load(stream) }
}
plugins.each { name, path ->
def pluginDirectory = flutterProjectRoot.resolve(path).resolve('android').toFile()
include ":$name"
project(":$name").projectDir = pluginDirectory
}
Добавить зависимости для партнерских сетей
Адаптеры-посредники и их зависимости необходимо добавить в ваши проекты 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 с помощью SDK Google User Messaging Platform (UMP) .