Интеграция MoPub + Vungle SDK v.5 (Android)

С помощью этого руководства вы добавите в свое приложение пакет Vungle SDK для Android, используя MoPub в качестве главной рекламной сети-посредника.

Содержание

Перед началом работы

  • SDK Vungle Android не был протестирован с MoPub 4.15, поэтому его следует интегрировать только с MoPub 4.14.

  • Панель управления MoPub пока не включает размещения Vungle. Вы можете проверить эффективность уровня размещения, изучив статью Создание отчетов об API для издателей.

  • Перед использованием этого руководства необходимо настроить MoPub в вашем приложении. Пошаговое руководство доступно в статье Руководство по началу работы с MoPub для Android.

  • Вам потребуется идентификатор приложения Vungle и все идентификаторы размещения, которые вы планируете использовать в своем приложении. Эти идентификаторы можно найти на панели управления Vungle (см. статью Настройка размещений и отчеты по ним).

  • Для пакета Vungle SDK необходимы:
    • Android 3.0 (Honeycomb — API версии 11) или более поздней версии
    • Java 1.7 — для совместимости с Android 5.+ требуется наличие JDK 7
    • Java 1.8 — для совместимости с Android 7.+ требуется наличие JDK 8

Шаг 1. Настройка Vungle как пользовательской нативной сети (Custom Native Network)

Чтобы серверы MoPub распознавали интегрированные адаптеры Vungle, необходимо выбрать Vungle пользовательской нативной сетью (Custom Native Network) на панели управления MoPub.

  1. Войдите в панель управления MoPub и выберите Сети на главной панели навигации.

  2. Нажмите Добавить сеть…

    image4.png

    и выберите Пользовательская нативная сеть в нижней части страницы.

    image1.png
  1. В разделе Настройка инвентаря для каждого рекламного блока, который будет использовать Vungle SDK для показа видеорекламы, убедитесь, что MoPub SDK может обнаружить сетевой адаптер, используемый для взаимодействия с Vungle SDK:

    image2.png

    • Если для рекламного блока используется видео с вознаграждением MoPub, добавьте com.mopub.mobileads.VungleRewardedVideo в раздел Пользовательский класс события.

    • Если для рекламного блока используется Полноэкранная рекламная вставка, добавьте com.mopub.mobileads.VungleInterstitial в раздел Пользовательский класс события.

    • Добавьте идентификатор приложения Vungle, идентификатор размещения и все идентификаторы размещения в формате JSON в раздел Пользовательские данные класса события.

    • Установите идентификатор размещения, который требуется связать с рекламным блоком MoPub для pid.
      Примечание. Для каждого приложения создается размещение по умолчанию. На данном шаге инициализации необходимо указать идентификатор размещения, независимо от того, планируете ли вы использовать функции размещения. Если вы создаете несколько размещений, укажите все идентификаторы

      .
    • Привяжите идентификатор размещения, которому присвоен тип «С вознаграждением», к рекламному блоку MoPub формата Видео с вознаграждением, а идентификатор размещения, которому НЕ присвоен тип «С вознаграждением», — к рекламному блоку MoPub формата Полноэкранная рекламная вставка.
      { "appId":"5935efecc802d63d5100000f", "pid":"DEFAULT05223", "pids":"DEFAULT05223, PADUNIT49379, PADUNIT68848, PADUNIT04241, PADUNIT53279, PADUNIT08448" }

Примечание. Пакет Vungle SDK будет автоматически кэшировать рекламу для размещения, которому присвоен статус Автокэширование на панели управления Vungle. Мы настоятельно рекомендуем выбрать в качестве размещения со статусом Автокэширование рекламный блок MoPub, показываемый первым, или рекламный блок, показываемый чаще всего.

Шаг 2. Добавление Vungle в качестве сторонней рекламной сети

