Начало работы с пакетом SDK Vungle для Android

Это руководство поможет вам без лишних усилий интегрировать наш пакет SDK в приложение, чтобы оно приносило доход! Новый пакет SDK 4.0.3 Vungle для Android поддерживает Android Nougat (API 7.0) с многооконным режимом и улучшенным воспроизведением рекламных видеороликов. Если вы переходите на новые версии SDK, изучите Руководство по переходу.

Содержание

Прежде чем приступить к работе...
1. Загрузите пакет SDK
2. Добавьте SDK Vungle в проект
3. Обновите AndroidManifest.xml 
4. Инициализируйте и интегрируйте пакет SDK
5. Воспроизвести объявление!

Прежде чем приступить к работе...

Требования

  • Android 3.0 (Honeycomb — версия API 11) или выше
  • Если ваше приложение написано на C/C++, вам необходимо использовать JNI для взаимодействия с пакетом Publisher SDK, написанном на Java
  • Java 1.7 — в целях совместимости с Android 5.+ в системе разработки требуется наличие JDK 7
  • Java 1.8 — в целях совместимости с Android 7.+ в системе разработки требуется наличие JDK 8

Ниже приведены несколько важных советов:

  • Если вы этого еще не сделали, выполните наше пошаговое руководство для добавления вашего приложения на панель управления Vungle. Затем запишите идентификатор приложения, указанный на странице приложения. Нам понадобится этот идентификатор приложения для последующей инициализации пакета Vungle Android SDK.

  • Если вы просто хотите приступить к работе с нашим образцовым приложением, просмотрите нашу папку sample на ресурсе GitHub. Если нет, читайте статью дальше. Вам потребуется выполнить всего пять шагов.

1. Загрузите пакет SDK

Пакет Vungle Android SKD доступен для загрузки с панели управления Vungle. После окончания загрузки извлеките архив.

2. Добавьте пакет Vungle SDK в ваш проект

Скопируйте все библиотеки из извлеченного каталога /libs в каталог /libs проекта. Если этого каталога нет в проекте, создайте его. Это автоматически добавит библиотеки в Gradle-зависимости вашего проекта.

Пакету SDK Vungle для Android требуются следующие библиотеки:

  • dagger-[version].jar
  • javax.inject-[version].jar
  • vungle-publisher-[version].jar

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

3. Обновите AndroidManifest.xml

Добавьте следующие строки в файл AndroidManifest.xml:

<manifest>

...
<!-- разрешения на загрузку и кэширование видеообъявлений для последующего воспроизведения -->
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" android:maxSdkVersion="18"/>
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<application>

...
<!-- Требуются действия для воспроизведения видеообъявлений Vungle -->
 <activity android:name="com.vungle.publisher.VideoFullScreenAdActivity"
android:configChanges="keyboardHidden|orientation|screenSize|screenLayout|smallestScreenSize"
android:theme="@android:style/Theme.NoTitleBar.Fullscreen"/>

<activity android:name="com.vungle.publisher.MraidFullScreenAdActivity"
android:configChanges="keyboardHidden|orientation|screenSize|screenLayout|smallestScreenSize"
android:theme="@android:style/Theme.Translucent.NoTitleBar.Fullscreen"/>

</application>

</manifest>

 

4. Инициализируйте и интегрируйте пакет SDK

Запуск приложения

Инициализируйте пакет Publisher SDK в первом классе Activity приложения. Это начнет предварительное кэширование видео и подготовит SDK для отображения объявлений.

import com.vungle.publisher.VunglePub;

public class FirstActivity extends android.app.Activity {

  // получение экземпляра VunglePub
  final VunglePub vunglePub = VunglePub.getInstance();

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

      // получите идентификатор приложения с основной страницы приложения на панели управления Vungle после настройки вашего приложения
      final String app_id = "идентификатор вашего приложения Vungle";

      // инициализация пакета Publisher SDK
      vunglePub.init(this, app_id);
  }
}

Каждый класс Activity

Кроме того, переопределите методы onPause и onResume в каждом классе Activity (включая первый), чтобы пакет Vungle Android SDK надлежащим образом обновлялся при получении фокуса приложением или при потере фокуса:

import com.vungle.publisher.VunglePub;

public class EachActivity extends android.app.Activity {

  // получение экземпляра VunglePub
  final VunglePub vunglePub = VunglePub.getInstance();

  ...

  @Override
  protected void onPause() {
      super.onPause();
      vunglePub.onPause();
  }

  @Override
  protected void onResume() {
      super.onResume();
      vunglePub.onResume();
  }
}

5. Воспроизвести объявление!

Конфигурация по умолчанию

Почти все готово! Когда вы готовы воспроизвести объявление в вашем приложении, просто вызовите метод playAd в пакете Android SDK

import com.vungle.publisher.VunglePub;

public class GameActivity extends android.app.Activity {

  // получение экземпляра VunglePub
  final VunglePub vunglePub = VunglePub.getInstance();

  ...

  private void onLevelComplete() {
      vunglePub.playAd();
  }
}

Совет 1 — О подписке на события воспроизведения см. в Руководстве по дополнительным параметрам. С помощью этих событий можно снимать воспроизведение звука с паузы, возобновлять игру и т. д.

Совет 2 — Если вы хотите посмотреть, доступно ли объявление перед воспроизведением, используйте следующее:

// указывает, готово ли объявление к воспроизведению
vunglePub.isAdPlayable()

ПРИМЕЧАНИЕ. Когда приложение находится в режиме тестирования, скачивать рекламируемые приложения нельзя. Кроме того, в панели управления невозможно будет просмотреть количество нажатий. Это связано с тем, что тестовая реклама предназначена только для проверки правильности интеграции SDK. Эти функциональные возможности станут доступны после запуска приложения в активном режиме.

Сервисы Google Play (дополнительно)

Включение сервисов Google Play в ваш проект позволит Vungle обеспечить более органичное взаимодействие пользователя с объявлением, однако это не является обязательным. Мы рекомендуем использовать версию 4.0.30 и выше.

О том, как добавить сервисы Google Play, см. в Руководстве по настройке Google. В вашем приложении следует убедиться, что устройство имеет достаточно актуальную версию сервисов Google Play.

Дополнительные вопросы о сервисах Google Play см. в некоторых наших часто задаваемых вопросах о сервисах Google Play.

Для пакета Android SDK версии 3.3.5 и выше:

Если вы используете play-services 7.8.0:

  • включите play-services-ads
  • включите play-services-location
  • сохраните библиотеку поддержки

Если вы используете play-services 8.4.0:

  • включите play-services-ads
  • включите play-services-location
  • библиотека поддержки НЕ является обязательной

Вот и все! Скоро приложение начнет приносить доход!

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

Если вы хотите узнать подробнее о Vungle Android SDK (о персональной настройке, прослушивателях событий и т. д.), ознакомьтесь с Руководством по дополнительным параметрам.

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

Комментарии