Начать

Выберите платформу: 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.3.0")
    }

    Круто

    dependencies {
      implementation 'com.google.android.gms:play-services-ads:24.3.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="ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy"/>
      </application>
    </manifest>
    

    В реальном приложении замените идентификатор примера приложения на ваш фактический идентификатор приложения AdMob . Вы можете использовать идентификатор примера, если вы просто экспериментируете с SDK в приложении Hello World.

    Также обратите внимание, что если не добавить тег <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();

Котлин

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

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

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

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

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

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

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

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

Родной

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

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

Награжден

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

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

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

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

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

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

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

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

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

Внедрите рекламу при открытии приложения

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

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