Начать

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

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

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

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

Предварительные условия

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

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

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

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

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

Поскольку SDK Google Mobile Ads C++ находится в пространстве имен 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 предлагает множество различных форматов объявлений, поэтому вы можете выбрать тот, который лучше всего соответствует пользовательскому опыту вашего приложения.

Баннер

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

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

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

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

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

Награжден

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

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