Начать

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

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

Google Mobile Ads C++ SDK оборачивает Google Mobile Ads iOS и Android SDK и доступен только на этих платформах. Google Mobile Ads C++ SDK использует конструкции Firebase C++ для поддержки асинхронных операций, поэтому он находится в пространстве имен firebase::gma .

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

Предпосылки

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

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

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

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

Установите Google Mobile Ads C++ SDK

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

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

Все готово! Ваше приложение C++ настроено на использование Google Mobile Ads C++ SDK без каких-либо других служб Firebase.

Настройте идентификатор приложения AdMob вашего приложения

Инициализируйте Google Mobile Ads SDK

Перед загрузкой рекламы, ваше приложение должно инициализировать Google Mobile Ads C++ SDK, вызвав firebase::gma::Initialize() , который инициализирует SDK и завершает firebase::Future после завершения инициализации (или после 30-секундного тайм-аута). Это нужно сделать только один раз, в идеале при запуске приложения.

Рекламные объявления могут быть предварительно загружены Google Mobile Ads C++ SDK или SDK партнеров-посредников при вызове Initialize() . Если вам необходимо получить согласие пользователей в Европейской экономической зоне (ЕЭЗ), установить какие-либо флаги, специфичные для запроса (например, tag_for_child_directed_treatment или tag_for_under_age_of_consent ), или иным образом предпринять действия перед загрузкой рекламы, убедитесь, что вы сделали это, вызвав firebase::gma::SetRequestConfiguration() перед инициализацией Google Mobile Ads C++ SDK. Для получения дополнительной информации см. наше руководство по таргетингу .

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

// 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.
}

// 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 — завершено, а его код ошибки — 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.
  }
}

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

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

Баннер

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

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

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

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

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

Награжден

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

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