Руководство по дополнительным параметрам: пакет SDK Vungle для Android

Содержание

  1. Глобальная конфигурация объявлений
  2. Конфигурация отдельных объявлений
  3. Параметры конфигурации
  4. Интерфейс прослушивателя событий
  5. Proguard

Обратите внимание. В этой статье рассматриваются расширенные настройки пакета SDK Vungle для Android. Если вы только начинаете работать с нашим SDK для Android, вам следует ознакомиться с нашим руководством по началу работы для Android.

Глобальная конфигурация объявлений

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

import com.vungle.publisher.VunglePub;
import com.vungle.publisher.AdConfig;
import com.vungle.publisher.Orientation;

public class FirstActivity extends android.app.Activity {

  ...

  @Override
  public void onCreate(Bundle savedInstanceState) {
      super.onCreate(savedInstanceState);

      ...

      vunglePub.init(this, app_id);

      // получение ссылки на глобальный объект AdConfig
      final AdConfig globalAdConfig = vunglePub.getGlobalAdConfig();

      // задайте любые нужные параметры конфигурации. 
      // Полное описание доступных параметров см. в разделе      
      // Раздел «Параметры конфигурации».
      globalAdConfig.setSoundEnabled(true);
      globalAdConfig.setOrientation(Orientation.autoRotate);

  }
}

Конфигурация отдельных объявлений

Вы можете дополнительно настроить каждое отдельное объявление для воспроизведения, предоставив объект AdConfig для playAd. Параметры, заданные в глобальной конфигурации рекламы объявлений (см. выше), будут переопределены указанными значениями.  Передайте переопределение AdConfig следующим образом:

import com.vungle.publisher.VunglePub;
import com.vungle.publisher.AdConfig;

public class GameActivity extends android.app.Activity {
  ...

  private void onLevelComplete() {
      // создайте новый объект AdConfig
      final AdConfig overrideConfig = new AdConfig();

      // задайте любые нужные параметры конфигурации. 
      // Полное описание доступных параметров см. в разделе       
      // Раздел «Параметры конфигурации».
      overrideConfig.setIncentivized(true);
      overrideConfig.setSoundEnabled(false);

      // Объект overrideConfig будет влиять только на это воспроизведение рекламы.
      vunglePub.playAd(overrideConfig);
  }
}

Параметры конфигурации

Объект AdConfig

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

Метод По умолчанию Описание
setOrientation Orientation.matchVideo Orientation.autoRotateуказывает, что объявление будет самостоятельно поворачиваться в зависимости от ориентации устройства.Orientation.matchVideoуказывает, что объявление будет воспроизводиться в лучшей ориентации для видео (как правило, альбомной).
setSoundEnabled true Задает начальное состояние звука для объявления. Если указано true, используются громкость устройства и настройки звука. Если указано false, видео начинает воспроизводиться с отключенным звуком, однако это может быть изменено пользователем.
setBackButtonImmediatelyEnabled false Если true, пользователь может незамедлительно закрыть объявление с помощью кнопки «Назад». Если false, пользователь не может использовать кнопку «Назад» для выхода из объявления, пока не покажется кнопка «Закрыть» на экране.
setImmersiveMode false Включает или выключает режим комфортного просмотра на устройствах KitKat+
setIncentivized false Включает «стимулированный» режим – необходимо задать как true, если используются в обратных вызовах «сервер – сервер» для реклам с наградой. Если значение параметра — «true», при попытке пользователя пропустить рекламу откроется диалоговое окно подтверждения. Если задать «false», подтверждение не появится. Дополнительные инструкции по настройке стимулированной рекламы см. здесь.
setIncentivizedUserId нет Указывает, что уникальный идентификатор пользователя, который передается в ваше приложение, должен подтверждать, что этот пользователь должен быть вознагражден за просмотр стимулированной рекламы. Н/Д, если объявление не является стимулированным.
setIncentivizedCancelDialogTitle «Закрыть видео?» Задает заголовок диалога подтверждения при пропуске стимулированной рекламы. Н/Д, если объявление не является стимулированным.
setIncentivizedCancelDialogBodyText «Ранее закрытие этого видео не позволит вам заработать вознаграждение. Вы уверены?» Задает текст диалога подтверждения при пропуске стимулированной рекламы. Н/Д, если объявление не является стимулированным.
setIncentivizedCancelDialogCloseButtonText «Закрыть видео» Задает текст «кнопки отмены» диалога подтверждения при пропуске стимулированной рекламы. Н/Д, если объявление не является стимулированным.
setIncentivizedCancelDialogKeepWatchingButtonText «Продолжайте просмотр» Задает текст «кнопки продолжения просмотра» диалога подтверждения при пропуске стимулированной рекламы. Н/Д, если объявление не является стимулированным.
setExtra1..8 нет ПОЯВИТСЯ ВСКОРЕ — Эта функция еще не была завершена, однако после ее появления вы сможете пользоваться ею для отслеживания таких показателей, как группа возрастов, пол и т. д.
setPlacement нет ПОЯВИТСЯ ВСКОРЕ — Метаданные с информацией о размещении отдельного рекламного показа.  Используются для фильтрации показов рекламы при запросе данных отчетности по производительности приложения
setTransitionAnimationEnabled false Включает или отключает стандартную анимацию переходов фрагментов

