Посредничество

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