Краткое руководство по началу работы с MoPub + Vungle SDK v.5.1+ (Android)

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

Содержание

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

  • Пакет Vungle SDK для 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 и на главной навигационной панели выберите раздел Networks​ (Сети).

  2. Нажмите кнопку Add a Network​… (Добавить сеть)

    image4.png

    и выберите элемент Custom Native Network​ (Пользовательская нативная сеть) внизу страницы.

    image1.png
  1. В разделе Set Up Your Inventory (Настройка принадлежностей) выполните указанные ниже действия для каждого рекламного блока, в котором для показа видеорекламы будет использоваться Vungle SDK. Это позволит пакету MoPub SDK найти сетевой адаптер для взаимодействия с пакетом Vungle SDK.

    image2.png

    • Если для рекламного блока используется формат MoPub Rewarded Video​ (Видео с вознаграждением), добавьте mopub.mobileads.VungleRewardedVideo в раздел Custom Event Class​ (Класс пользовательских событий).

    • Если для рекламного блока используется формат Fullscreen (Interstitial)​ (Полноэкранная рекламная вставка), добавьте mopub.mobileads.VungleInterstitial в раздел Custom Event Class​ (Класс пользовательских событий).

    • Добавьте также идентификатор приложения Vungle App ID​, идентификатор размещения Reference ID​ и идентификаторы всех размещений Reference IDs​ в формате JSON в раздел Custom Event Class Data​ (Данные классов пользовательских событий).

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

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

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

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

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

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

    • VungleInterstitial.java
    • VungleRewardedVideo.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.)
Была ли эта статья полезной?
Пользователи, считающие этот материал полезным: 0 из 0
Еще есть вопросы? Отправить запрос

Комментарии