El complemento de Google Mobile Ads para Unity permite que los desarrolladores de Unity publiquen anuncios de Google para dispositivos móviles en apps para Android y para iOS sin necesidad de escribir código de Java ni Objective-C. Proporciona una interfaz en C# para solicitar anuncios, la cual usan las secuencias de comandos C# de tu proyecto de Unity.
Esta guía está dirigida a los publicadores que desean monetizar una app de Unity.
Requisitos previos
- Usar Unity Editor 2019.4 o posterior
- Para realizar la implementación en iOS:
- Xcode 16.0 o posterior
- Segmentación para iOS 12.0 o posterior
- CocoaPods
- Para realizar la implementación en Android:
- Nivel de API de Android mínimo: 23 o superior
- Segmentación para nivel de API de Android 34 o superior
- Recomendación: Crea una cuenta de AdMob y registra una app para iOS o Android
El nivel de API de Android se establece en Project Settings > Player > Android > Other Settings > Other Settings.
Importa el complemento Mobile Ads para Unity
OpenUPM-CLI
Si tienes instalada la CLI de OpenUPM, puedes instalar el registro de OpenUPM con el siguiente comando:
openupm add com.google.ads.mobile
Cómo quitar recursos del complemento .unitypackage
Si migras de .unitypackage
a OpenUPM, debes desinstalar manualmente los recursos de la ubicación anterior. Quita los siguientes directorios importados desde .unitypackage
:
- Assets/ExternalDependencyManager
- Assets/GoogleMobileAds
- Assets/Plugins/Android/googlemobileads-unity.aar
- Assets/Plugins/Android/GoogleMobileAdsPlugin
- Assets/Plugins/iOS/GADUAdNetworkExtras
- Assets/Plugins/iOS/unity-plugin-library.a
OpenUPM
- Abre la configuración del administrador de paquetes. Para ello, selecciona la opción del menú de Unity Edit > Project Settings > Package Manager.
Agrega OpenUPM como un registro con alcance en la ventana del Administrador de paquetes:
Name: OpenUPM URL: https://package.openupm.com Scopes: com.google
Abre el menú del administrador de paquetes. Para ello, selecciona Window > Package Manager en el menú de Unity.
Establece el menú desplegable de alcance del administrador en My Registries.
Selecciona el paquete Google Mobile Ads for Unity en la lista de paquetes y presiona Install.
Cómo quitar recursos del complemento .unitypackage
Si migras de .unitypackage
a OpenUPM, debes desinstalar manualmente los recursos de la ubicación anterior. Quita los siguientes directorios importados desde .unitypackage
:
- Assets/ExternalDependencyManager
- Assets/GoogleMobileAds
- Assets/Plugins/Android/googlemobileads-unity.aar
- Assets/Plugins/Android/GoogleMobileAdsPlugin
- Assets/Plugins/iOS/GADUAdNetworkExtras
- Assets/Plugins/iOS/unity-plugin-library.a
Importar desde GitHub
- Descarga la versión más reciente de
.unitypackage
desde GitHub. - Importa el archivo
.unitypackage
. Para ello, selecciona Assets > Import package > Custom Package en el menú de Unity y, luego, importa todos los elementos.
Cómo incluir dependencias externas
El complemento Google Mobile Ads para Unity se distribuye con la biblioteca Unity Play Services Resolver. Esta biblioteca está diseñada para que la usen los complemento de Unity que requieran acceso a bibliotecas específicas de Android, como AAR, o CocoaPods de iOS. Brinda a los complementos de Unity la capacidad de declarar dependencias, que luego se resuelven y se copian automáticamente en tu proyecto de Unity.
Sigue estos pasos para garantizar que tu proyecto incluya todas las dependencias:
Android
Ve a Project Settings > Player > Android > Publishing Settings > Build y selecciona lo siguiente:
- Plantilla principal personalizada de Gradle
- Plantilla principal personalizada de Gradle
En el editor de Unity, selecciona Assets > External Dependency Manager > Android Resolver > Resolve para que la biblioteca de External Dependency Manager de Unity copie las dependencias declaradas en el directorio Assets/Plugins/Android
de tu app de Unity.
iOS
Unity para iOS usa CocoaPods para identificar y administrar las dependencias. Consulta la documentación de CocoaPods para conocer los requisitos específicos o los pasos de resolución de problemas relacionados con tus dependencias de iOS.
Las dependencias del complemento Google Mobile Ads para Unity se indican en Assets/GoogleMobileAds/Editor/GoogleMobileAdsDependencies.xml
.
Configura tu ID de app que se monetiza mediante AdMob
En el editor de Unity, selecciona Assets > Google Mobile Ads > Settings en el menú.
Ingresa tu ID de app que se monetiza mediante AdMob para Android y para iOS en cada campo.
Inicializa el SDK
Antes de cargar anuncios, haz que tu app inicialice el SDK de anuncios de Google para dispositivos móviles por medio de una llamada a MobileAds.Initialize()
. Esto solo se debe hacer una vez, idealmente cuando se inicia la app.
Aquí te mostramos un ejemplo de cómo llamar a MobileAds.Initialize()
:
MobileAds.Initialize((InitializationStatus initstatus) =>
{
if (initstatus == null)
{
Debug.LogError("Google Mobile Ads initialization failed.");
return;
}
Debug.Log("Google Mobile Ads initialization complete.");
// Google Mobile Ads events are raised off the Unity Main thread. If you need to
// access UnityEngine objects after initialization,
// use MobileAdsEventExecutor.ExecuteInUpdate(). For more information, see:
// https://developers.google.com/admob/unity/global-settings#raise_ad_events_on_the_unity_main_thread
});
Si usas la mediación, espera a la devolución de llamada para cargar los anuncios, ya que esto te permitirá asegurarte de que se inicialicen todos los adaptadores de mediación.
Selecciona un formato de anuncio
El SDK de anuncios de Google para dispositivos móviles ahora se incluye en tu app de Unity cuando la implementas en las plataformas de Android o iOS. Ya tienes todo listo para implementar un anuncio. AdMob ofrece diferentes formatos de anuncio, lo que te permite elegir el que proporcione la mejor experiencia del usuario.
Banners
Las unidades de anuncios de banner muestran anuncios rectangulares que ocupan una parte del diseño de una app y se pueden actualizar automáticamente después de un período determinado. Esto significa que los usuarios verán un anuncio nuevo en intervalos regulares, incluso si permanecen en la misma pantalla de tu app. Además, este formato de anuncio es el más fácil de implementar.
Implementar anuncios de banner
Intersticiales
Las unidades de anuncios intersticiales muestran anuncios de página completa en tu app y se pueden colocar en pausas y transiciones naturales de la interfaz de tu app (por ejemplo, después de completar un nivel en una app de juego).
Implementar anuncios intersticiales
Nativos
Los anuncios nativos te permiten personalizar la manera en que se presentan los recursos, como los títulos y los llamados a la acción, en tus apps. Si aplicas tu propio diseño al anuncio, puedes crear presentaciones naturales y discretas de ese anuncio que contribuyan a una experiencia del usuario enriquecida.
Recompensados
Las unidades de anuncios recompensados permiten que los usuarios jueguen, respondan encuestas o miren videos para obtener recompensas en la aplicación, como monedas, vidas adicionales o puntos. Puedes establecer recompensas distintas para cada unidad de anuncios y especificar los elementos y los valores de las recompensas obtenidas por el usuario.
Implementar anuncios recompensados
Intersticiales recompensados
Los intersticiales recompensados son un nuevo tipo de formato de anuncio incentivado que te permite ofrecer recompensas, como monedas o vidas adicionales, por los anuncios que aparecen automáticamente durante las transiciones naturales de la app.
A diferencia de los anuncios recompensados, no se requiere que los usuarios habiliten ninguna función para ver un intersticial recompensado.
En vez del mensaje de habilitación que se muestra en los anuncios recompensados, los intersticiales recompensados requieren una pantalla de introducción que anuncia la recompensa y les da a los usuarios la oportunidad de rechazarla si así lo desean.
Implementar anuncios intersticiales recompensados
Inicio de aplicación
El formato de anuncios para inicio de aplicación aparece cuando los usuarios abren tu app o vuelven a ella. Estos anuncios se superponen a la pantalla de carga.
Implementar anuncios para inicio de aplicación