Instala el SDK de GMA de nueva generación

Para adoptar las mejoras de latencia y estabilidad de Android, usa el SDK de GMA de nueva generación. En esta guía, se explica cómo configurar el complemento de anuncios de Google para dispositivos móviles para Unity con el objetivo de usar el SDK de GMA de nueva generación para Android.

Requisitos previos

Antes de continuar, haz lo siguiente:

• Instala el complemento de anuncios de Google para dispositivos móviles para Unity, versión 10.6.0 o una posterior.

• Usa la versión 6.0 o una posterior de Unity.

  Nota: La compatibilidad con Unity 2021.3.41f1 a 2023.2 requiere una actualización del SDK de GMA de nueva generación, que se espera en la versión 0.22.0-beta01. Para saber cuándo estará disponible la versión 0.22.0-beta01, consulta las Notas de la versión.

• Completa la Introducción.

• Asegúrate de tener un proyecto de Unity.

Actualiza el nivel de API mínimo a 24

El SDK de GMA de nueva generación requiere un nivel de API mínimo de 24. Para actualizar el nivel de API mínimo, haz lo siguiente:

1. En la barra de menú, haz clic en File > Build Profiles > Player Settings > Android > Other Settings > Identification.
2. Establece el nivel de API mínimo en Android 7.0 "Nougat" (nivel de API 24) o una versión posterior.

Modifica el archivo de dependencia

Para habilitar el SDK de GMA de nueva generación para tus compilaciones de Android, haz lo siguiente:

1. En tu proyecto de Unity, navega al archivo Assets/GoogleMobileAds/Editor/GoogleMobileAdsDependencies.xml.

   • Si usas Unity Package Manager, ve a Packages > Google Mobile Ads for Unity > GoogleMobileAds > Editor > GoogleMobileAdsDependencies.xml.

2. Busca el elemento <androidPackage> con la especificación com.google.android.gms:play-services-ads.

3. Reemplaza el elemento por la versión más reciente disponible de com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:

   <androidPackage spec="com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.21.0-beta01">
     <repositories>
       <repository>https://maven.google.com/</repository>
     </repositories>
   </androidPackage>
   

4. Guarda el archivo.

Durante el proceso de compilación, el complemento de anuncios de Google para dispositivos móviles para Unity detecta la presencia del SDK de GMA de nueva generación y usa tu implementación.

Advertencia: Al actualizar el paquete del SDK de GMA de nueva generación, se sobrescribirá el archivo de dependencia. Si actualizas el paquete, repite los pasos anteriores.

Observa el ejemplo completo

En el siguiente ejemplo, se muestra el archivo GoogleMobileAdsDependencies.xml actualizado:

<dependencies>
  <androidPackages>
    <androidPackage spec="com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.21.0-beta01">
      <repositories>
        <repository>https://maven.google.com/</repository>
      </repositories>
    </androidPackage>
    <androidPackage spec="androidx.constraintlayout:constraintlayout:2.1.4">
      <repositories>
        <repository>https://maven.google.com/</repository>
      </repositories>
    </androidPackage>
    <androidPackage spec="androidx.lifecycle:lifecycle-process:2.6.2">
        <repositories>
            <repository>https://maven.google.com/</repository>
        </repositories>
    </androidPackage>
  </androidPackages>

  <iosPods>
    <iosPod name="Google-Mobile-Ads-SDK" version="~> 12.11.0">
      <sources>
        <source>https://github.com/CocoaPods/Specs</source>
      </sources>
    </iosPod>
  </iosPods>
</dependencies>