Начало работы с пакетом SDK Vungle для iOS в. 1.0 - в. 4.1

Воспользуйтесь этим простым руководством, чтобы интегрировать наш SDK в свое приложение и начать монетизировать его! Приведенный здесь код доступен в нашем публичном репозитории на GitHub.

Содержание

Перед началом работы...
1. Добавляем фреймворк Vungle в проект Xcode
2. Удаляем строку состояния iOS
3. Application Transport Security (ATS)
4. Добавляем код
Дополнительные параметры

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

  • Этот SDK Vungle для iOS поддерживает только iOS 7+ (как 32-, так и 64-разрядные приложения)
  • Для встраивания SDK требуется учетная запись Vungle, поэтому если у вас ее еще нет — зарегистрируйтесь.
  • Последние версии SDK для iOS (начиная 4.0.8) выпускаются в расчете на среду разработки Xcode версии 8.0. Для полной интеграции убедитесь, что используете Xcode 8.0 или более поздней версии.
  • Если вы этого еще не сделали, перейдите на панель управления и добавьте это приложение в свою учетную запись. Это необходимо для того, чтобы получить идентификатор приложения, который вы добавите в приложение с помощью нашего SDK. К примеру, на этом изображении он обведен красным, а найти его можно на странице вашего приложения. В новых приложениях он может совпадать с идентификатором API отчетности. В уже существующих приложениях, созданных с помощью поиска, идентификатор приложения и идентификатор API отчетности могут различаться — это нормально. (Для обеспечения взаимодействия «ключ» API отчетности отображается на странице сведений учетной записи пользователя.)
 

Теперь начнем.   

SDK Vungle для iOS не включен в пример кода, на который дана ссылка. Загрузите его через панель управления Vungle, распакуйте архив и выполните следующее.

1. Добавляем фреймворк Vungle в проект Xcode

Добавить Vungle в проект Xcode можно двумя способами: с помощью Cocoapods или вручную.

Cocoapods

Если вы знакомы с Cocoapods, то можете быстро добавить Vungle в свой проект, добавив строку:

pod "VungleSDK-iOS"

в файл Podfile.  После этого запустится процесс pod install, и свежая версия SDK для iOS будет добавлена в ваш проект!  После этого можно переходить ко 2-му шагу данного руководства.

Интеграция вручную

1а. Добавляем в проект фреймворк VungleSDK.embeddedFramework

Найдите извлеченные файлы, а затем перетащите папку VungleSDK.embeddedFramework в Xcode, в раздел Frameworks.

ВАЖНО! Папку VungleSDK.embeddedframework следует добавлять как группу (желтая папка), а не как вспомогательный материал (синяя папка).

1б. Добавляем прочие требуемые фреймворки

SDK Vungle требует привязки к проекту нескольких других нативных фреймворков. Щелкните на проекте и перейдите к разделу:

General («Общее») > Linked Frameworks and Libraries («Привязанные фреймворки и библиотеки»)

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

  • AdSupport.framework
  • AudioToolbox.framework
  • AVFoundation.framework
  • CFNetwork.framework
  • CoreGraphics.framework
  • CoreMedia.framework
  • Foundation.framework
  • libz.dylib или libz.tbd
  • libsqlite3.dylib или libsqlite3.tbd
  • MediaPlayer.framework
  • QuartzCore.framework
  • StoreKit.framework
  • SystemConfiguration.framework
  • UIKit.framework
  • WebKit.framework

Также стоит убедиться, что в разделе Linked Frameworks and Libraries («Привязанные фреймворки и библиотеки») присутствует сам VungleSDK. Если на предыдущем шаге с перетаскиванием он не был привязан автоматически, это можно сделать вручную, нажав «+» и выбрав пункт Add Other («Добавить иное»).

1в. Добавляем флаг линковщика -ObjC

Его можно добавить, открыв пункт Build Settings («Параметры сборки») и добавив -ObjC в подраздел Other Linker Flags («Прочие флаги линковщика») раздела Linking («Линковка»)

 

2. Удаляем строку состояния iOS

Этот не обязательный, но рекомендуемый шаг, поскольку отсутствие строки состояния способствует отсутствию помех при показе рекламы Vungle и взаимодействии с ней. Для удаления строки состояния откройте Info.pList, добавьте ключ View controller-based status bar appearance и установите для него значение No.

3. Application Transport Security (ATS)

Начиная с iOS 9 (со сборками, сделанными в Xcode 7) Application Transport Security требует, чтобы весь сетевой трафик приложения производился по протоколу HTTPS. Подробнее об этом можно прочитать в Руководстве по переводу Vungle на iOS 10. SDK Vungle для iOS полностью готов к использованию ATS. Весь трафик SDK Vungle будет использовать HTTPS с 1 января 2017 г. До этого предлагаем установить для параметра NSAllowsArbitraryLoads значение YES.

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

4а. Инициализируем SDK

Важно инициализировать SDK как можно скорее, чтобы реклама успела кэшироваться.  В нашем примере проекта (и это рекомендуется для всех проектов под iOS) инициализационный вызов добавляется в метод didFinishLaunchingWithOptions в главном AppDelegate.

ПРИМЕЧАНИЕ. Если при попытке импорта заголовочного файла VungleSDK.h тот не был найден, удалите ссылку и добавьте ее снова с опцией Copy items if needed («Копировать элементы по необходимости»).

  • AppDelegate.h:
#import <VungleSDK/VungleSDK.h>
  • AppDelegate.m : didFinishLaunchingWithOptions:
NSString* appID = @"Ваш_AppID";
VungleSDK* sdk = [VungleSDK sharedSDK];
// запуск библиотеки публикатора vungle
[sdk startWithAppId:appID];

4б. Запускаем рекламу в ViewControllers

Когда SDK уже инициализирован с помощью didFinishLaunchingWithOptions в AppDelegate, рекламу можно показать пользователю, добавив следующий фрагмент кода в верхний ViewController

ПРИМЕЧАНИЕ. Метод startWithAppId следует вызывать только один раз. Повторные вызовы могут привести к неопределенному поведению.

4в. Показываем рекламу в верхнем классе ViewController

  • #import <VungleSDK/VungleSDK.h>
    
    ...
    VungleSDK* sdk = [VungleSDK sharedSDK];
    NSError *error;
    [sdk playAd:self error:&error];
    

    Если при показе рекламы произошла ошибка, информация о ней будет включена в параметр NSError.

ПРИМЕЧАНИЕ. ViewController для метода playAd должен быть самым верхним ViewController в иерархии просмотра, в противном случае будет иметь место неопределенное поведение.

4г. Возобновляем воспроизведение звука

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

ПРИМЕЧАНИЯ:

  • Режим тестирования. В режиме тестирования скачивать рекламируемые приложения нельзя. Кроме того, на панели управления невозможно будет просмотреть количество показов. Это связано с тем, что тестовая реклама предназначена только для проверки правильности интеграции SDK. Эти функциональные возможности станут доступны после запуска приложения в активном режиме.

  • Кнопка повтора. В версиях SDK Vungle для iOS старше 4.0.x удалена кнопка Replay («Повторить»). Если даже эта кнопка останется в рекламе, работать она больше не будет.

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

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

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

Комментарии