Comenzar

El primer paso para integrar el SDK de anuncios de Google para dispositivos móviles en una app es mostrar anuncios y obtener ingresos. Una vez que hayas integrado el SDK, puedes elija un formato de anuncio (como video nativo o recompensado) y siga 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 una superior
    • Compila la versión del SDK de 33 o una superior

Cómo configurar tu app

  1. En tu archivo de configuración de Gradle, incluye el archivo el repositorio Maven de Google y 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 compilación de nivel de app. archivo:

    Kotlin

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

    Groovy

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

  3. Agrega el ID de tu Ad Manager app, según se identifica en el Ad Manager interfaz web, a la API de tu app AndroidManifest.xml. Para ello, agrega una etiqueta <meta-data> con android:name="com.google.android.gms.ads.APPLICATION_ID" Puedes encontrar el ID de tu app en la Ad Manager interfaz web. Para android:value, inserta tu propio Ad Manager ID de app Está 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 aplicación real, reemplace el ID de la aplicación de ejemplo por su ID real. Ad Manager ID de la app. Puedes usar el ID de muestra si solo está experimentando con el SDK en una app de Hello World.

    Además, ten en cuenta que no se pudo agregar la etiqueta <meta-data> exactamente como se muestra en los resultados en un fallo con el siguiente mensaje:

    Missing application ID.

    (Opcional) Cómo declarar El permiso AD_ID para que versiones anteriores funcionen con Android

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

    Para las aplicaciones que usan la versión 20.3.0 del SDK de anuncios de Google para dispositivos móviles anteriores y orientadas a Android 13, debes agregar el el permiso com.google.android.gms.permission.AD_ID en AndroidManifest.xml del SDK de anuncios de Google para dispositivos móviles al Accede 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 el Declaración de permisos de com.google.android.gms.permission.AD_ID, incluido cómo inhabilitarla, consulta esta Artículo de la consola.

Cómo inicializar el SDK de anuncios de Google para dispositivos móviles

Antes de cargar anuncios, llama a la inicialización del SDK de anuncios de Google para dispositivos móviles. MobileAds.initialize().

Este método inicializa el SDK y llama a un objeto de escucha de finalización una vez que Si se completan las inicializaciones del SDK de anuncios de Google para dispositivos móviles y de los adaptadores, o después de una Tiempo de espera de 30 segundos Esto debe hacerse una sola 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 los SDK de socios de mediación. después de la inicialización. Si necesitas obtener el consentimiento de los usuarios de la región en el Espacio Económico Europeo (EEE), establece las marcas específicas de la solicitud, como setTagForChildDirectedTreatment() o setTagForUnderAgeOfConsent(), o De lo contrario, toma medidas antes de cargar los anuncios. Asegúrate de hacerlo antes de iniciar el proceso. el SDK de anuncios de Google para dispositivos móviles.

Este es un ejemplo de cómo llamar al método initialize() en segundo plano subproceso dentro de una actividad:

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

Se importó el SDK de anuncios de Google para dispositivos móviles, y ya puedes implementar un anuncio. Ad Manager ofrece varios formatos de anuncios diferentes, por lo que puedes elegir la que mejor se adapte a la experiencia del usuario de tu aplicación.

Los bloques de anuncios de banner muestran anuncios rectangulares que ocupan una parte de la superficie de una aplicación . Pueden actualizarse automáticamente después de un período determinado. Esto significa usuarios ven un anuncio nuevo en intervalos regulares, aunque permanezcan en el mismo pantalla en tu app. También son el formato de anuncio 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 su aplicación. Colócalos en un lugar natural pausas y transiciones en la interfaz de tu app, por ejemplo, después de completar un nivel en una aplicación de juego.

Implementa anuncios intersticiales

Nativo

Los anuncios nativos son anuncios en los que puedes personalizar la forma en que los recursos, como los títulos y los llamados a la acción se presentan en tus aplicaciones. Si aplicas un estilo al anuncio, puedes Para crear presentaciones de anuncios naturales y discretas que puedan atraer a un usuario valioso una experiencia fluida a los desarrolladores.

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 es una excelente opción si no tienes experiencia en el formato. La renderización personalizada diseñados para maximizar tu libertad al momento de crear presentaciones.

Cómo implementar estilos nativos Implementa anuncios nativos (renderización personalizada)

Recompensado

Las unidades de anuncios recompensados les permiten a los usuarios jugar, realizar encuestas o mirar videos para ganar recompensas en la app, como monedas, vidas adicionales o puntos Puedes configurar diferentes recompensas para distintas unidades de anuncios y especifica los valores de la recompensa y los artículos que recibió el usuario.

Implementa anuncios recompensados

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 necesitan aceptar ver un anuncio recompensado. anuncio intersticial.

En lugar de la solicitud de aceptación en los anuncios recompensados, los anuncios intersticiales recompensados requieren un en la que se anuncia la recompensa y se brinda a los usuarios la oportunidad de rechazarla si quieren hacerlo.

Implementa anuncios intersticiales recompensados

Aplicación abierta

El formato de anuncio de aplicación abierta aparece cuando los usuarios abren o regresan a tu . El anuncio se superpone a la pantalla de carga.

Implementa anuncios de aplicación abierta

Recursos adicionales

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