Начать

Интеграция GMA Next Gen 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. Добавьте зависимости для GMA Next Gen 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 .

Инициализируйте GMA Next Gen SDK

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

Вызовите MobileAds.initialize() для инициализации GMA Next Gen 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 GMA Next Gen SDK 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 GMA Next Gen SDK 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 и вызывает прослушиватель завершения после завершения инициализации GMA Next Gen SDK и адаптера или по истечении 30-секундного тайм-аута. Это необходимо сделать только один раз, в идеале при запуске приложения.

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

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

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

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

Баннер

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

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

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

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

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

Награжден

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

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

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

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

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

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

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

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

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

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