Добавить поддержку сопутствующих объявлений

Выберите платформу: HTML5 Android iOS

Данное руководство предназначено для издателей, заинтересованных в добавлении сопутствующей рекламы к своим решениям IMA для Android.

Предварительные требования

  • Приложение для Android со встроенным IMA SDK. Если у вас ещё нет приложения со встроенным SDK, обратитесь к примеру BasicExample. Если вам нужна помощь во внедрении IMA SDK в ваше приложение, ознакомьтесь с разделом «Настройка IMA SDK» .
  • Тег объявления, настроенный для показа сопутствующего объявления. Если вам нужен пример, ознакомьтесь с разделом часто задаваемых вопросов (FAQ) .

Добавьте сопутствующую рекламу в ваше приложение.

Следуйте инструкциям, чтобы добавить рекламный блок и отображать сопутствующую рекламу в вашем приложении.

Создайте ViewGroup для отображения вашего вспомогательного элемента.

Прежде чем запрашивать дополнительный элемент, необходимо создать для него место в вашем макете. В XML-файле макета добавьте элемент ViewGroup ; в этом примере используется LinearLayout . На следующем шаге вы передадите ссылку на этот элемент в ваш AdDisplayContainer .

Если вы интегрируете это в приложение BasicExample, добавьте следующий код в файл activity_my.xml , ниже элемента videoPlayerContainer .

<LinearLayout
    android:id="@+id/companionAdSlot"
    android:layout_width="match_parent"
    android:layout_height="250dp"
    android:layout_gravity="center_horizontal"
    android:gravity="center"
    android:orientation="vertical"
    android:textAlignment="center" />
companion_ad_slot_snippet.xml

Создать CompanionAdSlot слот

Следующий шаг — создание объекта CompanionAdSlot , который затем добавляется в экземпляр ArrayList<CompanionAdSlot> . Интерфейс AdDisplayContainer принимает список рекламных слотов-компаньонов, что позволяет отображать несколько рекламных объявлений одновременно. Для создания объекта CompanionAdSlot необходимо создать экземпляр класса ImaSdkFactory .

public void createCompanionAdSlot(ViewGroup companionViewGroup) {
  ImaSdkFactory sdkFactory = ImaSdkFactory.getInstance();
  CompanionAdSlot companionAdSlot = sdkFactory.createCompanionAdSlot(companionViewGroup);
  companionAdSlot.setSize(300, 250);
  ArrayList<CompanionAdSlot> companionAdSlots = new ArrayList<CompanionAdSlot>();
  companionAdSlots.add(companionAdSlot);
}

CompanionAdSnippets.java

Создайте отдельный рекламный слот для каждого размера вспомогательного объекта, который вы планируете показывать в своем приложении. SDK IMA заполняет рекламный слот вспомогательными объектами из ответа VAST, размеры которых соответствуют высоте и ширине представления. SDK IMA также поддерживает использование вспомогательных объектов с изменяемым размером . После создания companionAdSlots добавьте их в AdsLoader . Следующие примеры показывают, как это сделать в зависимости от того, используете ли вы расширение Exoplayer-IMA или другие реализации IMA, которые не используют это расширение.

Расширение Exoplayer-IMA 

public void setCompanionAdSlotExoPlayer(
    Context context, ArrayList<CompanionAdSlot> companionAdSlots) {
  ImaAdsLoader adsLoader =
      new ImaAdsLoader.Builder(context).setCompanionAdSlots(companionAdSlots).build();
}

CompanionAdSnippets.java

Другие реализации 

public void setCompanionAdSlot(
    AdDisplayContainer adDisplayContainer, ArrayList<CompanionAdSlot> companionAdSlots) {
  adDisplayContainer.setCompanionSlots(companionAdSlots);
}

CompanionAdSnippets.java

Вот и всё! В вашем приложении сейчас отображаются рекламные объявления.

Отображение сопутствующих рекламных объявлений

IMA поддерживает адаптивные рекламные объявления-компаньоны. Эти объявления-компаньоны могут изменять свой размер в соответствии с размером рекламного блока. Они занимают 100% ширины родительского элемента, а затем изменяют свою высоту, чтобы соответствовать содержимому объявления-компаньона. Размер адаптивных объявлений задается с помощью параметра «Размер Fluid объявлений-компаньонов» в Ad Manager. См. изображение ниже, где показано, где задать это значение.

Изображение, демонстрирующее настройки сопутствующих объявлений в Ad Manager. Выделена опция выбора размеров сопутствующих объявлений.

Обновите приложения Android для более удобной работы.

Чтобы объявить слот для компаньона с возможностью изменения параметров, обновите метод CompanionAdSlot.setSize() , добавив в качестве параметров CompanionAdSlot.FLUID_SIZE .

companionAdSlot.setSize(CompanionAdSlot.FLUID_SIZE, CompanionAdSlot.FLUID_SIZE);
CompanionAdSnippets.java

Часто задаваемые вопросы

Я следовал инструкциям, но не вижу сопутствующей рекламы. Что мне делать?
Во-первых, убедитесь, что ваш тег действительно возвращает компаньонов. Для этого откройте тег в веб-браузере и найдите тег <CompanionAds> . Если вы его видите, убедитесь, что размер возвращаемого компаньона совпадает с размерами, которые вы передаете в объект CompanionAdSlot .
Как будет выглядеть мой рекламный блок, если я буду следовать этому руководству?

Следующее изображение создано на основе BasicExample и содержит видеоконтент, воспроизводимый сверху, а сопутствующую рекламу — снизу.

Пример рекламного изображения для Android-приложения IMA.