Начните использовать AdMob в своем проекте Android.

Это краткое руководство предназначено для издателей и разработчиков, которые хотят использовать AdMob для монетизации приложения, созданного с помощью Firebase. Если вы не планируете включать Firebase в свое приложение, вместо этого посетите отдельное руководство AdMob .

Если вы еще этого не сделали, узнайте обо всех преимуществах совместного использования AdMob , Firebase и Google Analytics .

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

• Если у вас еще нет проекта Firebase и приложения Firebase, следуйте руководству по началу работы с Firebase: Добавьте Firebase в свой проект Android .

• Убедитесь, что Google Analytics включен в вашем проекте Firebase:

  • Если вы создаете новый проект Firebase, включите Google Analytics во время рабочего процесса создания проекта.

  • Если у вас есть существующий проект Firebase, в котором не включен Google Analytics , вы можете включить Google Analytics на вкладке «Интеграции» вашего аккаунта. > Настройки проекта .

  Примечание. Добавление Firebase SDK для Google Analytics в ваше приложение не является обязательным, но настоятельно рекомендуется. Узнайте больше о преимуществах добавления Firebase SDK для Google Analytics .

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

1. Зарегистрируйте свое приложение как приложение AdMob .

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

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

   Вам будет предложено добавить Mobile Ads SDK в ваше приложение. Подробные инструкции по выполнению этой задачи вы найдете далее в этом руководстве.

2. Свяжите свое приложение AdMob с приложением Firebase.

   Этот шаг не является обязательным, но настоятельно рекомендуется. Узнайте больше о преимуществах включения пользовательских показателей и связи вашего приложения AdMob с Firebase.

   Выполните следующие два шага на панели приложений вашего аккаунта AdMob :

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

   2. Свяжите свое приложение AdMob с существующим проектом Firebase и приложением Firebase.

      Убедитесь, что вы вводите то же имя пакета, что и для своего приложения Firebase. Найдите название пакета вашего приложения Firebase на карточке «Ваши приложения» вашего > Настройки проекта .

Шаг 2. Добавьте идентификатор приложения AdMob в файл AndroidManifest.xml

Добавьте свой идентификатор приложения AdMob в файл AndroidManifest.xml вашего приложения, добавив тег <meta-data> , как показано ниже.

Важно! Этот шаг является обязательным начиная с версии Google Mobile Ads SDK 17.0.0. Если вы не добавите этот тег <meta-data> , ваше приложение выйдет из строя с сообщением: "The Google Mobile Ads SDK was initialized incorrectly."

<manifest>
    <application>
        <!-- Sample AdMob App ID: ca-app-pub-3940256099942544~3347511713 -->
        <meta-data
            android:name="com.google.android.gms.ads.APPLICATION_ID"
            android:value="ADMOB_APP_ID"/>
    </application>
</manifest>

Шаг 3. Добавьте и инициализируйте Mobile Ads SDK

1. Добавьте зависимость для Google Mobile Ads SDK в файл Gradle вашего модуля (на уровне приложения) (обычно <project>/<app-module>/build.gradle.kts или <project>/<app-module>/build.gradle ):

   implementation("com.google.android.gms:play-services-ads:23.5.0")
   

2. Перед загрузкой рекламы вызовите метод MobileAds.initialize() .

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

   Предупреждение. Объявления могут быть предварительно загружены с помощью Mobile Ads SDK или SDK партнеров-посредников при вызове MobileAds.initialize() . Если вам необходимо предпринять какие-либо действия перед загрузкой рекламы, убедитесь, что вы сделали это до инициализации Mobile Ads SDK. Вот несколько примеров действий, которые могут потребоваться перед инициализацией:

   • Получить согласие от пользователей в Европейской экономической зоне (ЕЭЗ).
   • Установите любые флаги, специфичные для запроса (например, tagForChildDirectedTreatment или tag_for_under_age_of_consent ).

   Подробную информацию можно найти в документации AdMob .

   Вот пример вызова метода initialize() в действии:

   Kotlin+KTX

   override fun onCreate(savedInstanceState: Bundle?) {
       super.onCreate(savedInstanceState)
       // ...
       MobileAds.initialize(this)
   }
   MainActivity.kt

   Java

   @Override
   protected void onCreate(Bundle savedInstanceState) {
       super.onCreate(savedInstanceState);
       // ...
       MobileAds.initialize(this);
   }
   MainActivity.java

Шаг 4. Просмотр пользовательских показателей и аналитических данных

После инициализации Mobile Ads SDK автоматически начинает регистрировать аналитические события и свойства пользователей из вашего приложения. Вы можете просматривать эти данные, не добавляя дополнительный код в свое приложение и не внедряя какую-либо рекламу. Вот где вы можете увидеть эти аналитические данные:

• На карточке пользовательских показателей вашего аккаунта AdMob ( главная страница или панель приложений ) вы можете просмотреть специально подобранные пользовательские метрики , полученные на основе собранных аналитических данных, такие как средняя продолжительность сеанса, ARPU и удержание.

• На панели инструментов Analytics консоли Firebase вы можете просмотреть агрегированную статистику и сводку ключевых показателей . Если вы добавите Firebase SDK для Google Analytics , вы также сможете отмечать конверсии для рекламных кампаний и создавать собственные аудитории в консоли Firebase .

Обратите внимание: чтобы лучше представить показатели ARPU и ARPPU , вы можете включить данные из пользовательского события аналитики под названием ecommerce_purchase в расчет дохода для этих показателей ( узнайте, как это сделать ).

Данные обычно появляются в течение часа, но их появление может занять до 48 часов.

Шаг 5. (Необязательно) Используйте дополнительные функции Google Analytics и Firebase.

Воспользуйтесь дополнительными возможностями и функциями для улучшения монетизации приложений и вовлечения пользователей:

• Добавьте и используйте Firebase SDK для Google Analytics

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

  • Отмечайте конверсии для специальных рекламных кампаний .

  • Включите данные о событии ecommerce_purchase в расчет дохода для показателей ARPU и ARPPU .

  Чтобы узнать больше, посетите руководство по использованию Google Analytics и Firebase с приложениями AdMob .

• Используйте другие продукты Firebase в своем приложении

  После добавления Firebase SDK для Google Analytics используйте другие продукты Firebase для оптимизации рекламы в своем приложении.

  • Remote Config позволяет вам бесплатно изменить поведение и внешний вид вашего приложения без публикации обновления приложения для неограниченного числа активных пользователей в день.

  • A/B Testing дает вам возможность протестировать изменения в пользовательском интерфейсе, функциях или кампаниях по вовлечению вашего приложения, чтобы узнать, влияют ли они на ваши ключевые показатели (такие как доход и удержание), прежде чем широко внедрять изменения.

• Оптимизируйте монетизацию рекламы для своего приложения

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

  • Протестируйте внедрение нового формата рекламы ( обзор | реализация ).

  • Оптимизация частоты показа объявлений ( обзор | реализация ).

Шаг 6. Выберите формат рекламы для использования в вашем приложении.

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

Баннер

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

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

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

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

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

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

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

Родной

Настраиваемые объявления, соответствующие внешнему виду вашего приложения.

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

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

Награжден

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

Реклама с вознаграждением (или «на основе вознаграждения») может помочь монетизировать пользователей бесплатной игры.

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

Внедрение рекламы с вознаграждением (новые API)