Начать

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

Интеграция 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.22.0-beta01")
}

    Классный 

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

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

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

Для инициализации GMA Next-Gen SDK необходимо вызвать метод MobileAds.initialize() . Этот метод должен выполняться в фоновом потоке; в противном случае может возникнуть ошибка "Приложение не отвечает" (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.
    }
  }
}

Java 

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-секундного таймаута. Это необходимо сделать только один раз, в идеале при запуске приложения.

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

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

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

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

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

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

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

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

Родной

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

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

Награжден

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

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

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

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

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

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

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

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

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

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