Предварительная загрузка объявлений (бета)

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

Предварительная загрузка объявлений – это функция загрузки объявлений, управляемая Google в Google Mobile Ads Flutter Plugin. Она позволяет управлять загрузкой и кешированием объявлений от вашего имени. Предварительная загрузка объявлений требует изменить подход к управлению загрузкой. Чтобы оптимизировать производительность с помощью предварительной загрузки объявлений, отключите пользовательское кеширование и передайте эту функцию Google Mobile Ads Flutter Plugin.

Предварительная загрузка объявлений имеет следующие преимущества по сравнению с загрузкой вручную:

  • Управление ссылками. Загруженные объявления сохраняются, поэтому вам не нужно поддерживать ссылки, пока вы не будете готовы их показывать.
  • Автоматическая перезагрузка. Новое объявление загружается автоматически, когда вы извлекаете одно из кеша.
  • Управляемые повторные попытки. Автоматически повторяет неудачные запросы с использованием экспоненциального откладывания.
  • Обработка истечения срока действия. Объявления автоматически обновляются до истечения срока действия (обычно через час).
  • Оптимизация кеша. Если размер кеша больше единицы, Google Mobile Ads Flutter Pluginоптимизирует порядок кеширования, чтобы показывать наиболее подходящие объявления.

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

Требования

Прежде чем приступить к выполнению инструкций из этого руководства, настройте Google Mobile Ads Flutter Plugin.

Как начать предварительную загрузку объявлений

При запуске приложения вызовите метод start один раз. После вызова метода start Google Mobile Ads Flutter Plugin автоматически предварительно загружает объявления и повторяет неудачные запросы для предварительно загруженных конфигураций.

В следующем примере начинается предварительная загрузка объявлений:

InterstitialAdPreloader.start(
  preloadId: _adUnitId,
  preloadConfiguration: PreloadConfiguration(adUnitId: _adUnitId),
  callback: const PreloadCallback(),
);

Замените _adUnitId идентификатором рекламного блока.

Как получить и показать предзагруженное объявление

При предварительной загрузке объявлений Google Mobile Ads Flutter Plugin хранит их в кеше. Чтобы показать объявление, вызовите метод pollAd. Google Mobile Ads Flutter Plugin получает доступное объявление и автоматически предварительно загружает следующее объявление в фоновом режиме.

Не вызывайте метод pollAd, пока не будете готовы показать объявление. Хранение объявлений в кеше позволяет Google Mobile Ads Flutter Plugin автоматически обновлять объявления с истекшим сроком действия и оптимизировать кеш.

В следующем примере показано, как получить и показать предварительно загруженное объявление:

void _pollAndShowAd() async {
  final InterstitialAd? ad = await InterstitialAdPreloader.pollAd(_adUnitId);
  if (ad != null) {
    _interstitialAd = ad;
    ad.fullScreenContentCallback = FullScreenContentCallback(
      onAdImpression: (ad) {
        // Called when an impression occurs on the ad.
        debugPrint('Ad recorded an impression.');
      },
    );
    ad.onPaidEvent = (ad, valueMicros, precision, currencyCode) {
      // Called when an ad is estimated to have earned money.
      debugPrint('Ad paid: $valueMicros $currencyCode.');
    };
    // Show the ad.
    await ad.show();
  }
}

Как проверить доступность предварительной загрузки объявлений

Чтобы проверить доступность рекламы, выполните одно из следующих действий:

Как узнать, доступно ли предзагруженное объявление

В следующем примере проверяется доступность объявлений:

void _checkAdAvailability() async {
  final bool isAvailable = await InterstitialAdPreloader.isAdAvailable(
    _adUnitId,
  );
  debugPrint('Is ad available: $isAvailable');
}

Слушайте информацию о доступности предзагруженных объявлений

Зарегистрируйте события предварительной загрузки, чтобы получать уведомления об успешной предварительной загрузке объявлений, ее сбое или исчерпании кеша объявлений.

События предзагрузки предназначены для аналитики. В обратных вызовах события предзагрузки:

  • Не вызывать start.
  • Не вызывайте функцию pollAd, если объявление не будет показано сразу.

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

InterstitialAdPreloader.start(
  preloadId: _adUnitId,
  preloadConfiguration: PreloadConfiguration(adUnitId: _adUnitId),
  callback: PreloadCallback(
    onAdPreloaded: (preloadId, responseInfo) {
      debugPrint('Ad preloaded for ID: $preloadId');
    },
    onAdFailedToPreload: (preloadId, error) {
      debugPrint('Ad failed to preload for ID: $preloadId. Error: $error');
    },
    onAdsExhausted: (preloadId) {
      debugPrint('All preloaded ads exhausted for ID: $preloadId');
    },
  ),
);

Как отключить предварительную загрузку рекламы

Если вам больше не нужно показывать объявления с идентификатором предварительной загрузки в текущем сеансе, вы можете остановить предварительную загрузку. Чтобы остановить предварительную загрузку объявлений для определенного идентификатора, вызовите destroy с идентификатором предварительной загрузки. Чтобы остановить предварительную загрузку для всех загрузчиков, вызовите destroyAll.

void _stopPreloading() async {
  await InterstitialAdPreloader.destroy(_adUnitId);
}

Как задать размер буфера

Размер буфера определяет количество предварительно загруженных объявлений, хранящихся в памяти. По умолчанию Google оптимизирует размер буфера, чтобы сбалансировать потребление памяти и задержку показа рекламы. Если в вашем приложении объявления показываются до того, как загрузится следующее, вы можете задать собственный размер буфера, чтобы увеличить количество объявлений, хранящихся в памяти.

InterstitialAdPreloader.start(
  preloadId: _adUnitId,
  preloadConfiguration: PreloadConfiguration(
    adUnitId: _adUnitId,
    bufferSize: 3,
  ),
  callback: const PreloadCallback(),
);

Лимиты предварительной загрузки кеша

Google Mobile Ads Flutter Plugin устанавливает ограничение на общее количество предварительно загруженных объявлений в приложении для всех рекламных блоков и идентификаторов предварительной загрузки:

  • По умолчанию: Google Mobile Ads Flutter Plugin может хранить в памяти до шести предварительно загруженных объявлений. Это ограничение распространяется на все форматы и идентификаторы предварительной загрузки.
  • Мы рекомендуем задать для каждого идентификатора предзагрузки размер буфера, равный двум.