Перейти к основному содержимому
осторожно
Unity Plugin 3.0.2 устарела. Stable версия - здесь.
Версия: 3.0.2

Баннер

Баннерная реклама - это классические статические баннеры, которые обычно располагаются внизу или вверху экрана.

Appodeal поддерживает традиционные баннеры 320 x 50, баннеры 728 x 90 для планшетов и смарт-баннеры, которые адаптируются к размеру и ориентации устройства.

На экране одновременно может быть показан только один баннер.

Отображение​

По умолчанию рекламные баннеры обновляются автоматически каждые 15 секунд. Для отображения баннера необходимо использовать следующий код:

// Display banner at the bottom of the screen
Appodeal.Show(AppodealShowStyle.BannerBottom);

// Display banner at the top of the screen
Appodeal.Show(AppodealShowStyle.BannerTop);

// Display banner at the left of the screen
Appodeal.Show(AppodealShowStyle.BannerLeft);

// Display banner at the right of the screen
Appodeal.Show(AppodealShowStyle.BannerRight);

Отображение Баннера В Произвольной Позиции​

Баннер можно перемещать вдоль осей координат в выбранное вами положение.

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

Appodeal.ShowBannerView(yPosition, xPosition, "placementName");

Для yPosition можно установить свое значение либо константу:

  • AppodealViewPosition.VerticalTop — привяжет баннер к верху экрана.
  • AppodealViewPosition.VerticalBottom — привяжет баннер к низу экрана.

Для xPosition также можно установить свое значение либо константу:

  • AppodealViewPosition.HorizontalSmart — использует всю ширину экрана.
  • AppodealViewPosition.HorizontalCenter — привяжет баннер к центру по горизонтали.
  • AppodealViewPosition.HorizontalRight — привяжет баннер к правой стороне экрана.
  • AppodealViewPosition.HorizontalLeft — привяжет баннер к левой стороне экрана.
Отсчёт отступа для баннера рассчитывается относительно левого верхнего угла экрана.

Скрытие Баннера​

Чтобы скрыть баннер, который был показан при помощи метода Appodeal.Show(), используйте следующий код:

Appodeal.Hide(AppodealAdType.Banner);

Чтобы скрыть баннер, который был показан при помощи метода Appodeal.ShowBannerView(), используйте следующий код:

Appodeal.HideBannerView();

Удаление Скрытого Баннера​

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

Appodeal.Destroy(AppodealAdType.Banner);

Проверка Загрузки​

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

Appodeal.IsLoaded(AppodealAdType.Banner);
примечание

Метод Appodeal.Show() для баннеров может быть вызван в любой момент. Если нет доступной рекламы, она будет автоматически загружена и сразу же показана.

Методы Обратного Вызова​

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

Подпишитесь на желаемое событие баннера используя один из методов из нашей инструкции. (вы можете подписаться на любое событие, которое захотите)

AppodealCallbacks.Banner.OnLoaded += (sender, args) => { };

Ниже перечислены все существующие ивенты для баннерной рекламы:

public void SomeMethod()
{
    AppodealCallbacks.Banner.OnLoaded += OnBannerLoaded;
    AppodealCallbacks.Banner.OnFailedToLoad += OnBannerFailedToLoad;
    AppodealCallbacks.Banner.OnShown += OnBannerShown;
    AppodealCallbacks.Banner.OnShowFailed += OnBannerShowFailed;
    AppodealCallbacks.Banner.OnClicked += OnBannerClicked;
    AppodealCallbacks.Banner.OnExpired += OnBannerExpired;
}

#region BannerAd Callbacks

// Called when a banner is loaded (height arg shows banner's height, precache arg shows if the loaded ad is precache
private void OnBannerLoaded(object sender, BannerLoadedEventArgs e)
{
    Debug.Log("Banner loaded");
}

// Called when banner failed to load
private void OnBannerFailedToLoad(object sender, EventArgs e)
{
    Debug.Log("Banner failed to load");
}

// Called when banner failed to show
private void OnBannerShowFailed(object sender, EventArgs e)
{
    Debug.Log("Banner show failed");
}

// Called when banner is shown
private void OnBannerShown(object sender, EventArgs e)
{
    Debug.Log("Banner shown");
}

 // Called when banner is clicked
private void OnBannerClicked(object sender, EventArgs e)
{
    Debug.Log("Banner clicked");
}

// Called when banner is expired and can not be shown
private void OnBannerExpired(object sender, EventArgs e)
{
    Debug.Log("Banner expired");
}

#endregion
Главный Поток Unity

Все методы обратного вызова вызываются в главных потоках Android/iOS, которые не совпадают с главным потоком Unity. Если вы хотите обрабатывать методы обратного вызова в основном потоке Unity, следуйте этой инструкции.

Плейсменты​

Appodeal SDK позволяет помечать каждый показ указанным плейсментом. Для использования плейсментов вам необходимо сначала их создать в Appodeal Dashboard. Здесь можно найти больше информации о плейсментах.

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

Appodeal.Show(AppodealShowStyle.BannerTop, "placementName");

Получение Прогнозируемого eCPM​

Этот метод возвращает ожидаемую эффективную цену за тысячу показов для закешированного объявления. Сумма рассчитывается на основе исторических данных для текущего рекламного блока.

Appodeal.GetPredictedEcpm(AppodealAdType.Banner);

Дополнительно​

Включение 728x90 Баннеров​

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

Appodeal.SetTabletBanners(true);

Отключение Анимации Обновления Баннеров​

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

Appodeal.SetBannerAnimation(false);

Адаптивные Баннеры​

Адаптивные баннеры - это баннерные объявления, которые автоматически подстраиваются к размеру экрана. Их использование помогает справляться с увеличением фрагментации размеров экрана на разных устройствах. В Appodeal SDK смарт-баннеры включены по умолчанию. Чтобы отключить их, используйте следующий метод до инициализации:

Appodeal.SetSmartBanners(false);