Comenzar

Selecciona la plataforma: Android iOS Unity Flutter

La integración del SDK de anuncios de Google para dispositivos móviles 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, sigue 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: 23 o posterior
    • Versión de compilación del SDK de 34 o una posterior

Configura 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 a tu archivo de compilación a nivel de la app:

    Kotlin

    dependencies {
  implementation("com.google.android.gms:play-services-ads:24.6.0")
}

    Groovy

    dependencies {
  implementation 'com.google.android.gms:play-services-ads:24.6.0'
}

  3. Haz clic en Sync Now. Para conocer los detalles sobre la sincronización, consulta Sincroniza el proyecto con archivos de Gradle.

  4. Agrega el ID de tu app de Ad Manager (tal como se identifica en la interfaz web de Ad Manager) al archivo AndroidManifest.xml de tu app. Para ello, agrega una etiqueta <meta-data> con android:name="com.google.android.gms.ads.APPLICATION_ID". Puedes encontrar el ID de la app en la interfaz web de Ad Manager. Para android:value, inserta tu propio ID de app de Ad Manager, entre comillas.

    <manifest>
  <application>
    <!-- Sample Ad Manager app ID: ca-app-pub-3940256099942544~3347511713 -->
    <meta-data
        android:name="com.google.android.gms.ads.APPLICATION_ID"
        android:value="
/<network_code>~<application_id>"/>
  </application>
</manifest>

    Reemplaza /<network_code>~<application_id> por el ID de tu app de Ad Manager. Durante las pruebas, usa el ID de la app que se muestra en el ejemplo anterior.

    Además, ten en cuenta que, si no agregas la etiqueta <meta-data> exactamente como se muestra, se producirá una falla y se mostrará el siguiente mensaje:

    Missing application ID.

    Declara el permiso AD_ID para que las versiones anteriores funcionen con Android 13 (Opcional)

    Si tu app usa la versión 20.4.0 o una posterior del SDK de anuncios de Google para dispositivos móviles, puedes omitir este paso, ya que el SDK declara automáticamente el permiso com.google.android.gms.permission.AD_ID y puede acceder al ID de publicidad cuando está disponible.

    En el caso de las apps que usan la versión 20.3.0 o una anterior del SDK de anuncios de Google para dispositivos móviles y están diseñadas para Android 13, debes agregar el permiso com.google.android.gms.permission.AD_ID al archivo AndroidManifest.xml para que ese SDK pueda acceder al ID de publicidad:

    <manifest>
 <application>
   <meta-data
       android:name="com.google.android.gms.ads.APPLICATION_ID"
       android:value="ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy"/>

   <!-- For apps targeting Android 13 or higher & GMA SDK version 20.3.0 or lower -->
   <uses-permission android:name="com.google.android.gms.permission.AD_ID"/>

 </application>
</manifest>

    Para obtener más información sobre la declaración del permiso com.google.android.gms.permission.AD_ID, incluido cómo inhabilitarlo, consulta este artículo de Play Console.

Inicializa el SDK de anuncios de Google para dispositivos móviles

Antes de cargar anuncios, llama a MobileAds.initialize() para inicializar el SDK de anuncios de Google para dispositivos móviles.

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, o bien una vez que haya transcurrido 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 o los SDKs de socios de mediación pueden precargar anuncios. Si tienes que obtener el consentimiento de los usuarios en el Espacio Económico Europeo (EEE), configura los parámetros específicos de solicitud que sean necesarios, como setTagForChildDirectedTreatment() o setTagForUnderAgeOfConsent(), 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.

En el siguiente ejemplo, se llama al método initialize() en un subproceso en segundo plano dentro de una clase Activity:

Java

new Thread(
        () -> {
          // Initialize the Google Mobile Ads SDK on a background thread.
          MobileAds.initialize(this, initializationStatus -> {});
        })
    .start();
MyActivity.java

Kotlin

CoroutineScope(Dispatchers.IO).launch {
  // Initialize the Google Mobile Ads SDK on a background thread.
  MobileAds.initialize(this@MyActivity) {}
}
MyActivity.kt

Selecciona un formato de anuncio

Ahora que se importó el SDK de anuncios de Google para dispositivos móviles, tienes todo listo para implementar un anuncio. Ad Manager 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.

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

Implementar anuncios intersticiales

Nativo

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 mejor experiencia del usuario.

Google Ad Manager ofrece dos formas de implementar anuncios nativos: estilos nativos y anuncios nativos estándares a través de la renderización personalizada.

Los estilos nativos se diseñaron para simplificar la implementación de anuncios nativos y son una excelente opción si no tienes experiencia con el formato. La renderización personalizada se diseñó para darte más libertad a la hora de crear tus presentaciones.

Implementar estilos nativos Implementar anuncios nativos (renderización personalizada)

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.

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

Implementar anuncios para inicio de aplicación

Recursos adicionales

El repositorio de anuncios de Google para dispositivos móviles en GitHub muestra cómo usar los diferentes formatos de anuncio que ofrece esta API.