Comenzar

Esta guía está destinada a publicadores que deseen monetizar una app de C++ con AdMob, sin con Firebase. Si planeas incluir Firebase en tu app o si considera la página AdMob con Versión de Firebase de esta guía.

El primer paso para integrar el SDK de C++ de anuncios de Google para dispositivos móviles en una app es mostrar anuncios y obtener ingresos. Una vez que hayas integrado el SDK, puedes elegir un formato de anuncio, como intersticial o recompensado, y seguir los pasos implementarlo.

El SDK de C++ de anuncios de Google para dispositivos móviles incluye los SDK de iOS y Android de anuncios de Google para dispositivos móviles, y solo está disponible en esas plataformas. El SDK de C++ de anuncios de Google para dispositivos móviles hace el uso de construcciones de Firebase C++ para admitir operaciones asíncronas, por lo que reside en el espacio de nombres firebase::gma.

Si es la primera vez que utilizas esta guía, te recomendamos que descárguela y sígala usando la prueba C++ de anuncios de Google para dispositivos móviles de la app.

Requisitos previos

Configura la app en tu cuenta de AdMob

Completa los siguientes pasos para registrar tu aplicación como una aplicación de AdMob:

1. Accede o regístrate en para una cuenta de AdMob.

2. Registra tu app con AdMob Este paso crea una cuenta de AdMob aplicación con un ID de aplicación de AdMob único que se necesitará más adelante en esta guía.

Instala el SDK de C++ de anuncios de Google para dispositivos móviles

Dado que el SDK de C++ de anuncios de Google para dispositivos móviles reside en el espacio de nombres firebase::gma, descarga el SDK de Firebase C++ y, luego, descomprímelo en el directorio que desees.

El SDK de Firebase C++ no es específico de una plataforma, pero sí requiere configuraciones de bibliotecas específicas de la plataforma.

¡Listo! Configuraste tu app de C++ a fin de usar el SDK de C++ de anuncios de Google para dispositivos móviles. sin ningún otro servicio de Firebase.

Configura el ID de app de AdMob de tu app

Cómo inicializar el SDK de anuncios de Google para dispositivos móviles

Antes de cargar anuncios, haz que tu app inicialice el SDK de C++ de anuncios de Google para dispositivos móviles. Para ello, haz lo siguiente: Llama a firebase::gma::Initialize(), que inicializa el SDK y completa un firebase::Future una vez que se complete la inicialización (o después de 30 segundos tiempo de espera). Esto debe hacerse una sola vez, idealmente cuando se inicia la app.

Los anuncios se pueden cargar previamente con el SDK de C++ de anuncios de Google para dispositivos móviles o con los SDK de socios de mediación. después de llamar a Initialize(). Si necesita obtener el consentimiento de los usuarios de la en el Espacio Económico Europeo (EEE), define las marcas específicas de la solicitud (como tag_for_child_directed_treatment o tag_for_under_age_of_consent) De lo contrario, tome medidas antes de cargar los anuncios, asegúrese de hacerlo invocando firebase::gma::SetRequestConfiguration() antes de inicializar Google Mobile SDK de Ads C++. Para obtener más información, consulta nuestra Segmentación.

Este es un ejemplo de cómo llamar a 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.
}

Usa un Future para supervisar el estado de una llamada de método

Un Future te permite determinar el estado de finalización de tu llamadas de método asíncronas.

Por ejemplo, cuando tu app llama a firebase::gma::Initialize(), se crea una nueva firebase::Future se crea y se muestra. Luego, la app puede sondear status() de Future para determinar cuándo se completó la inicialización. Una vez completada, tu app puede invocar a result() para obtener el resultado. AdapterInitializationStatus

Los métodos que muestran un Future tienen un "último resultado" correspondiente que que las apps pueden usar para recuperar el objeto Future más reciente de una acción determinada. Para Por ejemplo, firebase::gma::Initialize() tiene un método correspondiente llamado firebase::gma::InitializeLastResult(), que muestra un Future que indica tu app que puedes usar para verificar el estado de la última llamada a firebase::gma::Initialize().

Si el estado de Future está completo y su código de error es firebase::gma::kAdErrorCodeNone, la operación se completó con éxito.

También puedes registrar devoluciones de llamada que se invocarán cuando se complete una Future. En En algunos casos, la devolución de llamada se ejecutará en un subproceso diferente, así que asegúrate de que tu código tiene seguridad en los subprocesos. Este fragmento de código usa un puntero de función para la devolución de llamada:

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

Seleccionar un formato de anuncio

Se importó el SDK de C++ de anuncios de Google para dispositivos móviles y ya puede implementar una anuncio. AdMob ofrece diferentes formatos de anuncios para que puedas elegir que mejor se adapte a la experiencia del usuario de tu aplicación.

Banner

Anuncios rectangulares que aparecen en la parte superior o inferior de la pantalla del dispositivo. Los anuncios de banner permanecen en la pantalla mientras los usuarios interactúan con la aplicación. se actualizarán automáticamente después de un período determinado. Si es la primera vez que utilizas dispositivos móviles publicidad, son un excelente punto de partida.

Implementa anuncios en forma de banner

Intersticial

Anuncios de pantalla completa que cubren la interfaz de una app hasta que el usuario los cierra. Se recomienda su uso en pausas naturales en el flujo de ejecución de una app, como entre los niveles de un juego o justo después de completar una tarea.

Implementa anuncios intersticiales

Recompensado

Anuncios que recompensan a los usuarios por mirar videos cortos y por interactuar con los anuncios y encuestas. Se utiliza para monetizar apps gratuitas.

Implementa anuncios recompensados