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

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

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

Подготовка

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

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

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

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

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

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

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

    <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="SAMPLE_APP_ID"/>
  </application>
</manifest>

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

    Обратите внимание, что если тег <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 и может получать доступ к рекламному идентификатору, когда он доступен.

    Если вы используете 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-секундного тайм-аута. Это нужно сделать только один раз, желательно при запуске приложения.

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

Объявления могут быть предварительно загружены 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@MyActivity) {}
}

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

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

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

Как реализовать баннеры

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

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

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

Стандартное

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

В Google Менеджере рекламы есть два способа реализации нативных объявлений: нативные стили и стандартные нативные объявления со специальной обработкой.

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

Как реализовать нативные стили Как реализовать нативные объявления (специальная обработка)

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

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

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

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

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

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

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

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

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

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

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

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

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