El complemento 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 tener que escribir código Java ni Objective-C. El complemento proporciona una interfaz de lenguaje C# para solicitar anuncios, utilizada en tu proyecto de Unity por secuencias de comandos en ese mismo lenguaje.
Esta guía está destinada a publicadores que deseen monetizar una app para Unity.
Requisitos previos
- Usa Unity 2019.4 o una versión posterior
- Para implementar en iOS, haz lo siguiente:
- Xcode 15.3 o una versión posterior
- Orienta a iOS 12.0 o versiones posteriores
- CocoaPods
- Para implementar en Android, haz lo siguiente:
- Nivel de API de Android mínimo 21 o superior
- Orienta tu app al nivel de API 34 de Android o versiones posteriores
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
Quita los recursos del complemento .unitypackage
Si migras de un .unitypackage
a OpenUPM, debes desinstalar manualmente los recursos de la ubicación anterior. Quita los siguientes directorios que se importaron desde .unitypackage
:
- Assets/ExternalDependencyManager
- Recursos/GoogleMobileAds
- Assets/Plugins/Android/googlemobileads-unity.aar
- Assets/Plugins/Android/GoogleMobileAdsPlugin
- Assets/Plugins/iOS/GADUAdNetworkExtras
- Assets/Plugins/iOS/unity-plugin-library.a
OpenUPM
- Para abrir la configuración del administrador de paquetes, selecciona la opción de menú de Unity Edit > Project Settings > Package Manager.
Agrega OpenUPM como un registro con alcance a la ventana del Administrador de paquetes:
Name: OpenUPM URL: https://package.openupm.com Scopes: com.google
Para abrir el menú del administrador de paquetes, selecciona la opción de menú de Unity Window > Package Manager.
Establece el menú desplegable de alcance del administrador para seleccionar Mis registros.
Selecciona el paquete Google Mobile Ads para Unity en la lista de paquetes y presiona Install.
Quita los recursos del complemento .unitypackage
Si migras de un .unitypackage
a OpenUPM, debes desinstalar manualmente los recursos de la ubicación anterior. Quita los siguientes directorios que se importaron desde .unitypackage
:
- Assets/ExternalDependencyManager
- Recursos/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 la opción del menú de Unity Assets > Import package > Custom Package e importa todos los elementos.
Cómo incluir dependencias externas
El complemento Google Mobile Ads para Unity se distribuye con la biblioteca de Unity Play Services Resolver. Esta biblioteca está diseñada para que la use cualquier complemento de Unity que requiera acceso a bibliotecas específicas de Android, como AAR o CocoaPods de iOS. Proporciona a los complementos de Unity la capacidad de declarar dependencias, que luego se resuelven y copian automáticamente en tu proyecto de Unity.
Sigue estos pasos para asegurarte de que tu proyecto incluya todas las dependencias:
Android
Ve a Project Settings > Player > Android > Publishing Settings > Build y selecciona lo siguiente:
- Plantilla principal de Gradle personalizada
- Plantilla de propiedades de Gradle personalizada
En el editor de Unity, selecciona Assets > External Dependency Manager > Android Resolver > Resolve para que la biblioteca de Unity External Dependency Manager copie las dependencias declaradas en el directorio Assets/Plugins/Android
de tu app para Unity.
iOS
Unity para iOS usa CocoaPods para identificar y administrar dependencias. Consulta la documentación de CocoaPods para conocer los requisitos específicos o los pasos para solucionar problemas relacionados con tus dependencias de iOS.
Las dependencias del complemento Google Mobile Ads para Unity se muestran en Assets/GoogleMobileAds/Editor/GoogleMobileAdsDependencies.xml
.
Configura el Ad Manager ID de tu app
En Unity Editor, selecciona Assets > Google Mobile Ads > Settings en el menú.
Ingresa tu ID de app de Ad Manager 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 llamando a MobileAds.Initialize()
. Esto solo se debe hacer una vez, idealmente cuando se inicia la app.
Este es un ejemplo de cómo llamar a Initialize()
dentro del método Start()
de una secuencia de comandos adjunta a un GameObject
:
...
using GoogleMobileAds.Api;
...
public class GoogleMobileAdsDemoScript : MonoBehaviour
{
public void Start()
{
// Initialize the Google Mobile Ads SDK.
MobileAds.Initialize(initStatus => { });
}
}
Si usas mediación, espera a que se produzca la devolución de llamada antes de cargar anuncios para asegurarte de que se inicialicen todos los adaptadores de mediación.
Selecciona un formato del anuncio
El SDK de anuncios de Google para dispositivos móviles ahora se incluye en tu app para Unity cuando se implementa en la plataforma de Android o iOS. Ya está todo listo para implementar un anuncio. AdMob ofrece diferentes formatos de anuncios para que puedas elegir el que ofrezca la mejor experiencia del usuario.
Banner
Las unidades de anuncios de banner muestran anuncios rectangulares que ocupan una parte del diseño de una app. Se pueden actualizar automáticamente después de un período determinado. Esto significa que los usuarios ven un anuncio nuevo a intervalos regulares, incluso si permanecen en la misma pantalla de tu app. También son el formato de anuncio más fácil de implementar.
Implementa anuncios en forma de banner
Intersticial
Las unidades de anuncios intersticiales muestran anuncios de página completa en tu app. Colócalas en pausas y transiciones naturales en la interfaz de tu app, como después de completar un nivel en una app de juegos.
Implementa anuncios intersticiales
Nativo
Los anuncios nativos son anuncios en los que puedes personalizar la forma en que se presentan los recursos, como los encabezados y las llamadas a la acción, en tus apps. Si aplicas diseño al anuncio por tu cuenta, puedes crear presentaciones de anuncios naturales y discretas que pueden contribuir a una experiencia del usuario enriquecida.
Recompensado
Los bloques de anuncios recompensados permiten que los usuarios jueguen, respondan encuestas o miren videos para obtener recompensas en la app, como monedas, vidas extra o puntos. Puedes establecer recompensas distintas para cada unidad de anuncios y especificar los valores y los elementos de las recompensas que recibió el usuario.