Начать

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

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

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

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

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

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

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

Настройте свое приложение в своем аккаунте AdMob

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

  1. Войдите в систему или зарегистрируйте учетную запись AdMob.

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

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

  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.4.0")
}

    Круто 

    dependencies {
  implementation 'com.google.android.gms:play-services-ads:24.4.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 версии 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 .

Инициализируйте Google Mobile Ads SDK

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

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

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

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

Ява 

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@MainActivity) {}
}
MainActivity.kt

Выберите формат рекламы

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

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

Внедрение баннерной рекламы

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

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

Внедрение межстраничной рекламы

Родной

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

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

Награжден

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

Внедрение объявлений с вознаграждением

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

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

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

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

Внедрение вознагражденной межстраничной рекламы

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

Открытие приложения — это формат рекламы, который появляется при открытии приложения или переходе обратно в него. Реклама накладывается на экран загрузки.

Реализуйте рекламу при открытии приложения

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

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