Comenzar

Integrar el SDK de anuncios de Google para dispositivos móviles (beta) en una app es el primer paso para mostrar anuncios y obtener ingresos. Una vez que hayas integrado el SDK, podrás elegir un formato de anuncio (como nativo o de video recompensado) y seguir los pasos para implementarlo.

Antes de comenzar

Para preparar tu app, completa los pasos que se indican en las siguientes secciones.

Requisitos previos de la app

  • Asegúrate de que el archivo de compilación de tu app use los siguientes valores:

    • Versión mínima del SDK: 24 o posterior
    • Versión de compilación del SDK: 35 o posterior
  • En el caso de las apps de Kotlin, usa la versión mínima de Kotlin 1.9.

Configura tu app en tu cuenta de AdMob

Para registrar tu app como una app de AdMob, completa los siguientes pasos:

  1. Accede o regístrate para obtener una cuenta de AdMob.

  2. Registra tu app en AdMob. Este paso te permite crearla con un ID de app de AdMob, que es único y que necesitarás más adelante en esta guía.

Cómo configurar tu app

  1. En el archivo de configuración de Gradle, incluye el repositorio de Maven de Google y el repositorio central de Maven:

    Kotlin

    pluginManagement {
  repositories {
    google()
    mavenCentral()
    gradlePluginPortal()
  }
}

dependencyResolutionManagement {
  repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
  repositories {
    google()
    mavenCentral()
  }
}

rootProject.name = "My Application"
include(":app")

    Groovy

    pluginManagement {
  repositories {
    google()
    mavenCentral()
    gradlePluginPortal()
  }
}

dependencyResolutionManagement {
  repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
  repositories {
    google()
    mavenCentral()
  }
}

rootProject.name = "My Application"
include ':app'

  2. Agrega las dependencias del SDK de anuncios de Google para dispositivos móviles (beta) a tu archivo de compilación a nivel de la app:

    Kotlin

    dependencies {
  implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.21.0-beta01")
}

    Groovy

    dependencies {
  implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.21.0-beta01'
}

  3. Haz clic en Sincronizar ahora. Para obtener detalles sobre la sincronización, consulta cómo sincronizar proyectos con archivos de Gradle.

Inicializa el SDK de anuncios de Google para dispositivos móviles (beta)

Llama a MobileAds.initialize() para inicializar el SDK de anuncios de Google para dispositivos móviles (beta). Se debe llamar a este método en un subproceso en segundo plano. Si no lo haces, es posible que se produzca un error de "Aplicación no responde" (ANR).

Kotlin

import com.google.android.libraries.ads.mobile.sdk.MobileAds
import com.google.android.libraries.ads.mobile.sdk.initialization.InitializationConfig
import kotlinx.coroutines.CoroutineScope
import kotlinx.coroutines.Dispatchers
import kotlinx.coroutines.launch

class MainActivity : AppCompatActivity() {
  override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    setContentView(R.layout.activity_main)

    val backgroundScope = CoroutineScope(Dispatchers.IO)
    backgroundScope.launch {
      // Initialize Google Mobile Ads SDK (beta) on a background thread.
      MobileAds.initialize(
        this@MainActivity,
        // Sample AdMob app ID: ca-app-pub-3940256099942544~3347511713
        InitializationConfig.Builder("SAMPLE_APP_ID").build()
      ) {
        // Adapter initialization is complete.
      }
      // Other methods on MobileAds can now be called.
    }
  }
}

Java

import com.google.android.libraries.ads.mobile.sdk.MobileAds;
import com.google.android.libraries.ads.mobile.sdk.initialization.InitializationConfig;

public class MainActivity extends AppCompatActivity {
  protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);

    new Thread(
            () -> {
              // Initialize Google Mobile Ads SDK (beta) on a background thread.
              MobileAds.initialize(
                  this,
                  // Sample AdMob app ID: ca-app-pub-3940256099942544~3347511713
                  new InitializationConfig.Builder("SAMPLE_APP_ID")
                      .build(),
                  initializationStatus -> {
                    // Adapter initialization is complete.
                  });
              // Other methods on MobileAds can now be called.
            })
        .start();
  }
}

Este método inicializa el SDK y llama a un objeto de escucha de finalización una vez que se completan las inicializaciones del adaptador y del SDK de anuncios de Google para dispositivos móviles (beta), o bien una vez que transcurre un tiempo de espera de 30 segundos. Esto solo se debe hacer una vez, idealmente cuando se inicia la app.

Una vez realizada la inicialización, el SDK de anuncios de Google para dispositivos móviles (beta) o los SDKs de socios de mediación pueden precargar anuncios. Si necesitas obtener el consentimiento de los usuarios ubicados en el Espacio Económico Europeo (EEE), configura los parámetros específicos de la solicitud que se requieran, como RequestConfiguration.TagForChildDirectedTreatment o RequestConfiguration.TagForUnderAgeOfConsent, o toma las medidas pertinentes antes de cargar anuncios. Asegúrate de hacer esto antes de inicializar el SDK de anuncios de Google para dispositivos móviles (beta).

Selecciona un formato del anuncio

Ahora que ya se importó el SDK de anuncios de Google para dispositivos móviles (beta), tienes todo listo para implementar un anuncio. AdMob ofrece una serie de formatos de anuncios diferentes, por lo que puedes elegir el que mejor se ajuste a la experiencia del usuario de tu app.

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.

Implementa anuncios en forma de banner

Intersticial

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

Implementa anuncios intersticiales

Recompensado

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.

Implementa anuncios recompensados

Intersticial recompensado

Los anuncios intersticiales recompensados son un nuevo tipo de formato de anuncios con incentivo 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 acepten ver un intersticial recompensado.

En vez del mensaje de aceptación que se muestra en los anuncios recompensados, los intersticiales recompensados requieren una pantalla de introducción que anuncie 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.

Implementa anuncios de aplicación abierta