Начните работу с AdMob в своем проекте C++.

Рассмотрите возможность использования SDK для iOS и Android от AdMob.

УСТАРЕВШИЙ: SDK Google Mobile Ads C++ устарел с 17 июня 2024 года и не должен использоваться в проектах, которые его еще не используют. Его поддержка прекратится 17 июня 2025 года. Обратите внимание, что версии SDK, выпущенные до даты окончания поддержки, будут продолжать функционировать, но после этой даты никаких исправлений ошибок или изменений выпускаться не будет.

Вместо SDK Google Mobile Ads на C++ рассмотрите возможность использования SDK для iOS и Android от AdMob . За поддержкой обращайтесь на технический форум SDK Google Mobile Ads .

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

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

Если вы впервые знакомитесь с этим руководством, мы рекомендуем загрузить и использовать тестовое приложение Google Mobile Ads C++ SDK .

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

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

• Убедитесь, что 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 , который понадобится вам позже в этом руководстве.

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

2. Свяжите каждое из ваших приложений AdMob с соответствующим приложением Firebase.

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

   Для каждого варианта платформы выполните следующие два шага на панели управления «Приложения» в вашем аккаунте AdMob :

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

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

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

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

Android

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

<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>

iOS

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

Это изменение можно внести программным способом:

<!-- Sample AdMob App ID: ca-app-pub-3940256099942544~1458002511 -->
<key>GADApplicationIdentifier</key>
<string>ADMOB_APP_ID</string>

Или отредактируйте его в редакторе списка свойств:

Шаг 3: Добавьте SDK для мобильной рекламы Google.

Поскольку SDK Google Mobile Ads на C++ находится в пространстве имен firebase::gma , загрузите SDK Firebase на C++ и распакуйте его в выбранную вами директорию.

SDK Firebase для C++ не является платформенно-зависимым, но требует специфичных для платформы настроек библиотек.

Android

Примечание: Мы рекомендуем использовать CMake, но инструкции по использованию ndk-build можно найти в нашем общем руководстве по началу работы с Firebase C++ SDK , чтобы связать libfirebase_app.a и libfirebase_gma.a с вашим приложением.

1. В файле gradle.properties вашего проекта укажите расположение распакованного SDK:

   systemProp.firebase_cpp_sdk.dir=FULL/PATH/TO/SDK

2. В файл settings.gradle вашего проекта добавьте следующее содержимое:

   def firebase_cpp_sdk_dir = System.getProperty('firebase_cpp_sdk.dir')
   
   gradle.ext.firebase_cpp_sdk_dir = "$firebase_cpp_sdk_dir"
   includeBuild "$firebase_cpp_sdk_dir"

3. В файл Gradle вашего модуля (уровня приложения) (обычно app/build.gradle ) добавьте следующее содержимое, включающее зависимость библиотеки для Google Mobile Ads C++ SDK.

   android.defaultConfig.externalNativeBuild.cmake {
     arguments "-DFIREBASE_CPP_SDK_DIR=$gradle.firebase_cpp_sdk_dir"
   }
   
   # Add the dependency for the Google Mobile Ads C++ SDK
   apply from: "$gradle.firebase_cpp_sdk_dir/Android/firebase_dependencies.gradle"
   firebaseCpp.dependencies {
     gma
   }

4. В файл CMakeLists.txt вашего проекта добавьте следующее содержимое.

   # Add Firebase libraries to the target using the function from the SDK.
   add_subdirectory(${FIREBASE_CPP_SDK_DIR} bin/ EXCLUDE_FROM_ALL)
   
   # Add the Google Mobile Ads C++ SDK.
   
   # The Firebase C++ library `firebase_app` is required,
   # and it must always be listed last.
   
   set(firebase_libs
     firebase_gma
     firebase_app
   )
   
   target_link_libraries(${target_name} "${firebase_libs}")

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

Всё готово! Ваше приложение на C++ настроено для использования Google Mobile Ads C++ SDK.

iOS

В этом разделе описан пример того, как добавить SDK Google Mobile Ads на C++ в ваш iOS-проект.

1. Для получения CocoaPods версии 1 или более поздней выполните следующую команду:

   sudo gem install cocoapods --pre

2. Добавьте модуль Google Mobile Ads из распакованного SDK.

   1. Создайте файл Podfile, если у вас его ещё нет:

      cd YOUR_APP_DIRECTORY
      pod init

   2. Добавьте в свой Podfile модуль для Google Mobile Ads C++ SDK:

      pod 'Google-Mobile-Ads-SDK'

   3. Установите Pod-пак, затем откройте файл .xcworkspace в Xcode.

      pod install
      open YOUR_APP.xcworkspace

   4. Добавьте в проект следующие фреймворки из Firebase C++ SDK:

      • xcframeworks/firebase.xcframework
      • xcframeworks/firebase_gma.xcframework

