Начать

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

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

Прежде чем начать

Для подготовки приложения выполните действия, описанные в следующих разделах.

Предварительные требования к приложению

  • Убедитесь, что в файле сборки вашего приложения используются следующие значения:

    • Минимальная версия SDK — 23 или выше.
    • Скомпилируйте SDK версии 35 или выше.

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

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

    Котлин 

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

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

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

    Классный 

    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 в файл сборки вашего приложения:

    Котлин 

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

    Классный 

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

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

  4. Добавьте идентификатор вашего приложения Ad Manager, указанный в веб-интерфейсе Ad Manager , в файл AndroidManifest.xml вашего приложения. Для этого добавьте тег <meta-data> с android:name="com.google.android.gms.ads.APPLICATION_ID" . Вы можете найти свой идентификатор приложения в веб-интерфейсе Ad Manager. Для 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="SAMPLE_APP_ID"/>
  </application>
</manifest>

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

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

    Missing application ID.

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

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

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

    <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 .

Инициализируйте SDK мобильной рекламы Google.

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

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

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

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

Java 

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

Котлин 

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

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

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

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

Внедрить баннерную рекламу

Интерстициальный

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

Внедрить межстраничную рекламу

Родной

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

Google Ad Manager предлагает два способа внедрения нативной рекламы: нативные стили и стандартная нативная реклама с пользовательской отрисовкой.

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

Внедрить нативные стили. Внедрить нативную рекламу (с пользовательской отрисовкой).

Награжден

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

Внедрить рекламу с вознаграждением.

Вознагражденный интерстициальный

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

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

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

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

Приложение открыто

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

Внедрить функцию открытия рекламы в приложении.

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

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