Чтобы добавить в приложение пакет Vungle SDK для Android при посредничестве MoPub, сделайте следующее:

  1. Добавьте все файлы адаптера, связанные с Vungle (в разделе /extras/src/com/mopub/mobileads/ в Репозитории адаптера MoPub) в каталог /src/main/java/com/mopub/mobileads/ в проекте вашего приложения. Этот шаг необходим, поскольку SDK MoPub ссылается на эти файлы как «свойства пользовательского класса событий» в каталоге.

    • VungleInterstitial.java
    • VungleRewardedVideo.java
    • VungleRouter.java
    • VungleRouterListener.java

  2. Следуйте инструкциям в разделе «Шаг 1. Добавление Vungle SDK в проект» статьи «Начало работы с Vungle SDK для Android», чтобы добавить необходимые фреймворки.

  3. Если вам нужно настроить Multidex, Proguard и сервисы Google Play, следуйте инструкциям из раздела Дополнительные параметры статьи Начало работы с Vungle SDK для Android, чтобы обновить AndroidManifest.xml в своем проекте.

  4. Когда вам нужно показать видеорекламу Vungle, вызовите метод MoPubInterstitial’s show (или метод MoPubRewardedVideos's showRewardedVideo для рекламы с вознаграждением). (Не обязательно вызывать методы Vungle SDK для Android напрямую. Это сделает пакет MoPub SDK.)

Параметры конфигурации (необязательно)

Рекламные вставки

Атрибут

Значение по умолчанию

Описание

SOUND_ENABLED_KEY

true

Воспроизведение рекламы со звуком или без звука. Установите значение false для воспроизведения без звука. Установите значение true для воспроизведения со звуком.

ORDINAL_VIEW_COUNT_KEY

null

Если вы получаете отчеты о порядковых данных из Vungle, используйте это поле, чтобы передать порядковый номер посредника. Это целое число, указывающее порядок, в котором это рекламное объявление было показано в игровом сеансе (например, если два объявления уже были показаны в этом сеансе, и это рекламное объявление из Vungle было показано третьим, передайте «3»). Подробнее об порядковых данных см. здесь.

FLEX_VIEW_CLOSE_TIME_KEY

null

Это количество времени в секундах, в течение которого будут воспроизводиться видео Flex View перед автоматическим закрытием.

Пример

private Map<String, Object> getLocalExtras() { HashMap<String, Object> extras = new HashMap<>(); extras.put(VungleInterstitial.SOUND_ENABLED_KEY, mPreferences.getBoolean(SettingsActivity.KEY_PREF_SOUND_ENABLED, true)); extras.put(VungleInterstitial.ORDINAL_VIEW_COUNT_KEY, Util.parseInt(mPreferences.getString(SettingsActivity.KEY_PREF_PREF_KEY_ORDINAL, "3"), 0)); return extras;

Реклама с вознаграждением

Атрибут

Значение по умолчанию

Описание

withUserId

null

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

withCancelDialogBody

«Ранее закрытие этого видео не позволит вам заработать вознаграждение. Вы уверены?»

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

withCancelDialogCloseButton

«Закрыть видео»

Задает текст «кнопки отмены» в диалоговом окне подтверждения при пропуске стимулированной рекламы.

withCancelDialogKeepWatchingButton

«Продолжить просмотр»

Задает текст «кнопки продолжения просмотра» в диалоговом окне подтверждения при пропуске стимулированной рекламы.

withCancelDialogTitle

«Закрыть видео?»

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

withSoundEnabled

true

Задает начальное состояние звука для рекламного объявления. Если указано true, используются громкость устройства и настройки звука. Если указано false, видео начинает воспроизводиться с отключенным звуком, но пользователь может это изменить.

withOrdinalViewCount

null

Если вы получаете отчеты о порядковых данных из Vungle, используйте это поле, чтобы передать порядковый номер посредника. Это целое число, указывающее порядок, в котором это рекламное объявление было показано в игровом сеансе (например, если два объявления уже были показаны в этом сеансе, и это рекламное объявление из Vungle было показано третьим, передайте «3»). Подробнее об порядковых данных см. здесь.

Пример

private VungleMediationSettings getSettings() { return new VungleMediationSettings.Builder() .withUserId(mPreferences.getString(SettingsActivity.KEY_PREF_USER_ID, "user")) .withCancelDialogBody(mPreferences.getString(SettingsActivity.KEY_PREF_CANCEL_BODY, "")) .withCancelDialogCloseButton(mPreferences.getString(SettingsActivity.KEY_PREF_CANCEL_CLOSE, "")) .withFlexViewCloseTimeInSec(Util.parseInt(mPreferences.getString(SettingsActivity.KEY_PREF_PREF_KEY_FLEXVIEW_CLOSE_TIME, "5"), 0)) .withCancelDialogKeepWatchingButton(mPreferences.getString(SettingsActivity.KEY_PREF_CANCEL_KEEP, "")) .withCancelDialogTitle(mPreferences.getString(SettingsActivity.KEY_PREF_CANCEL_TITLE, "")) .withSoundEnabled(mPreferences.getBoolean(SettingsActivity.KEY_PREF_SOUND_ENABLED, true)) .withOrdinalViewCount(Util.parseInt(mPreferences.getString(SettingsActivity.KEY_PREF_PREF_KEY_ORDINAL, "13"), 0)) .build(); }
Была ли эта статья полезной?
Пользователи, считающие этот материал полезным: 0 из 0
Еще есть вопросы? Отправить запрос

Комментарии