Как настроить медиацию

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

В этом руководстве рассказывается, как интегрировать адаптер медиации в приложение 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)

Чтобы использовать API плагина для Android, добавьте в файл settings.gradle следующие строки:

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 с помощью Google User Messaging Platform (UMP) SDK…

Далее
Выберите источники рекламы.