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

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

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

Demo App

Показ рекламы

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

Kotlin

Appodeal.show(this, Appodeal.INTERSTITIAL)

Java

Appodeal.show(this, Appodeal.INTERSTITIAL);

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

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

Проверка загруженной рекламы

Вы можете проверить статус загрузки перед показом. Этот метод возвращает 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);
}

Показ рекламы с плейсментом

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 и будут применены его настройки.

Важно!

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

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

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 начинает загружать полноэкранную рекламу сразу после вызова метода инициализации.

Следующая полноэкранная реклама начинает загружаться сразу после вызова метода 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.isInitialized(Appodeal.INTERSTITIAL)

Java

Appodeal.isInitialized(Appodeal.INTERSTITIAL);

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

Проверка типа кеширования

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

Kotlin

Appodeal.isAutoCacheEnabled(Appodeal.INTERSTITIAL)

Java

Appodeal.isAutoCacheEnabled(Appodeal.INTERSTITIAL);

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

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

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

Kotlin

Appodeal.getPredictedEcpm(Appodeal.INTERSTITIAL)

Java

Appodeal.getPredictedEcpm(Appodeal.INTERSTITIAL);

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

Отключение звука в рекламе, если громкость вызова отключена

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

Kotlin

Appodeal.muteVideosIfCallsMuted(true)

Java

Appodeal.muteVideosIfCallsMuted(true);

примечание

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

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

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

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

Log

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