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

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

Используйте баннерную рекламу с посредничеством

Обязательно отключите обновление во всех сторонних источниках рекламы для рекламных блоков баннеров, используемых в медиации. Это предотвращает двойное обновление, поскольку Ad Manager также запускает обновление на основе частоты обновления вашего рекламного блока баннера.

Используйте нативную рекламу с посредничеством

Ниже приведены некоторые рекомендации, которые следует учитывать при внедрении собственного посредничества.

Политика представления нативной рекламы
У каждой рекламной сети есть свои правила. При использовании медиации важно помнить, что ваше приложение все равно должно соблюдать правила медиируемой сети, которая предоставила рекламу.

Законы США о конфиденциальности и GDPR

Если вам необходимо соблюдать законы о конфиденциальности в США или Общий регламент по защите данных (GDPR) , следуйте инструкциям в настройках правил штата США или настройках GDPR , чтобы добавить своих партнеров-посредников в список рекламных партнеров US Privacy & messaging или GDPR Менеджера рекламы. Невыполнение этого требования может привести к тому, что партнеры не смогут показывать рекламу в вашем приложении.

Узнайте больше о включении ограниченной обработки данных (RDP) и получении согласия GDPR с помощью SDK Google User Messaging Platform (UMP) .