Esta guía está destinada a publicadores que deseen monetizar una app de C++ con AdMob, sin usar Firebase. Si planeas incluir Firebase en tu app o si lo estás considerando, consulta la versión de esta guía para AdMob con Firebase.
El primer paso para mostrar anuncios y obtener ingresos es integrar el SDK de Google Mobile Ads para C++ en una app. Una vez que integres el SDK, podrás elegir un formato de anuncio, como intersticial o recompensado, y seguir los pasos para implementarlo.
El SDK de C++ de anuncios de Google para dispositivos móviles une los SDKs de anuncios de Google para iOS y Android, y solo está disponible en esas plataformas. El SDK de C++ de anuncios de Google para dispositivos móviles hace
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 usas esta guía, te recomendamos que descargues la app de prueba de C++ de anuncios de Google para dispositivos móviles y que la uses a fin de seguir los temas que se tratan aquí.
Requisitos previos
Android
- Usa Android Studio 3.2 o una versión posterior.
- Asegúrate de que el archivo de compilación de tu app use los siguientes valores:
- Una
minSdkVersion
de 16 o más - Una
compileSdkVersion
de 28 o superior
- Una
iOS
- Usa Xcode 13 o una versión posterior
- Orientación a iOS 10.0 o versiones posteriores
Configura la app en tu cuenta de AdMob
Completa los siguientes pasos para registrar tu aplicación como una aplicación de AdMob:
Accede o regístrate para obtener una cuenta de AdMob.
Registra tu app en AdMob. Con este paso, se crea una app de AdMob con un ID de app de AdMob único que se necesita 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
de firebase::gma
, descarga el SDK de C++ de Firebase
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 una plataforma.
Android
Recomendamos usar CMake, pero puedes encontrar instrucciones para ndk-build en nuestra
guía general de introducción
del SDK de Firebase C++ para
vincular libfirebase_app.a
y libfirebase_gma.a
a tu app.
En el archivo
gradle.properties
de tu proyecto, especifica la ubicación del SDK descomprimido:systemProp.firebase_cpp_sdk.dir=FULL_PATH_TO_SDK
Agrega el siguiente contenido al archivo
settings.gradle
de tu proyecto: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"
En el archivo Gradle (generalmente
app/build.gradle
) de tu módulo (a nivel de app), agrega el siguiente contenido, que incluye la dependencia de la biblioteca para el SDK de C++ de anuncios de Google para dispositivos móviles.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 }
Agrega el siguiente contenido al archivo
CMakeLists.txt
de tu proyecto.# 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}")
Sincroniza tu app para garantizar que todas las dependencias tengan las versiones necesarias.
iOS
Los pasos que se indican en esta sección son un ejemplo de cómo agregar el SDK de C++ de anuncios de Google para dispositivos móviles a tu proyecto de iOS.
Ejecuta el siguiente comando para obtener la versión 1 de CocoaPods o una más reciente:
sudo gem install cocoapods --pre
Agrega el Pod de anuncios de Google para dispositivos móviles del SDK descomprimido.
Crea un Podfile si aún no tienes uno:
cd APP_DIRECTORY
pod init
En tu Podfile, agrega los Pods del SDK de C++ de anuncios de Google para dispositivos móviles, el SDK de Google User Messaging Platform y el SDK principal mínimo de Firebase (obligatorio para el SDK de C++ de GMA):
pod 'Firebase/CoreOnly' pod 'Google-Mobile-Ads-SDK' pod 'GoogleUserMessagingPlatform'
Instala los pods y abre el archivo
.xcworkspace
en Xcode.pod install
open APP.xcworkspace
Agrega los siguientes frameworks del SDK de Firebase C++ al proyecto:
xcframeworks/firebase.xcframework
xcframeworks/firebase_gma.xcframework
¡Listo! Tu app de C++ está configurada para usar el SDK de C++ de Google Mobile Ads sin ningún otro servicio de Firebase.
Configura el ID de app de AdMob de tu app
Android
Sigue el paso 3 de Configura tu app como se describe en la guía del SDK de anuncios para dispositivos móviles para Android y, luego, regresa a esta página.
iOS
Sigue el paso Actualiza tu archivo Info.plist según se describe en la Guía de iOS del SDK de anuncios para dispositivos móviles y, luego, regresa a esta página.
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 llamando a firebase::gma::Initialize()
, que inicializa el SDK y completa un firebase::Future
una vez que se completa la inicialización (o después de un tiempo de espera de 30 segundos). Esto solo se debe hacer una 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 SDKs de socios de mediación cuando se llama a Initialize()
. Si necesitas obtener el consentimiento de los usuarios en el Espacio Económico Europeo (EEE), configura las marcas específicas de la solicitud que hagan falta (por ejemplo, tag_for_child_directed_treatment
o tag_for_under_age_of_consent
), o realiza la acción pertinente antes de cargar anuncios. Asegúrate de hacer esto invocando firebase::gma::SetRequestConfiguration()
antes de inicializar el SDK de C++ de anuncios de Google para dispositivos móviles. Para obtener más información, consulta nuestra guía de segmentación.
Este es un ejemplo de cómo llamar a 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.
}
Usa un Future
para supervisar el estado de una llamada de método
Future
te permite determinar el estado de las llamadas a métodos asíncronos.
Por ejemplo, cuando tu app llama a firebase::gma::Initialize()
, se crea
y se muestra un nuevo firebase::Future
. Luego, la app puede consultar el
status()
de Future
para determinar cuándo se completó la inicialización.
Una vez completada, tu app puede invocar a result()
para obtener el
AdapterInitializationStatus
resultante.
Los métodos que muestran un Future
tienen un método “LastResult” correspondiente que
las apps pueden usar para recuperar el Future
más reciente de una acción determinada. Por
ejemplo, firebase::gma::Initialize()
tiene un método correspondiente llamado
firebase::gma::InitializeLastResult()
, que muestra un Future
que tu app puede
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
algunos casos, la devolución de llamada se ejecutará en un subproceso diferente, por lo que debes asegurarte
de que tu código sea seguro para los subprocesos. En este fragmento de código, se 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.
}
}
Selecciona un formato de anuncio
Se importó el SDK de C++ de anuncios de Google para dispositivos móviles y ya puedes implementar un anuncio. AdMob ofrece diferentes formatos de anuncios para que puedas elegir el que mejor se adapte a la experiencia del usuario de tu app.
Banner
Anuncios rectangulares que aparecen en la parte superior o inferior de la pantalla del dispositivo. Los anuncios en forma de banner permanecen en la pantalla mientras los usuarios interactúan con la app y se pueden actualizar automáticamente después de un período determinado. Si eres nuevo en la publicidad para dispositivos móviles, este formato es una gran alternativa para comenzar.
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 usarlos durante 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 encuestas y anuncios con juegos. Se usa para monetizar apps de juegos gratuitos.