Настройте прямой доступ к Ad Exchange

Выберите платформу: Android (бета-версия) Android iOS

Google Mobile Ads SDK поддерживает монетизацию ваших приложений с помощью рекламной платформы Ad Exchange . В этом руководстве показано, как настроить ваши приложения для всех форматов рекламы, поддерживаемых Ad Exchange.

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

• Выполните необходимые предварительные условия .
• Настройте свое приложение для работы с SDK Google Mobile Ads.

Настройте свое приложение для доступа к Ad Exchange.

Добавьте идентификатор вашего приложения Ad Manager ( указанный в пользовательском интерфейсе Ad Manager ) в файл AndroidManifest.xml вашего приложения с помощью тега <meta-data> с android:name="com.google.android.gms.ads.APPLICATION_ID" . Для android:value вставьте собственный идентификатор вашего приложения Ad Manager, заключенный в кавычки.

<manifest>
    <application>
        <!-- Sample Ad Manager app ID: ca-app-pub-3940256099942544~3347511713 -->
        <meta-data
            android:name="com.google.android.gms.ads.APPLICATION_ID"
            android:value="ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy"/>
    </application>
</manifest>

Обратите также внимание, что отсутствие тега <meta-data> , как показано выше, приводит к сбою с сообщением:

Missing application ID.

Далее вы можете инициализировать SDK Google Mobile Ads и выбрать формат объявления для отображения. В оставшейся части этого руководства рассматривается формат баннера , чтобы показать, как загрузить объявление из Ad Exchange. Те же шаги применимы к любым форматам объявлений, поддерживаемым SDK Google Mobile Ads.

Загрузите объявление с Ad Exchange.

Вместо идентификатора рекламного блока можно использовать код веб-ресурса Ad Exchange с косой чертой в конце. Например, ca-mb-app-pub-5629679302779023/ .

Например, чтобы загрузить баннерную рекламу, разместите AdManagerAdView в макете Activity следующим образом:

# main_activity.xml
...
  <com.google.android.gms.ads.admanager.AdManagerAdView
      xmlns:ads="http://schemas.android.com/apk/res-auto"
      android:id="@+id/adManagerAdView"
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:layout_centerHorizontal="true"
      android:layout_alignParentBottom="true"
      ads:adSize="BANNER"
      ads:adUnitId="ca-mb-app-pub-5629679302779023/">
  </com.google.android.gms.ads.admanager.AdManagerAdView>

В качестве альтернативы, вы можете создать иерархию представлений программным способом:

AdManagerAdView adView = new AdManagerAdView(this);

adView.setAdSizes(AdSize.BANNER);
adView.setAdUnitId("ca-mb-app-pub-5629679302779023/");

// TODO: Add adView to your view hierarchy.

val adView = AdManagerAdView(this)

adView.adSizes = AdSize.BANNER
adView.adUnitId = "ca-mb-app-pub-5629679302779023/"

// TODO: Add adView to your view hierarchy.

После того, как AdManagerAdView будет создан, вы можете вызвать метод loadAd() в классе AdManagerAdView и настроить поведение вашей рекламы, используя события рекламы .

Обратите внимание, что отсутствие завершающей косой черты в коде веб-ресурса Ad Exchange приводит к ошибке запроса объявления со следующим сообщением:

Invalid Request. Cannot determine request type. Is your ad unit id correct?

Вы также можете преобразовать код веб-ресурса Ad Exchange в рекламный блок. После этого используйте пользовательский интерфейс Ad Manager для генерации тега Ad Exchange и скопируйте его в свое приложение. Сгенерированный тег должен содержать код веб-ресурса Ad Exchange, за которым следуют идентификаторы дочерних рекламных блоков без завершающей косой черты, например: ca-mb-app-pub-5629679302779023/banner .

Вот и всё! Ваше приложение готово к загрузке и отображению баннерной рекламы из Ad Exchange.

Кроме того, вы можете использовать веб-ресурс Ad Exchange для загрузки и отображения других форматов объявлений с Ad Exchange, следуя соответствующим инструкциям:

• Интерстициальный
• Родной
• Награжден

(Только для одобренных европейских издателей) Добавить минимальные цены

Вы можете отправить запрос на добавление функции «Минимальные цены» .

После одобрения вы можете указать публичный или частный минимальный уровень цен в запросе на рекламу, используя параметры pubf и pvtf соответственно. В следующем примере кода замените "123" на минимальные цены в микросекундах и валюту вашей сети по умолчанию . Пример применения микросекунд: если ваша валюта по умолчанию — доллары США, ввод "6000000" эквивалентен 6 долларам.

Bundle extras = new Bundle();
// Public floor parameter.
extras.putString("pubf", "123");
// Private floor parameter.
extras.putString("pvtf", "123");

AdManagerAdRequest request = new AdManagerAdRequest.Builder()
    .addNetworkExtrasBundle(AdMobAdapter.class, extras)
    .build();

val extras = Bundle();
// Public floor parameter.
extras.putString("pubf", "123");
// Private floor parameter.
extras.putString("pvtf", "123");

val request = AdManagerAdRequest.Builder()
    .addNetworkExtrasBundle(AdMobAdapter::class::java, extras)
    .build();