Как настроить Google Mobile Ads SDK (устаревшая версия)

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

Интеграция Google Mobile Ads SDK (Legacy) в приложение – это первый шаг к показу рекламы и получению дохода. После интеграции SDK выберите формат рекламы (например, нативную или видео с вознаграждением) и следуйте инструкциям по ее реализации.

Подготовка

Чтобы подготовить приложение, выполните нужные действия в разделах, указанных ниже.

Требования к приложению

  • Убедитесь, что в файле сборки приложения приведены значения, указанные ниже.

    • Минимальная версия SDK: 24 или более поздняя.
    • Версия SDK для компиляции:35 или более поздняя.

Как настроить приложение в аккаунте AdMob

Зарегистрируйте приложение как приложение AdMob, выполнив следующие действия:

  1. Войдите или зарегистрируйтесь в AdMob.

  2. Зарегистрируйте приложение в AdMob. На этом этапе создается приложение AdMob с уникальным идентификатором приложения AdMob, который понадобится позже.

Настройка приложения

  1. В файле настроек Gradle добавьте репозиторий Google Maven и центральный репозиторий Maven:

    Kotlin

    pluginManagement {
  repositories {
    google()
    mavenCentral()
    gradlePluginPortal()
  }
}

dependencyResolutionManagement {
  repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
  repositories {
    google()
    mavenCentral()
  }
}

rootProject.name = "My Application"
include(":app")

    Groovy

    pluginManagement {
  repositories {
    google()
    mavenCentral()
    gradlePluginPortal()
  }
}

dependencyResolutionManagement {
  repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
  repositories {
    google()
    mavenCentral()
  }
}

rootProject.name = "My Application"
include ':app'

  2. Добавьте в файл сборки на уровне приложения зависимости для Google Mobile Ads SDK (Legacy):

    Kotlin

    dependencies {
  implementation("com.google.android.gms:play-services-ads:25.5.0")
}

    Groovy

    dependencies {
  implementation 'com.google.android.gms:play-services-ads:25.5.0'
}

  3. Нажмите Синхронизировать. Подробнее о синхронизации проектов с файлами Gradle…

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

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

    Замените SAMPLE_APP_ID идентификатором приложения AdMob. При тестировании используйте идентификатор примера приложения из предыдущего примера.

    Обратите внимание, что если добавить тег <meta-data> не так, как показано, произойдет сбой с сообщением:

    Missing application ID.

    (Необязательно) Задекларируйте разрешение AD_ID, чтобы предыдущие версии приложения работали с Android 13.

    Если в вашем приложении используется Google Mobile Ads SDK (Legacy) версии 20.4.0 или более поздней, этот шаг можно пропустить, поскольку SDK автоматически объявляет разрешение com.google.android.gms.permission.AD_ID и может получить доступ к рекламному идентификатору, когда он доступен.

    Если вы используете SDK Google Mobile Ads SDK (Legacy) версии 20.3.0 или более ранней и ваше приложение предназначено для Android 13, вам необходимо добавить разрешение com.google.android.gms.permission.AD_ID в файл AndroidManifest.xml, чтобы Google Mobile Ads SDK (Legacy) мог получить доступ к рекламному идентификатору:

    <manifest>
 <application>
   <meta-data
       android:name="com.google.android.gms.ads.APPLICATION_ID"
       android:value="ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy"/>

   <!-- For apps targeting Android 13 or higher & GMA SDK version 20.3.0 or lower -->
   <uses-permission android:name="com.google.android.gms.permission.AD_ID"/>

 </application>
</manifest>

    Чтобы узнать больше о декларации разрешения com.google.android.gms.permission.AD_ID и о том, как ее отключить, ознакомьтесь со статьей о Play Console.

Инициализация Google Mobile Ads SDK (Legacy)

Перед загрузкой объявлений инициализируйте Google Mobile Ads SDK (Legacy), вызвав функцию MobileAds.initialize().

Этот метод инициализирует SDK и вызывает прослушиватель завершения после того, как будут завершены инициализации Google Mobile Ads SDK (Legacy) и адаптера или по истечении 30-секундного времени ожидания. Это нужно сделать только один раз, желательно при запуске приложения.

Если вы используете медиацию AdMob, дождитесь вызова обработчика завершения, прежде чем загружать объявления. Это гарантирует, что все адаптеры медиации будут инициализированы.

Объявления могут быть предварительно загружены SDK Google Mobile Ads SDK (Legacy) или партнера по медиации при инициализации. Если вам нужно получать согласие пользователей из Европейской экономической зоны (ЕЭЗ), Великобритании или Швейцарии, задайте флаги для запросов, например setTagForChildDirectedTreatment() или setTagForUnderAgeOfConsent(), или выполните другие действия до загрузки объявлений, убедитесь, что вы сделали это до инициализации Google Mobile Ads SDK (Legacy).

Вот пример того, как вызвать метод initialize() в фоновом потоке в рамках Activity:

Java

new Thread(
        () -> {
          // Initialize the Google Mobile Ads SDK on a background thread.
          MobileAds.initialize(this, initializationStatus -> {});
        })
    .start();

Kotlin

CoroutineScope(Dispatchers.IO).launch {
  // Initialize the Google Mobile Ads SDK on a background thread.
  MobileAds.initialize(this@MainActivity) {}
}

Выберите формат объявления

Google Mobile Ads SDK (Legacy) импортирован, и вы можете реализовать объявление. AdMob предлагает множество форматов объявлений, поэтому вы можете выбрать тот, который лучше всего подходит для вашего приложения.

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

Как размещать баннеры

Межстраничное объявление

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

Как размещать межстраничные объявления

Стандартное

Нативные объявления – это объявления, в которых можно настраивать внешний вид объектов, например заголовков и призывов к действию, в ваших приложениях. Вы можете самостоятельно задать стиль объявления, чтобы оно выглядело естественно и ненавязчиво и не мешало пользователям.

Как размещать нативные объявления

Бонус предоставлен

В рекламном блоке объявлений с вознаграждением пользователи могут смотреть видео, проходить опросы, играть в игры и т. д., получая вознаграждение в приложении, например монеты, жизни или очки. Для разных блоков можно назначать разные вознаграждения.

Как реализовать объявления с вознаграждением

Межстраничные объявления с вознаграждением

Межстраничное объявление с вознаграждением – это новый формат рекламы с поощрением, которая показывается при переходах внутри приложения и позволяет начислять пользователям бонусы за взаимодействие с ней, например монеты или дополнительные жизни.

В отличие от обычных объявлений с вознаграждением для показа межстраничных объявлений с вознаграждением не требуется согласие пользователя.

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

Как добавить межстраничные объявления с вознаграждением

Запуск приложения

Объявления при запуске приложения показываются, когда пользователь открывает приложение или возвращается к нему. При этом объявление накладывается на экран загрузки.

Как реализовать объявления при запуске приложения

Дополнительные ресурсы

В репозитории Google Mobile Ads на сайте GitHub показано, как использовать различные форматы объявлений, которые предлагает этот API.