Баннерная реклама занимает место в макете приложения, либо вверху, либо внизу экрана устройства. Она остается на экране, пока пользователи взаимодействуют с приложением, и может автоматически обновляться через определенный промежуток времени.
Это руководство поможет вам начать работу с закрепленными адаптивными баннерными объявлениями . Закрепленные адаптивные баннеры оптимизируют размер рекламы для каждого устройства, используя указанную вами ширину рекламы.
Закрепленные адаптивные баннерные объявления — это объявления с фиксированным соотношением сторон, а не с фиксированным размером . Соотношение сторон похоже на 320x50. После указания полной доступной ширины Google Mobile Ads SDK возвращает объявление с оптимальной высотой для этой ширины. Оптимальная высота объявления остается постоянной для разных запросов объявлений, а содержимое, окружающее объявление, остается на месте при обновлении объявления.
Всегда проводите тестирование с помощью тестовых объявлений
При создании и тестировании приложений убедитесь, что вы используете тестовые объявления, а не живые, производственные объявления. Невыполнение этого требования может привести к блокировке вашего аккаунта.
Самый простой способ загрузить тестовые объявления — использовать наш специальный идентификатор тестового рекламного блока для баннеров:
/21775744923/example/adaptive-banner
Тестовые рекламные блоки настроены на возврат тестовых объявлений для каждого запроса, и вы можете свободно использовать их в своих приложениях при кодировании, тестировании и отладке. Просто убедитесь, что вы заменили их на свои собственные идентификаторы рекламных блоков перед публикацией приложения.
Получить размер объявления
Чтобы запросить рекламный баннер нужного размера, выполните следующие действия:
Получите ширину экрана устройства в пикселях, не зависящих от плотности (dp), используя
MediaQuery.of(context). Если вы не хотите использовать полную ширину экрана, вы можете задать собственную ширину.Используйте соответствующий статический метод класса
AdSizeдля получения объектаAdSize. Например, используйтеAdSize.getCurrentOrientationAnchoredAdaptiveBannerAdSize(int width)для получения размера рекламы для текущей ориентации.
// Get an AnchoredAdaptiveBannerAdSize before loading the ad.
final size = await AdSize.getCurrentOrientationAnchoredAdaptiveBannerAdSize(
MediaQuery.sizeOf(context).width.truncate());
Загрузить объявление
В следующем примере создается рекламный баннер:
class BannerExampleState extends State<BannerExample>{
AdManagerBannerAd? _bannerAd;
bool _isLoaded = false;
// TODO: replace this test ad unit with your own ad unit.
final adUnitId = '/21775744923/example/adaptive-banner';
/// Loads a banner ad.
void loadAd() async {
// Get an AnchoredAdaptiveBannerAdSize before loading the ad.
final size = await AdSize.getCurrentOrientationAnchoredAdaptiveBannerAdSize(
MediaQuery.sizeOf(context).width.truncate());
_bannerAd = AdManagerBannerAd(
adUnitId: adUnitId,
request: const AdManagerAdRequest(),
size: size,
listener: AdManagerBannerAdListener(
// Called when an ad is successfully received.
onAdLoaded: (ad) {
debugPrint('$ad loaded.');
setState(() {
_isLoaded = true;
});
},
// Called when an ad request failed.
onAdFailedToLoad: (ad, err) {
debugPrint('AdManagerBannerAd failed to load: $error');
// Dispose the ad here to free resources.
ad.dispose();
},
),
)..load();
}
}
Рекламные баннеры
Используя AdManagerBannerAdListener , вы можете прослушивать события жизненного цикла, например, когда загружается реклама. Этот пример реализует каждый метод и записывает сообщение в консоль:
class BannerExampleState extends State<BannerExample> {
AdManagerBannerAd? _bannerAd;
bool _isLoaded = false;
// TODO: replace this test ad unit with your own ad unit.
final adUnitId = '/21775744923/example/adaptive-banner';
/// Loads a banner ad.
void loadAd() async {
// Get an AnchoredAdaptiveBannerAdSize before loading the ad.
final size = await AdSize.getCurrentOrientationAnchoredAdaptiveBannerAdSize(
MediaQuery.sizeOf(context).width.truncate());
_bannerAd = AdManagerBannerAd(
adUnitId: adUnitId,
request: const AdManagerAdRequest(),
size: size,
listener: AdManagerBannerAdListener(
// Called when an ad is successfully received.
onAdLoaded: (ad) {
debugPrint('$ad loaded.');
setState(() {
_isLoaded = true;
});
},
// Called when an ad request failed.
onAdFailedToLoad: (ad, err) {
debugPrint('AdManagerBannerAd failed to load: $error');
// Dispose the ad here to free resources.
ad.dispose();
},
// Called when an ad opens an overlay that covers the screen.
onAdOpened: (Ad ad) {},
// Called when an ad removes an overlay that covers the screen.
onAdClosed: (Ad ad) {},
// Called when an impression occurs on the ad.
onAdImpression: (Ad ad) {},
),
)..load();
}
}
Обновить объявление
Если вы настроили обновление рекламного блока, вам не нужно запрашивать другое объявление, если объявление не загружается. Google Mobile Ads SDK учитывает любую частоту обновления, указанную вами в пользовательском интерфейсе Менеджера объявлений. Если вы не включили обновление, отправьте новый запрос. Для получения дополнительных сведений об обновлении рекламного блока, например, о настройке частоты обновления, см. раздел Частота обновления для объявлений в мобильных приложениях .
Отображение рекламного баннера
Чтобы отобразить AdManagerBannerAd как виджет, необходимо создать экземпляр AdWidget с поддерживаемой рекламой после вызова load() . Вы можете создать виджет до вызова load() , но load() необходимо вызвать до его добавления в дерево виджетов.
AdWidget наследует класс Widget Flutter и может использоваться как любой другой виджет. В iOS убедитесь, что вы размещаете виджет в виджете с указанной шириной и высотой. В противном случае ваша реклама может не отображаться. AdManagerBannerAd можно разместить в контейнере с размером, соответствующим рекламе:
if (_bannerAd != null) {
Align(
alignment: Alignment.bottomCenter,
child: SafeArea(
child: SizedBox(
width: _bannerAd!.size.width.toDouble(),
height: _bannerAd!.size.height.toDouble(),
child: AdWidget(ad: _bannerAd!),
),
),
)
}
Рекламу необходимо удалить, когда доступ к ней больше не нужен. Лучшая практика для вызова dispose() — это либо после удаления AdWidget из дерева виджетов, либо в обратном вызове AdManagerBannerAdListener.onAdFailedToLoad() .
Вот и все! Теперь ваше приложение готово к показу баннерной рекламы.
Ограничение прокрутки на Android 9 и ниже
Мы знаем, что некоторые старые или менее мощные устройства под управлением Android 9 или более ранних версий могут иметь неоптимальную производительность при отображении встроенных баннерных объявлений в прокручиваемых представлениях. Мы рекомендуем использовать эти типы баннеров только на Android 10 или более поздних версиях. Фиксированные баннеры, такие как закрепленные баннеры, не подвержены влиянию и могут использоваться с оптимальной производительностью на всех уровнях API Android.
Узнайте о других типах баннеров
Ознакомьтесь с другими типами баннеров, определенными в этом разделе для вашего приложения Flutter.
Встроенные адаптивные баннеры
Встроенные адаптивные баннеры имеют переменную высоту и являются более крупными и высокими баннерами по сравнению с закрепленными адаптивными баннерами. Встроенные адаптивные баннеры рекомендуются вместо закрепленных адаптивных баннеров для приложений, которые размещают баннерную рекламу в прокручиваемом контенте. Для получения более подробной информации см. встроенные адаптивные баннеры .
Складные баннеры
Сворачиваемые баннерные объявления — это баннерные объявления, которые изначально представлены в виде большего наложения с кнопкой для сворачивания объявления до меньшего размера. Рассмотрите возможность использования этого баннера для дальнейшей оптимизации производительности. Для получения более подробной информации см. раздел сворачиваемые баннерные объявления .