Всё готово! Ваше приложение на C++ настроено для использования Google Mobile Ads C++ SDK.

Шаг 4: Инициализация SDK для мобильной рекламы Google

Примечание: Если вы используете тестовое приложение Google Mobile Ads C++ SDK, следующие шаги уже выполнены за вас. Теперь вы можете запустить тестовое приложение.

Перед загрузкой рекламы инициализируйте SDK Mobile Ads , вызвав firebase::gma::Initialize() .

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

Внимание: Реклама может быть предварительно загружена SDK Mobile Ads или SDK партнеров по медиации при вызове метода Initialize() . Если вам необходимо предпринять какие-либо действия перед загрузкой рекламы, убедитесь, что вы сделали это, вызвав firebase::gma::SetRequestConfiguration() перед инициализацией SDK Mobile Ads . Вот несколько примеров действий, которые могут потребоваться перед инициализацией:

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

Для получения более подробной информации см. наше руководство по таргетированию .

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

Android

// Initialize the Google Mobile Ads library
firebase::InitResult result;
Future<AdapterInitializationStatus> future =
  firebase::gma::Initialize(jni_env, j_activity, &result);

if (result != kInitResultSuccess) {
  // Initialization immediately failed, most likely due to a missing dependency.
  // Check the device logs for more information.
  return;
}

// Monitor the status of the future.
// See "Use a Future to monitor the completion status of a method call" below.
if (future.status() == firebase::kFutureStatusComplete &&
    future.error() == firebase::gma::kAdErrorCodeNone) {
  // Initialization completed.
} else {
  // Initialization on-going, or an error has occurred.
}

iOS

// Initialize the Google Mobile Ads library.
firebase::InitResult result;
Future<AdapterInitializationStatus> future =
  firebase::gma::Initialize(&result);

if (result != kInitResultSuccess) {
  // Initialization immediately failed, most likely due to a missing dependency.
  // Check the device logs for more information.
  return;
}

// Monitor the status of the future.
// See "Use a Future to monitor the completion status of a method call" below.
if (future.status() == firebase::kFutureStatusComplete &&
    future.error() == firebase::gma::kAdErrorCodeNone) {
  // Initialization completed.
} else {
  // Initialization on-going, or an error has occurred.
}

Используйте Future для отслеживания статуса завершения вызова метода.

Объект Future предоставляет вам способ определить статус завершения вызовов асинхронных методов.

Например, когда ваше приложение вызывает firebase::gma::Initialize() , создается и возвращается новый firebase::Future . Затем ваше приложение может опрашивать status() объекта Future , чтобы определить, когда инициализация завершена. После завершения инициализации ваше приложение может вызвать result() для получения результирующего AdapterInitializationStatus .

Методы, возвращающие Future имеют соответствующий метод «последний результат», который приложения могут использовать для получения самого последнего Future для данного действия. Например, firebase::gma::Initialize() имеет соответствующий метод firebase::gma::InitializeLastResult() , который возвращает Future , который ваше приложение может использовать для проверки статуса последнего вызова firebase::gma::Initialize() .

Если статус объекта Future — complete, а код ошибки — firebase::gma::kAdErrorCodeNone , то операция успешно завершена.

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

// Registers the OnCompletion callback. user_data is a pointer that is passed verbatim
// to the callback as a void*. This allows you to pass any custom data to the callback
// handler. In this case, the app has no data, so you must pass nullptr.
firebase::gma::InitializeLastResult().OnCompletion(OnCompletionCallback,
  /*user_data=*/nullptr);

// The OnCompletion callback function.
static void OnCompletionCallback(
  const firebase::Future<AdapterInitializationStatus>& future, void* user_data) {
  // Called when the Future is completed for the last call to firebase::gma::Initialize().
  // If the error code is firebase::gma::kAdErrorCodeNone,
  // then the SDK has been successfully initialized.
  if (future.error() == firebase::gma::kAdErrorCodeNone) {
    // success!
  } else {
    // failure.
  }
}

Шаг 5: Выберите формат рекламы для внедрения в ваше приложение.

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

Баннер

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

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

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

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

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

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

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

Награжден

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

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

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

Другие интересующие темы

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

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

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

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

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

Данные обычно появляются в течение часа, но могут появиться и через 48 часов.

(Необязательно) Используйте больше возможностей 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 позволяет проверять изменения в пользовательском интерфейсе, функциях или кампаниях по привлечению пользователей, чтобы выяснить, влияют ли они на ключевые показатели (такие как доход и удержание), прежде чем внедрять изменения повсеместно.