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

В этом руководстве рассказывается, как интегрировать адаптер медиации с приложением для iOS.

Требования

Чтобы интегрировать посредничество для определенного формата объявлений, сначала нужно интегрировать этот формат в приложение:

Вы только начали работать с медиацией? Прочитайте статью Что такое медиация.

Для назначения ставок: Google Mobile Ads SDK 7.53.1 или более поздняя версия.

Инициализация Google Mobile Ads SDK

В кратком руководстве по началу работы рассказывается, как инициализировать Google Mobile Ads SDK. Во время этого вызова инициализации также инициализируются адаптеры медиации. Важно дождаться завершения инициализации, прежде чем загружать объявления, чтобы убедиться, что все рекламные сети участвуют в первом запросе объявления.

В приведенном ниже образце кода показано, как проверить статус инициализации каждого адаптера перед отправкой запроса объявления.

Swift

MobileAds.shared.start { initializationStatus in
  // Check each adapter's initialization status.
  for (adapterName, status) in initializationStatus.adapterStatusesByClassName {
    print(
      "Adapter: \(adapterName), Description: \(status.description), Latency: \(status.latency)")
  }
}

Objective-C

[[GADMobileAds sharedInstance]
    startWithCompletionHandler:^(GADInitializationStatus *_Nonnull status) {
      // Check each adapter's initialization status.
      NSDictionary<NSString *, GADAdapterStatus *> *adapterStatuses =
          status.adapterStatusesByClassName;
      for (NSString *adapterName in adapterStatuses) {
        GADAdapterStatus *adapterStatus = adapterStatuses[adapterName];
        NSLog(@"Adapter: %@, Description: %@, Latency: %f", adapterName,
              adapterStatus.description, adapterStatus.latency);
      }
    }];

Как узнать, какая рекламная сеть победила

У каждого класса формата объявлений есть свойство GADResponseInfo, которое содержит adNetworkClassName, возвращающее название класса рекламной сети для текущего объявления. adNetworkClassName получает значение только после успешной загрузки объявления. В приведенном ниже коде показано, как получить эту информацию для баннеров.

Swift

print(
  "Adapter class name: \(ad.responseInfo?.loadedAdNetworkResponseInfo?.adNetworkClassName ?? "Unknown")"
)

Objective-C

NSLog(@"Adapter class name: %@",
      ad.responseInfo.loadedAdNetworkResponseInfo.adNetworkClassName ?: @"Unknown");

Подробнее о том, как получить информацию об ответе на запрос объявления…

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

Как использовать нативные объявления с медиацией

Ниже приведены рекомендации по реализации медиации для нативных объявлений.

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

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

Если вам нужно соблюдать законы штатов США о конфиденциальности или Генеральный регламент ЕС о защите персональных данных (GDPR), выполните инструкции в разделе Настройки законов штатов США или Настройки GDPR, чтобы добавить партнеров по медиации в список рекламных партнеров для соблюдения законов штатов США или GDPR в разделе "Конфиденциальность и сообщения" Менеджера рекламы. В противном случае партнеры не смогут показывать рекламу в вашем приложении.

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