Процесс подключения полноэкранной рекламы

Внимание.

Это архивная версия документации. Актуальная документация по всем платформам находится здесь.

Полноэкранная реклама (Interstitial) — это настраиваемое объявление, отображаемое на весь экран и реагирующее на нажатие.

Чтобы подключить рекламу, необходимо:

Создание InterstitialAd

  1. Создайте объект класса InterstitialAd. Объект может быть создан только программно.

    mInterstitialAd = new InterstitialAd(this);

  2. Установите AdUnitId, используя метод setAdUnitId.

    mInterstitialAd.setAdUnitId(AdUnitId);

    AdUnitId — уникальный идентификатор рекламного места, который выдается в Партнерском интерфейсе и имеет вид: R-M-XXXXXX-Y.

  3. После создания и настройки объекта класса InterstitialAd, для отслеживания событий (открытие или закрытие рекламы, выход из приложения, успешная и не успешная загрузка рекламы), на объект рекламы можно установить слушатель InterstitialEventListener интерфейса.

Загрузка рекламы

Примечание.

Все вызовы Mobile Ads SDK следует выполнять с главного потока.

После создания и настройки объекта класса InterstitialAd, рекламу необходимо загрузить. Для загрузки рекламы, используйте метод loadAd, принимающий в качестве параметра объект AdRequest (Builder, опционально принимающий данные для таргетирования рекламы).

Отображение рекламы

Загрузка полноэкранной рекламы происходит в фоновом потоке сразу после вызова метода loadAd. Чтобы показать полноэкранную рекламу необходимо вызвать метод show.

Рекомендуется предварительно проверить, что реклама действительно загружена. Для этого вызовите метод isLoaded.

Примечание.

Такая проверка не требуется, если метод show вызывается после срабатывания callback об окончании загрузки onAdLoaded.

Пример работы с полноэкранной рекламой

Следующий код демонстрирует создание и настройку объекта InterstitialAd, регистрацию слушателя, а также загрузку и отображение полноэкранной рекламы:

...
public class InterstitialExample extends Activity {
    ...
    private static final String AdUnitId = "YOUR_AdUnitId";
    private InterstitialAd mInterstitialAd;
    @Override
    public void onCreate(Bundle savedInstanceState) {
        ...
        // Создание экземпляра InterstitialAd.
        mInterstitialAd = new InterstitialAd(this);
        mInterstitialAd.setAdUnitId(AdUnitId);

        // Создание объекта таргетирования рекламы.
        final AdRequest adRequest = new AdRequest.Builder().build();

        // Регистрация слушателя для отслеживания событий, происходящих в рекламе.
        mInterstitialAd.setInterstitialAdEventListener(new InterstitialAdEventListener() {
            @Override
            public void onAdLoaded() {
                mInterstitialAd.show();
            }
            
            @Override
            public void onAdFailedToLoad(AdRequestError adRequestError) {
                ...
            }
            
            @Override
            public void onAdShown() {
                ...
            }
            
            @Override
            public void onAdDismissed() {
                ...
            }
            
            @Override
            public void onLeftApplication() {
                ...
            }
            
            @Override
            public void onReturnedToApplication() {
                ...
            }
        });

        // Загрузка объявления.
        mInterstitialAd.loadAd(adRequest);
    }
}

Если реклама подключена данным образом, после запуска приложения появится рекламный блок:

Чтобы посмотреть, как реклама будет отображаться в приложении, используйте демонстрационный AdUnitId:
  • demo-interstitial-yandex