Comenzar

Selecciona la plataforma: Android iOS Unity Flutter

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

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

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

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

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

  3. Abre el menú del administrador de paquetes. Para ello, selecciona Window > Package Manager en el menú de Unity.

  4. Establece el menú desplegable de alcance del administrador en My Registries.

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

  1. Descarga la versión más reciente de .unitypackage desde GitHub.
  2. 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
});
GoogleMobileAdsController.cs

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.

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.

Implementar anuncios nativos

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