Cómo comenzar

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 de 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

  1. Para abrir la configuración del administrador de paquetes, selecciona la opción de menú de Unity Edit > Project Settings > Package Manager.

  2. Agrega OpenUPM como un registro con alcance a la ventana del Administrador de paquetes:

    Name: OpenUPM
URL: https://package.openupm.com
Scopes: com.google

  3. Para abrir el menú del administrador de paquetes, selecciona la opción de menú de Unity Window > Package Manager.

  4. Establece el menú desplegable de alcance del administrador para seleccionar Mis registros.

  5. 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

  1. Descarga la versión más reciente de .unitypackage desde GitHub.
  2. 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 obtener requisitos específicos o 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.

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 en 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.

Implementa anuncios nativos

Recompensado

Las unidades 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.

Implementa anuncios recompensados