Начало работы

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

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

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

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

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

    • Минимальная версия SDK21или выше
    • Скомпилировать SDK-версию33или выше

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

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

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

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

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

  1. В файле настроек Gradle включите репозиторий Google Maven и центральный репозиторий 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:23.3.0")
    }

    классный

    dependencies {
      implementation 'com.google.android.gms:play-services-ads:23.3.0'
    }
  3. Добавьте свой 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:

Ява

import com.google.android.gms.ads.MobileAds;
import com.google.android.gms.ads.initialization.InitializationStatus;
import com.google.android.gms.ads.initialization.OnInitializationCompleteListener;

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

    new Thread(
            () -> {
              // Initialize the Google Mobile Ads SDK on a background thread.
              MobileAds.initialize(this, initializationStatus -> {});
            })
        .start();
  }
}

Котлин

import com.google.android.gms.ads.MobileAds
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 the Google Mobile Ads SDK on a background thread.
      MobileAds.initialize(this@MainActivity) {}
    }
  }
}

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

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

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

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

Межстраничный

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

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

Родной

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

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

Награжден

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

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

Межстраничное объявление с вознаграждением

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

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

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

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

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

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

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

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

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

,

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

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

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

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

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

    • Минимальная версия SDK21или выше
    • Скомпилировать SDK-версию33или выше

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

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

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

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

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

  1. В файле настроек Gradle включите репозиторий Google Maven и центральный репозиторий 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:23.3.0")
    }

    классный

    dependencies {
      implementation 'com.google.android.gms:play-services-ads:23.3.0'
    }
  3. Добавьте свой 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:

Ява

import com.google.android.gms.ads.MobileAds;
import com.google.android.gms.ads.initialization.InitializationStatus;
import com.google.android.gms.ads.initialization.OnInitializationCompleteListener;

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

    new Thread(
            () -> {
              // Initialize the Google Mobile Ads SDK on a background thread.
              MobileAds.initialize(this, initializationStatus -> {});
            })
        .start();
  }
}

Котлин

import com.google.android.gms.ads.MobileAds
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 the Google Mobile Ads SDK on a background thread.
      MobileAds.initialize(this@MainActivity) {}
    }
  }
}

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

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

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

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

Межстраничный

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

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

Родной

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

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

Награжден

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

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

Межстраничное объявление с вознаграждением

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

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

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

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

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

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

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

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

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