Integrar el 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 del anuncio (como video nativo o 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 de
21
o posterior - Compila la versión del SDK de
33
o una versión posterior
- Versión mínima del SDK de
Cómo configurar tu app
En el archivo
build.gradle
de nivel de proyecto, incluye el repositorio de Maven de Google y el repositorio central de Maven en las seccionesbuildscript
yallprojects
:buildscript { repositories { google() mavenCentral() } } allprojects { repositories { google() mavenCentral() } }
Agrega las dependencias para el SDK de anuncios de Google para dispositivos móviles al archivo Gradle a nivel de la app de tu módulo, que suele ser
app/build.gradle
:dependencies { implementation 'com.google.android.gms:play-services-ads:23.1.0' }
Agrega el Ad Manager ID de tu app, como se identifica en la interfaz webAd Manager, al archivo
AndroidManifest.xml
de la app. Para hacerlo, agrega una etiqueta<meta-data>
conandroid:name="com.google.android.gms.ads.APPLICATION_ID"
. Puedes encontrar el ID de tu app en la Ad Manager interfaz web. Paraandroid:value
, inserta tu propio Ad Manager ID de la app, rodeado de 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="ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy"/> </application> </manifest>
En una app real, reemplaza el ID de la app de ejemplo por el Ad Manager ID real de tu app. Puedes usar el ID de muestra si solo estás experimentando con el SDK en una app de Hello World.
Además, ten en cuenta que, si no agregas la etiqueta
<meta-data>
exactamente como se muestra, se producirá una falla con el siguiente mensaje:Missing application ID.
(Opcional) Declara el permiso
AD_ID
para que las versiones anteriores funcionen con Android 13.Si tu app usa la versión 20.4.0 o 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 se orientan a Android 13, debes agregar el permiso
com.google.android.gms.permission.AD_ID
en el archivoAndroidManifest.xml
para que el SDK de anuncios de Google para dispositivos móviles acceda 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 de permisos
com.google.android.gms.permission.AD_ID
, incluida la forma de inhabilitarla, consulta este artículo de Play Console.
Cómo inicializar el SDK de anuncios de Google para dispositivos móviles
Antes de cargar anuncios, llama aMobileAds.initialize()
a fin de 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 Google Mobile Ads, o después de un tiempo de espera de 30 segundos. Esto debe hacerse solo una vez, idealmente cuando se inicia la app.
Los anuncios se pueden cargar previamente con el SDK de anuncios de Google para dispositivos móviles o con los SDK de socios de mediación después de la inicialización. Si necesitas obtener el consentimiento de los usuarios del Espacio Económico Europeo (EEE), configura las marcas específicas de la solicitud, como las siguientes:
setTagForChildDirectedTreatment()
,
setTagForUnderAgeOfConsent()
,
o tomar medidas de otro modo antes de cargar los anuncios. Asegúrate de hacerlo antes de inicializar
el SDK de anuncios de Google para dispositivos móviles.
A continuación, se muestra un ejemplo de cómo llamar al método initialize()
en un subproceso en segundo plano dentro de una Activity:
Java
import com.google.android.gms.ads.MobileAds;
import com.google.android.gms.ads.initialization.InitializationStatus;
import com.google.android.gms.ads.initialization.OnInitializationCompleteListener;
public class MainActivity extends AppCompatActivity {
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
new Thread(
() -> {
// Initialize the Google Mobile Ads SDK on a background thread.
MobileAds.initialize(this, initializationStatus -> {});
})
.start();
}
}
Kotlin
import com.google.android.gms.ads.MobileAds
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 the Google Mobile Ads SDK on a background thread.
MobileAds.initialize(this@MainActivity) {}
}
}
}
Seleccionar un formato de anuncio
El SDK de anuncios de Google para dispositivos móviles ya se importó y tienes todo listo para implementar un anuncio. Ad Manager ofrece una variedad de formatos de anuncios para que puedas elegir el que mejor se adapte a la experiencia del usuario de tu app.
Banner
Las unidades de anuncios en forma de banner muestran anuncios rectangulares que ocupan una parte del diseño de la app. Se pueden actualizar 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 de la app. También son el formato de anuncio más fácil de implementar.
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, como 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 recursos como los títulos y los llamados a la acción en tus apps. Si diseñas el anuncio personalmente, puedes crear presentaciones de anuncios naturales y discretas que pueden contribuir a una experiencia del usuario enriquecida.
Google Ad Manager ofrece dos formas de implementar anuncios nativos: estilos nativos y anuncios nativos estándar 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. Se diseñó la renderización personalizada para maximizar la libertad que tienes para crear tus presentaciones.
Implementa estilos nativos Implementa anuncios nativos (renderización personalizada)
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 recompensas distintas para cada unidad de anuncios, y especificar los elementos y los valores de las recompensas que recibió el usuario.
Implementa anuncios recompensados
Anuncio intersticial recompensado
Los anuncios 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, los usuarios no tienen que aceptar la opción para ver un anuncio intersticial recompensado.
En lugar de la solicitud para habilitar los anuncios recompensados, estos anuncios intersticiales requieren una pantalla de presentación que anuncie la recompensa y les brinde a los usuarios la oportunidad de rechazarla si desean hacerlo.
Implementa anuncios intersticiales recompensados
Inicio de aplicación
El formato de anuncio de aplicación abierta aparece cuando los usuarios abren la app o regresan a ella. El anuncio se superpone a la pantalla de carga.
Cómo implementar anuncios de aplicación abierta
Recursos adicionales
El repositorio de anuncios de Google para dispositivos móviles en GitHub muestra cómo usar los diferentes formatos de anuncios que ofrece esta API.