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

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

Содержание

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

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

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

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

  2. Нажмите кнопку Новая сеть в правом верхнем углу.

    Screen_Shot_2018-05-08_at_2.53.52_PM.png

    и выберите в списке Vungle.

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

    Screen_Shot_2018-05-08_at_3.03.03_PM.png

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

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

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

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

      .
    • На панели управления Vungle привяжите размещение, которому присвоен тип с вознаграждением, к рекламному блоку MoPub формата «Видео с вознаграждением», а размещение, которому присвоен тип рекламная вставка, — к рекламному блоку MoPub полноэкранного формата (320 x 480).
      { "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 перед автоматическим закрытием.

Пример

 ashMap<String, Object> extras = new HashMap<>(); extras.put(VungleInterstitial.SOUND_ENABLED_KEY, false); extras.put(VungleInterstitial.ORDINAL_VIEW_COUNT_KEY, 1); extras.put(VungleInterstitial.FLEX_VIEW_CLOSE_TIME_KEY, 5); mMoPubInterstitial.setLocalExtras(extras); mMoPubInterstitial.load(); 

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

Атрибут

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

Описание

withUserId

null

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

withCancelDialogBody

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

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

withCancelDialogCloseButton

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

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

withCancelDialogKeepWatchingButton

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

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

withCancelDialogTitle

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

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

withSoundEnabled

true

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

withOrdinalViewCount

null

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

Пример

 public class MainActivity extends Activity { @Override MoPubRewardedVideos.initializeRewardedVideo(this, new VungleRewardedVideo.VungleMediationSettings.Builder() .withUserId("VUNGLE_TEST_USER") .withCancelDialogTitle("TITLE") .withCancelDialogBody("BODY") .withCancelDialogCloseButton("CLOSE") .withCancelDialogKeepWatchingButton("CONTINUE") .withSoundEnabled(false) .withOrdinalViewCount(10) .build() ); MoPub.onCreate(this); // ... } 

Дополнительное примечание

Android SDK - аппаратное ускорение

Аппаратное ускорение включено по умолчанию, если ваше целевой уровень API имеет значение 14 или выше. Этот параметр должен быть включен, чтобы SDK правильно отображал рекламу с динамическим шаблоном и Native Flex. Убедитесь, что этот параметр не имеет значение false в вашем проекте.

 < application android:hardwareAccelerated="true" ... > 

 

Была ли эта статья полезной?
Пользователи, считающие этот материал полезным: 0 из 0
Еще есть вопросы? Отправить запрос

Комментарии