Начало работы с Vungle (SDK v.1.0 – v.4.1): подключаемый модуль Marmalade

Используйте это руководство, чтобы быстро интегрировать подключаемый модуль Marmalade для Vungle в базовый пример приложения. Приведенный здесь код доступен в нашем публичном репозитории на GitHub.

Содержание

  1. Перед началом работы
  2. Устанавливаем подключаемый модуль Marmalade для Vungle
  3. Добавляем код!

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

  1. Для подключаемого модуля Marmalade для Vungle требуется Marmalade 8.0.0 или более поздней версии.
  2. Реклама Vungle в выпусках Windows N и KN. Чтобы реклама Vungle запускалась в особых выпусках Windows N и KN, их пользователям следует установить пакет мультимедиа (Media feature pack) для выпусков Windows 10 N и KN.
  3. Интеграция требует учетной записи Vungle, поэтому создайте учетную запись Vungle, если у вас ее нет.
  4. Если вы этого еще не сделали, перейдите на панель управления и добавьте приложение в свою учетную запись. Это необходимо для того, чтобы получить идентификатор приложения, который вы добавите в приложение с помощью нашего SDK. Он находится на странице вашего приложения.
  5. Подключаемый модуль Marmalade для Vungle не включен в пример кода, ссылка на который приводится выше, поэтому вы должны его загрузить из панели управления Vungle. Когда загрузка будет завершена...

Устанавливаем подключаемый модуль Marmalade для Vungle

Добавьте ссылку на подключаемый модуль Marmalade для Vungle в MKB-файл вашего проекта. Чтобы сделать это, откройте MKB-файл проекта в текстовом редакторе и добавьте следующую строку в конце этого файла:

subproject <path_to_the_Vungle_Marmalade_Plugin_directory>/VungleSDK

Пример:

subproject ../publisher-marmalade-plugin/VungleSDK

Добавляем код!

В этом пошаговом руководстве мы собираемся инициализировать весь наш код, связанный с Vungle. Мы рекомендуем, чтобы вы инициализировали подключаемый модуль Marmalade для Vungle как можно раньше, чтобы включенные пакеты Vungle SDK вовремя завершили настройку показа пользователю рекламы при вызове метода 'playAd'.

Инициализация

Инициализация — это всего одна строка кода. Этот метод подготавливает подключаемый модуль Marmalade для Vungle к выводу на экран объявлений. Его необходимо вызвать только один раз. Постарайтесь инициализировать пакет Vungle SDK в приложении как можно раньше, поскольку для инициализации пакета SDK и загрузки в кэш объявления для воспроизведения требуется 30–45 секунд:

#include "VungleSDK.h"
//...
int main()
{
    //Идентификаторы приложений можно найти на панели управления Vungle, на страницах приложений
    VungleInit("Test_Android", "Test_iOS", "Test_Windows");
}

Показ рекламы

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

//Коротко и просто!
VunglePlayAd();

Метод VunglePlayAdWithOptions может принимать словарь параметров, позволяющий настроить показ рекламы:

// Показывает рекламу с дополнительными параметрами. Используйте структуру VungleSDKPlayOption для задания параметров.
VungleSDKPlayOption* opts = new VungleSDKPlayOption();
VunglePlayAdWithOptions(opts); 

Структура параметров содержит следующие поля:

Ключ Описание
incentivized Вы можете получать уведомления в случае, если пользователь просмотрел рекламу целиком. Стандартный сценарий использования этого ключа — некоторый обмен выгодами («Посмотрите это видео и получите 100 бонусов!»). При объявлении рекламы стимулированной на ваш сервер будет отправлено сообщение с предоставленным вами идентификатором пользователя, чтобы вы могли его наградить. YES означает, что объявление становится объявлением с поощрением. См. указания по настройке стимулированной рекламы.
orientation

Задает ориентацию рекламы.

  • 0 – автоповорот (Windows, iOS, android)
  • 1 – альбомная (Windows, iOS), в соответствии с видео (android)
  • 2 – книжная (Windows, iOS)
userTag Пользователь ключа — передается в качестве пользователя в вызове S2S (при его наличии).
placement Метаданные с информацией о размещении отдельного рекламного показа.  Используется для фильтрации показов рекламы при запросе данных отчетности по производительности приложения.
alertTitle Заголовок предупреждения, которое появляется при преждевременном закрытии стимулированной рекламы пользователем.
alertText Текст предупреждения, которое появляется при преждевременном закрытии стимулированной рекламы пользователем.
alertCloseText Надпись на кнопке, закрывающей окно предупреждения, которое появляется при преждевременном закрытии стимулированной рекламы пользователем.
alertContinueText Надпись на кнопке, закрывающей окно предупреждения, которое появляется при преждевременном закрытии стимулированной рекламы пользователем.
key1..8 Здесь собраны восемь ключей.
 

Обработка событий

Подключаемый модуль Marmalade для Vungle позволяет создать для приложения подписку на 5 события, связанные с показом рекламы.

  • VUNGLESDK_CALLBACK_ADPLAYABLECHANGED — срабатывает, когда реклама Vungle готова к показу
  • VUNGLESDK_CALLBACK_ADSTART — срабатывает при начале показа рекламы Vungle
  • VUNGLESDK_CALLBACK_ADEND — вызывается, когда пользователь закрывает объявление и управление возвращается в приложение / игру
  • VUNGLESDK_CALLBACK_VIDEOVIEW - срабатывает после окончания каждого показа рекламы
  • VUNGLESDK_CALLBACK_LOG — срабатывает, когда пакет SDK отправляет событие журнала

Функции обратного вызова имеют по два параметра типа void*. Первый параметр связан с дополнительной информацией о событии.

Обратный вызов Тип Описание
ADPLAYABLECHANGED bool Если значение равно true, вы можете сейчас воспроизвести объявление
ADSTART  
ADEND bool True, если пользователь нажал кнопку «Загрузить» для перехода в магазин
VIDEOVIEW VungleSDKAdViewInfo*

struct VungleSDKAdViewInfo
{
bool IsCompletedView; // этот параметр имеет значение true, если просмотрено не менее 80 % видео
int VideoDuration; // общая длительность объявления Vungle в миллисекундах
int WatchedDuration; // просмотренное время объявления Vungle в миллисекундах
};

LOG const char* Сообщение для журнала

Создать подписку на эти события легко. Добавление прослушивателя событий выглядит следующим образом:

int32 OnAdPlayableChanged(void* systemData, void* userData) {
    bool adPlayble = (bool)systemData;
    if (adPlayble){
        // Объявление готово к показу!
    }else{
        // В данный момент готовые объявления отсутствуют.
    }
    return 0;
}
 
int main()
{
    VungleSDKRegister(VUNGLESDK_CALLBACK_ADPLAYABLECHANGED, (s3eCallback)OnAdPlayableChanged, (void*)NULL);
}

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

Вот и все! Дополнительные сведения о подключаемых модулях Marmalade Vungle см. в других наших статьях о подключаемых модулях и в исходном коде нашего примера приложения для Marmalade.

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

Комментарии