Instrucciones de integración del SDK de Android

En esta página se describe cómo integrar el SDK en el proyecto.

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

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

Requisitos

Este SDK requiere Android 5.0 (Lollipop) o posterior, y Android SDK versión 21 o posterior.

Para mostrar anuncios, debes tener un identificador de ubicación de Xandr válido. Se trata de un identificador numérico que representa el contexto de una aplicación en el que se pueden mostrar anuncios.

Sugerencia

Google Play Para habilitar el id. de publicidad Android (AAID) para la limitación de frecuencia y la segmentación de aplicaciones móviles, debe incluir Google Play Services como una dependencia de su aplicación. El SDK de Xandr seguirá funcionando sin Google Play Services, pero no tendrás acceso a esas funciones.

Android Studio y Gradle En estas instrucciones, se supone que usa Android Studio y Gradle. La mayoría de las entradas necesarias AndroidManifest.xml (excepto los permisos de ubicación) y los cambios de ProGuard se agregan automáticamente a la aplicación. Si usas otros sistemas de compilación, los pasos pueden variar.

Instalación

Paso 1. Obtener el SDK

Instale a través de Maven desde el build.gradle archivo como se muestra a continuación.

Nota:

Estos son bloques de nivel superior, no parte del bloque buildscript.
La [9,10) notación significa que cuando se compile la aplicación, se incluirá la versión más reciente del SDK de la serie de versiones 9.x. Cuando publicamos una nueva versión del SDK, todo lo que tiene que hacer para obtener la nueva versión es volver a compilar la aplicación. Si desea incluir adaptadores de mediación para otros SDK en su build.gradle, consulte la sección Permítanos mediar otras redes de mediación con Android.

Advertencia

El comando compilar ya no es compatible con Gradle, se ha reemplazado por el comando implementation.

// Android: Gradle config to install the SDK
repositories {
    mavenCentral()
}

dependencies {
    implementation 'com.appnexus.opensdk:appnexus-sdk:[9,10)'
}

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

Edite su manifiesto de Android para incluir los siguientes permisos (opcionales, pero recomendados):

<!-- Android: XML to include recommended permissions -->
<manifest xmlns:android="http://schemas.android.com/apk/res/android">

<!-- Add the permissions here... -->
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />

ACCESS_COARSE_LOCATION (recomendado): concede al SDK permiso para acceder a la ubicación aproximada en función de la torre de telefonía móvil.
ACCESS_FINE_LOCATION (recomendado): concede al SDK permiso para acceder a una ubicación más precisa según el GPS.

Sugerencia

Los permisos de ubicación deben preguntar al usuario:

En el nivel de API 23 (Marshmallow) y posteriores, debes solicitar al usuario un cuadro de diálogo en tiempo de ejecución de la aplicación para cualquiera de los permisos de ubicación enumerados anteriormente. El SDK solo puede acceder a los permisos de ubicación con el consentimiento del usuario.

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

Aunque técnicamente no son necesarios, los permisos de ubicación permiten que el SDK envíe datos basados en la ubicación a los anunciantes. El envío de mejores datos de ubicación generalmente conduce a una mejor monetización.

Nota:

El SDK nunca activará el teléfono para solicitar que se actualice la ubicación; Esto tomaría tiempo y batería. En su lugar, usará estos permisos para acceder a la última ubicación conocida del dispositivo.

Paso 3. Editar la configuración de ProGuard

Si su aplicación usa ProGuard, debe editar su configuración de ProGuard para evitar eliminar Google Play de su aplicación. El SDK no requiere Google Play para funcionar, pero perderás el acceso al id. de anunciante de Android (AAID), que se usa para la segmentación de aplicaciones y la limitación de frecuencia. Edite el archivo del proguard-project.txt proyecto para agregar lo siguiente:

### Proguard settings to support Android Advertiser ID
-keep class com.google.android.gms.ads.identifier.AdvertisingIdClient {
    com.google.android.gms.ads.identifier.AdvertisingIdClient$Info getAdvertisingIdInfo(android.content.Context);
}
-keep class com.google.android.gms.ads.identifier.AdvertisingIdClient$Info {
    java.lang.String getId();
    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.

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.

    /**
     * To be called by the developer when the fragment/activity's onDestroy() function is called.
     */
    abstract public void activityOnDestroy();

    /**
     * To be called by the developer when the fragment/activity's onPause() function is called.
     */
    abstract public void activityOnPause();

    /**
     * To be called by the developer when the fragment/activity's onResume() function is called.
     */
    abstract public void activityOnResume();

Last updated on 2026-08-18