Перед началом работы
Требования
Подключаемый модуль Vungle для Unity поддерживает версии редактора Unity, начиная с 2017, и содержит следующие версии пакета SDK Vungle.
Пакет SDK для версии iOS 6.8.0
- iOS 9 или более позднюю версию
Пакет SDK для версии Android 6.8.0
- Android 4.0 (Ice Cream Sandwich — версия API 14 или более поздняя)
- Amazon OS 5.4 или более поздней версии
- Требует Java 1.7 или более позднюю версию для Android
Пакет SDK для Windows версии 6.8.0
- Windows 10 UWP и Universal 8.1
Загрузить подключаемый модуль
Скачайте подключаемый модуль Vungle для Unity здесь: https://publisher.vungle.com/sdk/plugins/unity
Ссылка: пример приложения
При осуществлении интеграции обращайтесь к примеру приложения, который мы предоставили: https://github.com/Vungle/Unity-Plugin
Шаг 1. Настройте ваш проект в Unity с подключаемым модулем Vungle Unity
Добавьте подключаемый модуль Vungle Unity к вашему проекту в Unity
Откройте свой проект в Unity и дважды щелкните скачанный файл VunglePlugin.unitypackage, чтобы добавить подключаемый модуль Vungle Unity в ваше приложение. Когда откроется окно Импорт пакета Unity, нажмите кнопку Все, чтобы выбрать все элементы перед импортом.
Указание правильной платформы в параметрах сборки
Во избежание ошибок компиляции при выполнении следующего шага убедитесь, что параметры сборки вашего проекта (cmd + Shift + B) рассчитаны на платформу iOS, Android или Universal Windows.
Amazon Appstore
Пакет SDK Vungle Android поддерживает Amazon OS 5.4 и более поздние версии. Вы можете отправить пакет приложения для Android (APK) в магазин Amazon Appstore с дополнительной настройкой конфигурации Unity Amazon Appstore. Обратитесь к Инструкциям для Unity.
Сервисы Google Play
Включение сервисов Google Play в ваш проект позволяет Vungle обеспечить более органичный процесс работы пользователя с рекламным объявлением, но не является обязательным. Мы рекомендуем использовать версию 16.0.0 или более поздние.
Чтобы добавить сервисы Google Play, мы рекомендуем обратиться к руководству по настройке Google, доступному на портале разработчика. В вашем приложении следует убедиться, что на устройстве имеется достаточно новая версия сервисов Google Play.
Зависимости Android
Использование пакета SDK Vungle для Android требует, чтобы вы включили одну из следующих зависимостей в вашу сборку. Либо добавьте их вручную, либо включите в шаблон Gradle, если вы используете Gradle.
implementation 'androidx.appcompat:appcompat:1.2.0'
// When appcompat is not used, core and localbroadcastmanager can be used instead
// implementation "androidx.core:core:1.3.1"
// implementation "androidx.localbroadcastmanager:localbroadcastmanager:1.0.0"Добавьте hardwareAccelerated для Android (Unity 2018.1 и более ранних версий)
hardwareAccelerated требуется для SDK Vungle, чтобы надлежащим образом отображать рекламные объявления типа MREC. Unity присваивает этому параметру значение false, даже если он был настроен на true в AndroidManifest.xml в рамках вашего проекта в Unity. Подключаемый модуль Vungle установит его на true, используя сценарий постпроцессора Gradle, доступный для 2018.2 и более поздних версий. Публикаторам, пользующимся 2018.1 и более ранними версиями, включая 2017, необходимо экспортировать проект в Android studio и добавить hardwareAccelerated конфигурацию со значением true.
Пример кода:
<application android:hardwareAccelerated="true" ...>Конфигурация проекта на платформе Universal Windows
Следуйте инструкциям из нашей статьи Подготовка подключаемого модуля Vungle Unity для SDK Windows, чтобы настроить конфигурацию проекта UWP.
Шаг 2. Добавление кода
В этом пошаговом руководстве мы инициализируем весь наш код, связанный с Vungle, в сценарии, прикрепленном к основному объекту игры Game Object. Подключаемый модуль Vungle Unity можно вызвать из любых сценариев, которые вы считаете подходящими.
Инициализация SDK
Инициализируйте пакет SDK при запуске приложения, чтобы осталось достаточно времени для кэширования рекламы. Для инициализации пакета SDK вам потребуются идентификаторы приложения для тех платформ, которые вы планируете использовать. Эти идентификаторы можно найти на информационной панели Vungle (обратитесь к разделу «Настройка размещений и отчетность»).
Для каждого приложения автоматически создается размещение по умолчанию. На данном шаге инициализации необходимо указать его идентификатор размещения, независимо от того, планируете ли вы использовать функциональные возможности размещений. Если вы создаете несколько размещений, укажите все идентификаторы размещений.
Пример кода:
public class VungleScript : MonoBehaviour {
string appID = "";
string iosAppID = "ios_app_id";
string androidAppID = "android_app_id";
string windowsAppID = "windows_app_id";
#if UNITY_IPHONE
appID = iosAppID;
#elif UNITY_ANDROID
appID = androidAppID;
#elif UNITY_WSA_10_0 || UNITY_WINRT_8_1 || UNITY_METRO
appID = windowsAppID;
#endif
Vungle.init(appID);
}После успешной инициализации пакета SDK он вызывает следующее событие:
public static event Action onInitializeEvent;Обратитесь к разделу обработки событий в статье , касающемуся выбранного вами формата рекламного объявления.
Свяжитесь с менеджером по работе с клиентами по поводу мест размещения, оптимизированных для кэширования, чтобы эффективность кэширования была максимальной.
После успешного кэширования рекламного объявления вызывается событие adPlayableEvent с идентификатором размещения, соответствующим вашему размещению. Обратитесь к статье , посвященной выбранному вами формату рекламного объявления , для получения более подробной информации.
Интегрируйте форматы рекламных объявлений
Выполните интеграцию вашего подключаемого модуля для каждого формата рекламного объявления, который вы планируете использовать в своем приложении. Следуйте нашим инструкциям по каждому формату рекламного объявления:
- Интегрируйте рекламные видеовставки и рекламные объявления с вознаграждением
- Интегрируйте рекламные баннеры и рекламные объявления в формате MREC
Выполните шаги по дополнительной адаптации ваших рекламных объявлений в соответствии со своими предпочтениями
Следуйте инструкциям из нашей статьи Расширенные настройки для отладки интеграции вашего приложения с дополнительными вариантами конфигурации, такими как реализация GDPR, CCPA и многими другими настройками.