Отображение кнопки «Закрыть»

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

Интерфейс EventListener

Пакет Publisher SDK формирует несколько событий, которыми можно управлять программно путем реализации классов com.vungle.publisher.EventListener и регистрации/удаления их с помощью:

VunglePub.setEventListeners(eventListener1, eventListener2, ...)

Помните, что во избежание утечки памяти следует удалить eventListener, если больше не следует его использовать.

Доступные методы для управления EventListener приведены ниже:

Метод Описание
addEventListeners() Очищает зарегистрированные прослушиватели событий EventListener, затем добавляет входные прослушиватели событий eventListener.
clearEventListeners() Очищает объекты EventListener
removeEventListeners() Удаляет входные EventListener.

Замечание о потоке пользовательского интерфейса

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

import com.vungle.publisher.EventListener;
...

public class FirstActivity extends android.app.Activity {
  ...

  private final EventListener vungleListener = new EventListener(){

@Deprecated
@Override public void onVideoView(boolean isCompletedView, int watchedMillis, int videoDurationMillis) { // Этот метод устарел и будет удален. Не используйте этот метод.
// Вместо него используйте onAdEnd.
} @Override public void onAdStart() { // Вызывается перед воспроизведением объявления } @Override public void onAdEnd(boolean wasSuccessfulView, boolean wasCallToActionClicked) { // Вызывается, когда пользователь закрывает объявление и управление возвращается в приложение // Если для wasSuccessfulView задано true, пользователь, просмотревший объявление, должен получить вознаграждение. // (если это было объявление с вознаграждением).
// если wasCallToActionClicked задано как true, пользователь щелкнул кнопку призыва к действию
           // в объявлении.
    }

    @Override
    public void onAdPlayableChanged(boolean isAdPlayable) {
        // Вызывается при изменении состояния воспроизведения, если isAdPlayable является true, вы можете        
        // воспроизвести объявление.
        // Если false, вы пока не можете воспроизвести объявление.
    }

    @Override
    public void onAdUnavailable(String reason) {
        // Вызывается после вызова VunglePub.playAd(), однако объявление еще не может быть воспроизведено
    }

  };

  @Override
  public void onCreate(Bundle savedInstanceState) {
      ...

      vunglePub.init(this, app_id);
      vunglePub.setEventListeners(vungleListener);

  };

@Override public void onDestroy() { ... vunglePub.clearEventListeners(); };
}

Proguard

При использовании Proguard убедитесь, что следующие строки присутствуют в конфигурационном файле Proguard:

-dontwarn com.vungle.**
-keep class com.vungle.** { *; } // omitted public
-keep class javax.inject.*
Была ли эта статья полезной?
Пользователи, считающие этот материал полезным: 7 из 9
Еще есть вопросы? Отправить запрос

Комментарии