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

В этом руководстве рассказывается, как интегрировать адаптер медиации в приложение для 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 с помощью Google User Messaging Platform (UMP) SDK…