Руководство по быстрому старту для агрегатора AdMob + Vungle SDK v.1.0-v.4.1 (Android)

Это руководство поможет вам быстро добавить Vungle Android SDK в слой агрегатора AdMob. Для подключения Vungle к агрегатору AdMob требуется интеграция адаптера Vungle, который обеспечивает взаимодействие между AdMob SDK и Vungle SDK.

Contents

1. Прежде чем начинать...

2. Добавление приложения в панель управления AdMob

3. Интеграция AdMob SDK в проект для Android

4. Интеграция адаптера Vungle и SDK в проект для Android

5. Vungle теперь подключен к агрегатору AdMob

6. Дополнительные возможности (необязательно): указание дополнительных параметров

1. Прежде чем начинать...

  • Прежде чем приступать к выполнению действий, описанных в этом руководстве, необходимо настроить AdMob. Для начала создайте учетную запись AdMob.
  • Адаптер Vungle AdMob для Android поддерживает размещение как межстраничной рекламы (interstitial), так и межстраничных видео с вознаграждением (rewarded video).

    • Межстраничная видеореклама воспроизводится автоматически в выбранной точке размещения. В терминологии Vungle это называется «реклама без стимуляции» (non-incentivized ads).
    • Видео с вознаграждением воспроизводится по желанию пользователя. В обмен на просмотр такого видео пользователь получает некое вознаграждение. В терминологии Vungle это называется «стимулированная реклама» (incentivized ads).

  • Перейдите в панель управления Vungle и добавьте приложение в свою учетную запись, если вы этого еще не сделали. Это обязательно для получения идентификатора приложения (Vungle Application ID). Идентификатор будет использоваться для инициализации Vungle в AdMob.

2. Добавление приложения в панель управления AdMob

  1. Войдите в панель управления AdMob и нажмите кнопку «+ Монетизировать новое приложение».

  2. На Шаге 1 — «Выберите приложение» нажмите «Найти приложение», если ваше приложение уже размещено в магазине Google Play. Если вы добавляете приложение вручную, убедитесь, что в пункте «Платформа» выбран вариант «Android».

  3. На Шаге 2 — «Выберите формат объявлений и укажите название рекламного блока»:

    • Для межстраничного объявления выберите опцию «Видео», поскольку вся реклама Vungle принадлежит к этой категории.



    • Для межстраничного объявления с вознаграждением выберите опцию «Настройки вознаграждений» и заполните поля «Количество бонусных предметов» и «Бонусный предмет». Vungle не поддерживает функцию «Использование настроек внешней рекламной сети».

  4. Добавив приложение, следуйте указаниям в этом руководстве, чтобы добавить Vungle в качестве рекламной сети:

    • Нажмите кнопку «+ Новая рекламная сеть» и выберите в левой панели Vungle. Найдите идентификатор приложения (Vungle Application ID) в панели управления Vungle (Vungle использует единый идентификатор как для простой межстраничной рекламы, так и для межстраничной рекламы с вознаграждением).

    • В пункте «Оптимизация рекламной сети (необязательно)» введите ключ API просмотра отчетности (Reporting API key), чтобы предоставить AdMob доступ к eCPM через API просмотра отчетности Vungle (если у вас нет ключа, см. справку «How can I request a Reporting API key?» («Как запросить ключ API просмотра отчетности?»).)

3. Интеграция адаптера Vungle и SDK в проект для Android

Следуйте указаниям в руководстве AdMob «Get Started in Android Studio» («Начало работы в Android Studio») для интеграции AdMob SDK в свой проект для Android. Затем воспользуйтесь руководством AdMob «Interstitial Ads» («Межстраничные объявления») и/или руководством «Rewarded Ads: Publishers Get Started» («Объявления с вознаграждением: начало работы для издателей») для получения и отображения рекламы.

4. Интеграция адаптера Vungle и SDK в проект для Android

  1. Скачайте адаптер Vungle AdMob
  2. Скачайте Vungle SDK для Android
  3. Добавьте адаптер Vungle AdMob (один файл «.aar») и Vungle SDK (три файла «.jar») в библиотеку проекта:



  4. Обновите файл build.gradle:
    dependencies {
    compile fileTree(dir: 'libs', include: ['*.jar']) // Vungle SDK
    compile(name:'VungleAdapter', 'ext':'aar') // Vungle Adapter for AdMob
    }
    repositories {
    jcenter()
    flatDir {
    dirs 'libs'
    }
    }
  5. Обновите файл AndroidManifest.xml для разрешений и действий Vungle:

    <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>

5. Vungle теперь подключен к агрегатору AdMob

Vungle теперь будет входить в стандартный поток агрегатора AdMob наряду с другими выбранными рекламными сетями. После этого остается только протестировать интеграцию, разместить приложение и выйти из тестового режима в Vungle и AdMob, чтобы начать работу!

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

* Обратите внимание: обратный вызов onAdLeftApplication() не производится, если пользователь нажал на объявлении и был открыт браузер/магазин приложений.

6. Дополнительные возможности (необязательно): указание дополнительных параметров

SDK для Android v4.0.3 и адаптер AdMob v2.1.0 поддерживают дополнительные параметры.

Метод

Описание

setUserId

Настраивает передачу уникального пользовательского идентификатора в Vungle SDK для использования в обратных вызовах «сервер-сервер» для рекламы с вознаграждением.

setSoundEnabled

Настраивает начальное состояние звука для объявления. Если задано значение «false», видео запускается без звука, но пользователь может включить его вручную.

Образец кода для интеграции:


// build network extras bundle
Bundle extras = new VungleExtrasBuilder()
.setUserId("userId")
.setSoundEnabled(false)
.build();
// build request for reward-based ads
AdRequest rewardedAdRequest = new AdRequest.Builder()
.addNetworkExtrasBundle(VungleAdapter.class, extras)
.build();
rewardedAd.loadAd(REWARDED_AD_UNIT_ID, rewardedAdRequest);
// or for interstitial ads
AdRequest interstitialAdRequest = new AdRequest.Builder()
.addNetworkExtrasBundle(VungleInterstitialAdapter.class, extras)
.build();
// load ad
interstitialAd.loadAd(interstitialAdRequest);
Была ли эта статья полезной?
Пользователи, считающие этот материал полезным: 0 из 1
Еще есть вопросы? Отправить запрос

Комментарии