Полноэкранная реклама

Interstitial — это полноэкранная реклама.

Вы можете использовать наше демо приложение в качестве примера по интеграции.

Демо приложение

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

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

Kotlin

Appodeal.isLoaded(Appodeal.INTERSTITIAL)

Java

Appodeal.isLoaded(Appodeal.INTERSTITIAL);

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

Kotlin

if (Appodeal.isLoaded(Appodeal.INTERSTITIAL)) {
    Appodeal.show(this, Appodeal.INTERSTITIAL)
}

Java

if (Appodeal.isLoaded(Appodeal.INTERSTITIAL)) {
    Appodeal.show(this, Appodeal.INTERSTITIAL);
}

Отображение

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

Kotlin

Appodeal.show(this, Appodeal.INTERSTITIAL)

Java

Appodeal.show(this, Appodeal.INTERSTITIAL);

SDK не может отображать рекламу без подключения к сети!

Метод возвращает boolean значение, указывающее, был ли передан вызов метода show соответствующему SDK.

Ручное Кэширование

По умолчанию автоматическое кэширование включено: Appodeal SDK начинает загружать полноэкранную рекламу сразу после вызова метода инициализации.

Следующая полноэкранная реклама начинает загружаться сразу после вызова метода show.

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

Kotlin

Appodeal.setAutoCache(Appodeal.INTERSTITIAL, false)

Java

Appodeal.setAutoCache(Appodeal.INTERSTITIAL, false);

Для кеширования полноэкранной рекламы используйте метод:

Kotlin

Appodeal.cache(this, Appodeal.INTERSTITIAL)

Java

Appodeal.cache(this, Appodeal.INTERSTITIAL);

Более подробную информацию о ручном кешировании рекламы вы можете найти в нашем FAQ.

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

Kotlin

Appodeal.setInterstitialCallbacks(object : InterstitialCallbacks {
  override fun onInterstitialLoaded(isPrecache: Boolean) {
    // Called when interstitial is loaded
  }
  override fun onInterstitialFailedToLoad() {
    // Called when interstitial failed to load
  }
  override fun onInterstitialShown() {
    // Called when interstitial is shown
  }
  override fun onInterstitialShowFailed() {
    // Called when interstitial show failed
  }
  override fun onInterstitialClicked() {
    // Called when interstitial is clicked
  }
  override fun onInterstitialClosed() {
    // Called when interstitial is closed
  }
  override fun onInterstitialExpired() {
    // Called when interstitial is expired
  }
})

Java

Appodeal.setInterstitialCallbacks(new InterstitialCallbacks() {
  @Override
  public void onInterstitialLoaded(boolean isPrecache) {
    // Called when interstitial is loaded
  }
  @Override
  public void onInterstitialFailedToLoad() {
    // Called when interstitial failed to load
  }
  @Override
  public void onInterstitialShown() {
    // Called when interstitial is shown
  }
  @Override
  public void onInterstitialShowFailed() {
    // Called when interstitial show failed
  }
  @Override
  public void onInterstitialClicked() {
    // Called when interstitial is clicked
  }
  @Override
  public void onInterstitialClosed() {
    // Called when interstitial is closed
  }
  @Override
  public void onInterstitialExpired() {
    // Called when interstitial is expired
  }
});

к сведению

Вcе callback методы вызываются в главном потоке

Плейсменты

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

Kotlin

Appodeal.show(this, Appodeal.INTERSTITIAL, "yourPlacementName")

Java

Appodeal.show(this, Appodeal.INTERSTITIAL, "yourPlacementName");

Если загруженное объявление не может быть показано для определенного плейсмента, ничего не будет показано. Если автоматическое кеширование включено, SDK начнет кэшировать другое объявление, что может повлиять на display rate. Чтобы сохранить загруженное объявление для использования в будущем (например, для другого места размещения), перед вызовом метода show проверьте, можно ли показывать объявление:

Kotlin

if (Appodeal.canShow(Appodeal.INTERSTITIAL, "yourPlacementName")) {
    Appodeal.show(this, Appodeal.INTERSTITIAL, "yourPlacementName")
}

Java

if (Appodeal.canShow(Appodeal.INTERSTITIAL, "yourPlacementName")) {
    Appodeal.show(this, Appodeal.INTERSTITIAL, "yourPlacementName");
}

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

Если у вас нет плейсментов или вы вызовете Appodeal.show метод с плейсментом, которого не существует, показ будет помечен с использованием плейсмента default и будут применены его настройки.

Важно!

Настройки размещения влияют ТОЛЬКО на представление рекламы, но не на загрузку или кеширование.

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

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

Kotlin

Appodeal.getPredictedEcpm(Appodeal.INTERSTITIAL)

Java

Appodeal.getPredictedEcpm(Appodeal.INTERSTITIAL);

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

Проверка Инициализации

Чтобы проверить, инициализирована ли полноэкранная реклама, вы можете использовать метод:

Kotlin

Appodeal.isInitialized(Appodeal.INTERSTITIAL)

Java

Appodeal.isInitialized(Appodeal.INTERSTITIAL);

Возвращает true, если полноэкранная реклама была инициализирована.

Проверка Типа Кэширования

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

Kotlin

Appodeal.isAutoCacheEnabled(Appodeal.INTERSTITIAL)

Java

Appodeal.isAutoCacheEnabled(Appodeal.INTERSTITIAL);

Возвращает true, если автоматическое кеширование включено для полноэкранной рекламы.

Отключение Звука В Рекламе, Если Громкость Вызова Отключена

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

Kotlin

Appodeal.muteVideosIfCallsMuted(true)

Java

Appodeal.muteVideosIfCallsMuted(true);

примечание

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

Отслеживание Показа

Вы всегда можете проверить в логах, был ли отслежен показ и видна ли ваша реклама.

В случае успешного отслеживания показов вы увидите лог Interstitial [Notify Shown].

Log

Appodeal  com.example.app  D Interstitial [Notify Shown]