Instrucciones de integración del SDK de Android

En esta página se describe cómo integrar el SDK de Android en tu aplicación.

Para obtener instrucciones sobre cómo mostrar diferentes tipos de anuncios, consulta:

En esta sección se proporcionan instrucciones para configurar el SDK de Android para mostrar anuncios en la aplicación.

Requisitos

  • La versión mínima del SDK de la aplicación debe ser Android 5.0 (nivel de API 21) o posterior.
  • Para solicitar anuncios, use un identificador de ubicación válido. Para los bloques de anuncios compatibles, puedes usar un id. de miembro y un código de inventario válidos.

Sugerencia

  • Servicios de Google Play Para habilitar el id. de publicidad de Android (AAID) para la limitación de frecuencia y la segmentación de aplicaciones móviles, incluye la biblioteca de identificadores de anuncios de Google Play Services. El SDK de Android funciona sin esta dependencia opcional, pero las funciones basadas en AAID no están disponibles.
  • Android Studio y Gradle En estas instrucciones, se supone que usa Android Studio y Gradle. Las entradas de manifiesto requeridas del SDK de Android y las reglas de ProGuard para consumidores se fusionan automáticamente en tu aplicación. Si usa otro sistema de compilación, los pasos pueden variar.

Instalación

Paso 1. Obtener el SDK

Asegúrese de que Maven Central esté incluido en los repositorios del proyecto. A continuación, agrega las dependencias de identificador de anuncios del SDK de Android y Google Play Services al archivo del módulo de build.gradle la aplicación:

dependencies {
    implementation 'com.appnexus.opensdk:appnexus-sdk:9.14.0'
    implementation 'com.google.android.gms:play-services-ads-identifier:18.2.0'
}

La dependencia de los servicios de Google Play es opcional. Omite esta opción si tu aplicación no usa la limitación de frecuencia basada en AAID o la segmentación de aplicaciones móviles.

Para agregar adaptadores de mediación, consulte Mediar con Android.

Paso 2. Editar permisos de aplicación (opcional)

El acceso a la ubicación no es necesario para que el SDK de Android solicite anuncios. Si la aplicación decide proporcionar datos de ubicación, declare los permisos que coincidan con el nivel de acceso que necesita la aplicación:

<manifest xmlns:android="http://schemas.android.com/apk/res/android">
    <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
    <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
</manifest>
  • ACCESS_COARSE_LOCATION permite el acceso a la ubicación aproximada.
  • ACCESS_FINE_LOCATION permite el acceso a una ubicación precisa. Declárela y solicítela solo si la aplicación necesita una ubicación precisa.

En Android 6.0 (nivel de API 23) y versiones posteriores, la aplicación debe solicitar permisos de ubicación declarados en tiempo de ejecución. El SDK de Android accede a la ubicación solo después de que el usuario conceda permiso.

Para obtener más información, consulte Solicitud de permisos en tiempo de ejecución en la documentación de Android.

Nota:

El SDK de Android no solicita actualizaciones de ubicación. Cuando la ubicación está habilitada, usa una ubicación proporcionada por la aplicación o la última ubicación conocida disponible del dispositivo.

Paso 3. Configuración de la reducción de código para AAID

El SDK de Android accede a la biblioteca de identificadores de anuncios de anuncios de Google Play Services a través de la reflexión. Si la aplicación habilita R8 o ProGuard e incluye la dependencia de AAID opcional, agregue las siguientes reglas al archivo de reglas de ProGuard de la aplicación:

# Preserve Google Play services classes used to retrieve the AAID.
-keep class com.google.android.gms.ads.identifier.AdvertisingIdClient {
    public static com.google.android.gms.ads.identifier.AdvertisingIdClient$Info getAdvertisingIdInfo(android.content.Context);
}
-keep class com.google.android.gms.ads.identifier.AdvertisingIdClient$Info {
    public java.lang.String getId();
    public boolean isLimitAdTrackingEnabled();
}

Paso 4. Configuración para mediación (opcional)

Para obtener instrucciones sobre cómo configurar la mediación, consulte la mediación con Android.

Nota de implementación: Reenvío de devoluciones de llamada del ciclo de vida

El SDK permite reenviar devoluciones de llamada del ciclo de vida para las subclases de AdView: BannerAdView y InterstitialAdView.

Se recomienda reenviar las devoluciones de llamada del ciclo de vida para mejorar el rendimiento. Para cualquier persona que medie en banners de AdMob/DFP, es un requisito que se llame, ya que debemos reenviar las devoluciones de llamada del ciclo de vida al banner de AdMob/DFP según lo requieran. Consulte el ejemplo de código a continuación para obtener información sobre los métodos a los que llamar y cuándo.

En el ejemplo siguiente se utiliza BannerAdView. Utilice los mismos métodos de ciclo de vida cuando trabaje con InterstitialAdView.

Para obtener más información sobre los ciclos de vida de actividad, consulte Administración del ciclo de vida de actividad en los documentos de Android.

class BannerActivity : AppCompatActivity() {
    private lateinit var banner: BannerAdView

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        banner = BannerAdView(this) // Create the banner ad view
        banner.setPlacementID("123456") // Set placement ID
        setContentView(banner)
    }

    override fun onResume() {
        super.onResume()
        banner.activityOnResume() // Forward the resume callback
    }

    override fun onPause() {
        banner.activityOnPause() // Forward the pause callback
        super.onPause()
    }

    override fun onDestroy() {
        banner.activityOnDestroy() // Forward the destroy callback
        super.onDestroy()
    }
}
  • Last updated on