Начать

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

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

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

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

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

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

• Для приложений Kotlin используйте версию Kotlin не ниже 1.9.

Настройте свое приложение в своем аккаунте 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.libraries.ads.mobile.sdk:ads-mobile-sdk:0.21.0-beta01")
   }

   Круто

   dependencies {
     implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.21.0-beta01'
   }

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

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

Ключевой момент : перед загрузкой рекламы и взаимодействием с другими методами MobileAds необходимо инициализировать Google Mobile Ads SDK (бета), если это явно не указано в справочной документации API (см. getVersion() ). В противном случае может быть выдано исключение UninitializedPropertyAccessException .

Вызовите MobileAds.initialize() для инициализации Google Mobile Ads SDK (бета). Этот вызов должен быть выполнен в фоновом потоке. В противном случае может возникнуть ошибка «Приложение не отвечает» (ANR).

Котлин

import com.google.android.libraries.ads.mobile.sdk.MobileAds
import com.google.android.libraries.ads.mobile.sdk.initialization.InitializationConfig
import kotlinx.coroutines.CoroutineScope
import kotlinx.coroutines.Dispatchers
import kotlinx.coroutines.launch

class MainActivity : AppCompatActivity() {
  override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    setContentView(R.layout.activity_main)

    val backgroundScope = CoroutineScope(Dispatchers.IO)
    backgroundScope.launch {
      // Initialize Google Mobile Ads SDK (beta) on a background thread.
      MobileAds.initialize(
        this@MainActivity,
        // Sample AdMob app ID: ca-app-pub-3940256099942544~3347511713
        InitializationConfig.Builder("SAMPLE_APP_ID").build()
      ) {
        // Adapter initialization is complete.
      }
      // Other methods on MobileAds can now be called.
    }
  }
}

Ява

import com.google.android.libraries.ads.mobile.sdk.MobileAds;
import com.google.android.libraries.ads.mobile.sdk.initialization.InitializationConfig;

public class MainActivity extends AppCompatActivity {
  protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);

    new Thread(
            () -> {
              // Initialize Google Mobile Ads SDK (beta) on a background thread.
              MobileAds.initialize(
                  this,
                  // Sample AdMob app ID: ca-app-pub-3940256099942544~3347511713
                  new InitializationConfig.Builder("SAMPLE_APP_ID")
                      .build(),
                  initializationStatus -> {
                    // Adapter initialization is complete.
                  });
              // Other methods on MobileAds can now be called.
            })
        .start();
  }
}

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

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

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

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

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

Баннер

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

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

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

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

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

Награжден

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

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

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

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

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

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

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

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

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

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