Рекламные баннеры

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

Баннерные объявления — это прямоугольные изображения или текстовые объявления, занимающие место на экране. Они остаются на экране, пока пользователи взаимодействуют с приложением, и могут автоматически обновляться через определенный промежуток времени. Если вы новичок в мобильной рекламе, это отличное место для начала. Пример из практики .

В этом руководстве показано, как интегрировать баннеры в приложение Unity. Помимо фрагментов кода и инструкций, оно также содержит информацию о правильном определении размеров баннеров и ссылки на дополнительные ресурсы.

Предварительные требования

• Пройдите руководство по началу работы .

Всегда проводите тестирование с помощью тестовых объявлений.

Приведённый ниже пример кода содержит идентификатор рекламного блока, который можно использовать для запроса тестовой рекламы. Он специально настроен на возврат тестовой рекламы, а не рабочей, для каждого запроса, что делает его безопасным в использовании.

Однако после регистрации приложения в веб-интерфейсе AdMob и создания собственных идентификаторов рекламных блоков для использования в приложении, во время разработки явно настройте свое устройство как тестовое .

Инициализируйте SDK для мобильной рекламы.

Перед загрузкой рекламы ваше приложение должно инициализировать плагин Google Mobile Ads Unity, вызвав метод MobileAds.Initialize() . Это нужно сделать только один раз, в идеале при запуске приложения.

using GoogleMobileAds;
using GoogleMobileAds.Api;

public class GoogleMobileAdsDemoScript : MonoBehaviour
{
    public void Start()
    {
        // Initialize Google Mobile Ads Unity Plugin.
        MobileAds.Initialize((InitializationStatus initStatus) =>
        {
            // This callback is called once the MobileAds SDK is initialized.
        });
    }
}

Если вы используете медиацию, дождитесь завершения обратного вызова, прежде чем загружать рекламу, так как это гарантирует инициализацию всех адаптеров медиации.

Пример использования BannerView

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

Создать баннерное представление

Первым шагом при использовании баннерного представления является создание экземпляра баннерного представления.

// Create a 320x50 banner at top of the screen.
bannerView = new BannerView("AD_UNIT_ID", AdSize.Banner, AdPosition.Top);
BannerViewSnippets.cs

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

Конструктор класса BannerView имеет следующие параметры:

• adUnitId : Идентификатор рекламного блока баннерной рекламы для загрузки.
• AdSize : Размер баннера , который вы хотите использовать.
• AdPosition : Позиция, в которой должны размещаться баннерные объявления.

(Необязательно) Создайте баннер с заданным положением.

Для более точного управления размещением баннера на экране, чем это позволяют значения AdPosition , используйте конструктор, принимающий в качестве параметров координаты x и y:

// Create a 320x50 banner views at coordinate (0,50) on screen.
bannerView = new BannerView("AD_UNIT_ID", AdSize.Banner, 0, 50);
BannerViewSnippets.cs

Верхний левый угол баннера располагается в точке, заданной значениями x и y, переданными в конструктор, при этом начало координат находится в верхнем левом углу экрана.

(Необязательно) Создайте баннер с пользовательским размером.

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

// Create a 250x250 banner at the bottom of the screen.
AdSize adSize = new AdSize(250, 250);
bannerView = new BannerView("AD_UNIT_ID", adSize, AdPosition.Bottom);
BannerViewSnippets.cs

Загрузить баннерную рекламу

Для загрузки рекламы создайте объект AdRequest и передайте его методу LoadAd() .

// Send a request to load an ad into the banner view.
bannerView.LoadAd(new AdRequest());
BannerViewSnippets.cs

Прослушать события просмотра баннера

Чтобы настроить поведение вашей рекламы, вы можете отслеживать ряд событий в жизненном цикле объявления, таких как загрузка, открытие или закрытие. Для отслеживания этих событий зарегистрируйте делегата:

bannerView.OnBannerAdLoaded += () =>
{
    // Raised when an ad is loaded into the banner view.
};
bannerView.OnBannerAdLoadFailed += (LoadAdError error) =>
{
    // Raised when an ad fails to load into the banner view.
};
bannerView.OnAdPaid += (AdValue adValue) =>
{
    // Raised when the ad is estimated to have earned money.
};
bannerView.OnAdImpressionRecorded += () =>
{
    // Raised when an impression is recorded for an ad.
};
bannerView.OnAdClicked += () =>
{
    // Raised when a click is recorded for an ad.
};
bannerView.OnAdFullScreenContentOpened += () =>
{
    // Raised when an ad opened full screen content.
};
bannerView.OnAdFullScreenContentClosed += () =>
{
    // Raised when the ad closed full screen content.
};
BannerViewSnippets.cs

Удалить баннерное отображение

Чтобы удалить баннер, вызовите метод Destroy() для освобождения ресурсов:

if (bannerView != null)
{
    // Always destroy the banner view when no longer needed.
    bannerView.Destroy();
    bannerView = null;
}
BannerViewSnippets.cs

Если баннер не загружается, мы рекомендуем обновить баннер, а не удалять и создавать новый. Подробнее см. раздел «Обновить объявление» .

Обновить рекламу

Если вы настроили автоматическое обновление рекламного блока, вам не нужно запрашивать новый рекламный блок, если предыдущий не загружается. Плагин Google Mobile Ads Unity учитывает любую частоту обновления, указанную вами в пользовательском интерфейсе AdMob. Если вы не включили автоматическое обновление, отправьте новый запрос. Для получения более подробной информации об обновлении рекламного блока, например, о настройке частоты обновления, см. раздел «Использование автоматического обновления для баннерной рекламы» .

Размеры баннеров

В таблице ниже приведены стандартные размеры баннеров:

Дополнительные ресурсы

• Пример HelloWorld : минимальная реализация всех форматов рекламы.

• Пример использования