Руководство по быстрому запуску сервиса MoPub + Vungle (iOS)

Это руководство поможет быстро добавить SDK для iOS в типовое приложение в случае, когда в качестве главной рекламной сети-посредника установлена MoPub.

Несколько замечаний перед началом работы...

• Перед тем как приступить к работе с инструкцией, в приложение следует установить MoPub.  По шагам этот процесс разобран в Руководстве по началу работы с MoPub в iOS
• В этом учебном пособии будут использоваться предварительно собранные адаптеры MoPub, перечисленные в Руководстве по рекламе третьих сторон с интеграцией MoPub
• Как только Vungle будет интегрирована, можно будет показывать рекламу через InterstitialAdController MoPub.  Подробная информация по использованию этого контроллера приведена в Руководстве по интеграции вставок MoPub для iOS

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

Теперь начнем.  Все делается за два шага: 

Выбираем Vungle пользовательской нативной сетью (Custom Native Network)

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

• Войдя на панель управления MoPub, откройте на главной навигационной панели раздел Networks («Сети»)
• Нажмите кнопку Add a Network («Добавить сеть») и выберите в нижней части страницы Custom Native Network («Пользовательская нативная сеть»)

В разделе Set Up Your Inventory («Настройка принадлежностей») для каждой рекламной единицы, в которой для показа видеорекламы будет использоваться Vungle SDK, необходимо проделать следующее.

• Обеспечение SDK MoPub возможности найти сетевой адаптер, который ранее использовался для взаимодействия с SDK Vungle:
  - При использовании стимулированной рекламы добавьте класс пользовательского события VungleRewardedVideoCustomEvent.
  - При использовании рекламных вставок добавьте класс пользовательского события VungleInterstitialCustomEvent.

• Также следует добавить идентификатор приложения Vungle в формате JSON в раздел данных классов пользовательских событий (Custom Event Class Data), например { “appId” : “Test_iOS” }

Добавляем Vungle как рекламную сеть третьей стороны

Для добавления SDK Vungle для iOS в приложение с помощью посредничества MoPub проделайте следующее.

1. Добавьте все связанные с Vungle файлы адаптеров (из папки /AdNetworkSupport/Vungle/ в SDK MoPUb) в проект приложения и убедитесь, что они включены в источники компиляции приложения (Build Phases > Compile Sources).

   MPInstanceProvider+Vungle.h
   MPInstanceProvider+Vungle.m			
   MPVungleRouter.h
   MPVungleRouter.m	
   VungleInstanceMediationSettings.h
   VungleInstanceMediationSettings.m
   VungleInterstitialCustomEvent.h
   VungleInterstitialCustomEvent.m
   VungleRewardedVideoCustomEvent.h
   VungleRewardedVideoCustomEvent.m
   

2. Загрузите SDK Vungle для iOS и скопируйте папку VungleSDK.embeddedframework в папку /AdNetworkSupport/Vungle/SDK/.
   
   
   • Убедитесь, что в путях поиска фреймворков (Build Settings > Framework Search Path) содержится VungleSDK.embeddedframework (как пример: $(PROJECT_DIR)/AdNetworkSupport/Vungle/SDK/VungleSDK.embeddedframework)
     
     
   • Убедитесь, что VungleSDK.embeddedframework включен в раздел линковки двоичного кода проекта с библиотеками Build Phases > Link Binary With Libraries.
     
     
3. Добавьте необходимые фреймворки в соответствии с указаниями раздела «Добавляем прочие необходимые фреймворки» руководства «Начало работы с Vungle (iOS)».
   
   
4. Добавьте флаг линковщика в соответствии с указаниями раздела «Добавляем флаг линковщика ObjC» руководства «Начало работы с Vungle (iOS)».
   
   
5. Удалите строку состояния в соответствии с указаниями раздела «Удаляем строку состояния» руководства «Начало работы с Vungle (iOS)».
   
   
6. Добавьте исключение ATS в соответствии с указаниями раздела «Application Transport Security (ATS)» руководства «Начало работы с Vungle (iOS)».
   
   
   • Vungle рекомендует сохранить этот параметр до конца 2016 г. Начиная с 1 января 2017 г. для Vungle больше не будет требоваться настройка данного исключения.
     
     
   • Требования MoPub см. в разделе «Настройки App Transport Security» документа «Начало работы с MoPub».
     
     
7. Вызовите принадлежащий MPInterstitialAdController метод showFromViewController (или, для стимулированной рекламы, принадлежащий MPRewardedVideo метод presentRewardedVideoAdForAdUnitID), когда захотите показать видеорекламу Vungle! (Вызывать методы SDK Vungle для iOS напрямую нет необходимости. Это сделает SDK MoPub.)

Подробную информацию по установке контроллера рекламных вставок MoPub см. в Руководстве по интеграции вставок MoPub для iOS. 

Вот и все! Теперь Vungle будет ротироваться через стандартный водопад показа рекламы MoPub.  Если требуется вручную задать eCPM для управления позициями в водопаде, это можно сделать на странице MoPub Segment Detail («Подробности сегмента») на панели управления MoPub.

Более подробную информацию об интеграции MoPub с Vungle см. в центре поддержки MoPub.