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 iOS y Android sin tener que escribir código Java ni Objective-C. El complemento proporciona una interfaz de C# para solicitar anuncios que usan las secuencias de comandos de ese lenguaje en tu proyecto de Unity.

Esta guía está dirigida a los publicadores que deseen monetizar una app de Unity.

Requisitos previos

• Usa Unity 2019.4 o una versión posterior
• Realiza la implementación en iOS:
  • Xcode 15.3 o una versión más reciente
  • Orientación a iOS 12.0 o versiones posteriores
  • CocoaPods
• Para implementar en Android, haz lo siguiente:
  • Nivel mínimo de API de Android de 21 o superior
  • Orientación al nivel de API 31 de Android o superior

El nivel de la API de Android se establece en Project Settings > Player > Android > Other Settings > Other Settings.

Importa el complemento Mobile Ads for 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

Quitar .unitypackage de recursos del complemento

Si migras de usar un .unitypackage a usar OpenUPM, debes desinstalar los recursos de forma manual de la ubicación anterior. Quita los siguientes directorios que se importaron de .unitypackage:

• Recursos/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. 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 específico a la ventana 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 del menú de Unity Window > Package Manager.

4. Configura el menú desplegable de permisos de administrador para seleccionar Mis registros.

   

5. Selecciona el paquete Google Mobile Ads for Unity (Anuncios de Google para dispositivos móviles para Unity) de la lista de paquetes y presiona Install (Instalar).

Quitar .unitypackage de recursos del complemento

Si migras de usar un .unitypackage a usar OpenUPM, debes desinstalar los recursos de forma manual de la ubicación anterior. Quita los siguientes directorios que se importaron de .unitypackage:

• Recursos/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 seleccionando la opción del menú de Unity Assets > Import package > Custom Package y, luego, importa todos los elementos.

Cómo incluir dependencias externas

El complemento Google Mobile Ads para Unity se distribuye con la biblioteca de resolución de Servicios de Play de Unity. 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 automáticamente y se copian en tu proyecto de Unity.

Importante: Usa el SDK de anuncios de Google para dispositivos móviles más reciente para tener acceso a todas las funciones de cumplimiento de privacidad.

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 personalizada de Gradle principal
• Plantilla personalizada de propiedades de Gradle

En el editor de Unity, selecciona Assets > External Dependency Manager > Android Resolver > Resolve para que la biblioteca Unity External Dependency Manager 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 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 enumeran 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 en cada campo para iOS y Android.

Inicializa el SDK

Antes de cargar anuncios, llama a MobileAds.Initialize() para que tu app inicialice el SDK de anuncios de Google para dispositivos móviles. Esto debe hacerse solo una vez, idealmente cuando se inicia la app.

Advertencia: Los anuncios se pueden cargar previamente con el SDK de anuncios de Google para dispositivos móviles o los SDKs de socios de mediación tras una llamada a MobileAds.Initialize(). Si necesitas obtener el consentimiento de los usuarios del Espacio Económico Europeo (EEE), configura las marcas específicas de la solicitud, como tagForChildDirectedTreatment o tag_for_under_age_of_consent, o toma medidas antes de cargar anuncios. Asegúrate de hacer esto antes de inicializar el SDK de anuncios de Google para dispositivos móviles.

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 la mediación, espera hasta que se produzca la devolución de llamada antes de cargar anuncios para asegurarte de que se inicialicen todos los adaptadores de mediación.

Seleccionar un formato de 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 varios formatos de anuncios diferentes, por lo que puedes elegir el que brinde la mejor experiencia del usuario.

Banner

Los bloques de anuncios en forma de banner muestran anuncios rectangulares que ocupan una parte del diseño de la app. Pueden actualizarse 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 en tu app. También son el formato de anuncio más sencillo de implementar.

Implementa anuncios en forma de banner

Intersticial

Las unidades de anuncios intersticiales muestran anuncios de página completa en tu app. Colócalos en pausas y transiciones naturales en la interfaz de la app, por ejemplo, después de completar un nivel en una app de juego.

Implementa anuncios intersticiales

Nativo

Los anuncios nativos son anuncios en los que puedes personalizar la forma en que se presentan en tus apps recursos, como los títulos y los llamados a la acción. Si aplicas un estilo al anuncio tú mismo, 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, realicen encuestas o miren videos para obtener recompensas en la app, como monedas, vidas adicionales o puntos. Puedes establecer diferentes recompensas para distintas unidades de anuncios y especificar los elementos y valores de la recompensa que recibió el usuario.

Implementa anuncios recompensados