Бегун. Реклама в мобильных приложениях

Реклама «Бегуна» в Android-приложениях




Введение

Рекламу «Бегуна» можно внедрять в приложения для устройств под управлением Android. Любой разработчик может добавить рекламный блок, воспользовавшись нашим SDK.

Требования

Убедитесь в том, что:

  • у вас установлена свежайшая версия Android SDK;
  • ваш проект компилируется под Android не ниже версии 2.3.3 (в файле *.properties установите target=android-10 или выше).

SDK «Бегуна» требует, чтобы пользовательское устройство работало под управлением Android 2.3.3 или выше (в файле AndroidManifest.xml установите android:minSdkVersion не меньше 10). Даже если ваше приложение компилируется с помощью Android SDK последней версии, оно сможет запускаться в ОС предыдущих версий (Android 2.3.3 и выше).

Подключение SDK для Android

Чтобы включить поддержку рекламы «Бегуна», нужно сделать следующее:

  1. Внедрить библиотеку «Бегуна» в ваш проект.
  2. Установить разрешение в манифесте.

Как внедрить библиотеку «Бегуна»

SDK «Бегуна» для Android — это библиотека begunAdView.jar. Ниже описано, как внедрить её в ваш проект на примере двух распространённых сред разработки: Eclipse (Android Developer Tools) и IntelliJ Idea (Android Studio).

Eclipse и Android Developer Tools

Если вы используете Eclipse или Android Developer Tools, сделайте следующее:

  1. Откройте свойства своего проекта, выбрав в меню Project → Properties.
  1. В разделе Java Build Path выберите вкладку Libraries и нажмите кнопку Add External JARs…
  1. В появившемся диалоге выберите begunAdView.jar.
  2. Перейдите во вкладку Order and Export, отметьте begunAdView.jar и закройте свойства проекта, нажав Ok.

IntelliJ Idea и Android Studio

Если вы используете IntelliJ Idea или Android Studio, сделайте следующее:

  1. Откройте свойства своего проекта, выбрав в меню File → Project Structure…
  1. В разделе Libraries нажмите кнопку +.
  1. В появившемся диалоге выберите begunAdView.jar.
  1. Выберите в списке слева ваш проект, откройте вкладку Dependencies, отметьте begunAdView.jar и закройте свойства проекта, нажав Ok.

Разрешения

Библиотека зависит от Сервисов Google Play (Google Play Services), это необходимо указать при сборке. Для сборки с помощью gradle, например, в build.gradle вашего модуля приложения нужно добавить:

dependencies { ... compile 'com.google.android.gms:play-services:5.0.89' }

Также для работы Google Play Services нужно добавить в AndroidManifest.xml внутрь тэга <application>:

<meta-data android:name="com.google.android.gms.version" android:value="@integer/google_play_services_version" />

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

<uses-permission android:name = "android.permission.INTERNET" />

Геотаргетинг рекламы будет работать точнее, если приложению будет доступна приблизительная геопозиция. Добавьте в манифест следующую строку:

<uses-permission android:name = "android.permission.ACCESS_COARSE_LOCATION" />

Как добавить баннер в приложение

Чтобы в приложении появились рекламные объявления, сделайте следующее:

  1. Объявите рекламный блок в лейауте.
  2. Добавьте в него экземпляр ru.begun.adlib.adView.

Вам потребуются параметры pad_id и block_id, выданные вам нашей службой поддержки. Если у вас их нет, напишите нам: partner-appsmobile@begun.ru

Объявление рекламного блока в лейауте

Добавьте в лейаут код:

<ru.begun.adlib.AdView android:id = "@+id/ad" android:orientation = "vertical" android:layout_width = "fill_parent" android:layout_height = "wrap_content" android:layout_alignParentBottom = "true" />

В качестве родительского элемента рекомендуем использовать RelativeLayout.

Добавление экземпляра ru.begun.adlib.adView

Проще всего добавить adView в ваш Activity. Добавьте туда код:

import ru.begun.adlib.*; public class TestActivity extends Activity { private AdView ad; @Override public void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.main); // Получаем View ad = (AdView)findViewById(R.id.ad); // Включаем отладочные сообщения //ad.onDebug = true; ad.setOnApiListener(new Callback() { // инициализация баннера @Override public void init() { // Получаем pad_id и block_id, необходимые для инициализации баннера ArrayList<RequestParam> al = new ArrayList<RequestParam>(); RequestParam rp = new RequestParam(); rp.name = "environmentVars"; rp.value = "pad_id:<BEGUN_PAD_ID>|block_id:<BEGUN_BLOCK_ID>"; al.add(rp); // инициализириуем ad.api("initAd", al); } // Устанавливаем callback @Override public void callback(String s, String s2) { // Баннер отображается только загрузки (события AdLoaded) if (s.equals("AdLoaded")) { ad.api("startAd"); } } }); // Вызываем метод init(), объявленный ранее ad.init(); } }

Во избежание возможных утечек памяти в onDestroy() вашего activity можно добавить ad.destroy().

Для показа полноэкранной рекламы:

В лейаут код добавлять не нужно.

В AndroidManifest.xml нужно добавить:

<activity
    android:name="ru.begun.adlib.FullScreenActivity"
    android:label="@string/app_name" >
</activity>

В ваш Activity добавьте код:

package ru.begun.adlib.testapp; import ru.begun.adlib.InterstitialAd; import ru.begun.adlib.RequestParam; public class MainActivity extends Activity { private InterstitialAd ia; @Override public void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_main); // Получаем pad_id и block_id, необходимые для инициализации баннера ArrayList al = new ArrayList(); RequestParam rp = new RequestParam(); rp.name = "environmentVars"; rp.value = "pad_id:<BEGUN_PAD_ID>|block_id:<BEGUN_BLOCK_ID>"; al.add(rp); // инициализириуем ia = new InterstitialAd(MainActivity.this, al, true); } public void showAD(View view) { // Начинаем показ рекламы ia.startAd(); } }

Как включить отладочные сообщения

Чтобы включить отладочные сообщения, нужно добавить (или раскомментировать) в Activity строку:

ad.onDebug = true;

Приложение будет писать отладочную информацию с тегом BEGUN_AD.

Готовое приложение

Готовый проект с подключённым баннером можно скачать здесь.

Известные проблемы

Пока что поддерживаются баннеры одного размера: 320x50 пикселей. На устройствах с экраном шире 640 пикселей баннер займёт не всю ширину экрана, а только её часть.





ПоделитьсяПоделиться|

Компания «Бегун» — основоположник и лидер российского рынка контекстной интернет-рекламы с 2002 года. ЗАО «Бегун» — создатель и владелец одноименной системы размещения контекстной рекламы с оплатой за результат.

«Бегун» — первый российский сервис контекстной рекламы с оплатой за переход и аукционным ценообразованием.