Compilaciones de acceso anticipado del SDK de Android de Google Mobile Ads

Esta guía está destinada a los publicadores que integran una compilación de acceso anticipado del SDK de Android para anuncios de Google para dispositivos móviles en su app para Android. Las compilaciones de acceso anticipado ofrecen la oportunidad de aprovechar las nuevas funciones del SDK de anuncios de Google para dispositivos móviles sin esperar a la próxima versión de los Servicios de Google Play, y ofrecen los siguientes beneficios:

  • Comienzan a usar automáticamente la implementación más reciente del SDK de anuncios de Google para dispositivos móviles desde el APK de Servicios de Google Play una vez que se lanza la función de acceso anticipado en el APK.

  • Están completamente probados y cumplen con los mismos criterios de lanzamiento que las compilaciones públicas disponibles en el repositorio Maven de Google o en SDK Manager.

  • Son versiones completas del SDK de anuncios de Google para dispositivos móviles más grandes que el SDK lite, pero no están sujetas a las limitaciones de este SDK.

  • Se pueden usar en todo el mundo y no solo en apps que se distribuyen en Google Play.

Sigue los pasos que se indican en esta página para configurar un repositorio Maven local con el SDK de anuncios de Google para dispositivos móviles de acceso anticipado y hacer referencia a él como una dependencia en tu app para Android.

Requisitos previos

  • Usa Android Studio 3.0 o una versión posterior
  • Orienta la app al nivel de API 16 o posterior.
  • Archivo ZIP del SDK de anuncios de Google para dispositivos móviles de acceso anticipado proporcionado por el administrador de cuentas

Configura un repositorio Maven personalizado

Descarga el archivo ZIP del SDK de anuncios de Google para dispositivos móviles con acceso anticipado. Crea una carpeta gma_sdk_repo en el directorio de nivel superior de tu proyecto y coloca todo el contenido del archivo ZIP en esa carpeta. La estructura de tu directorio debe ser similar a <project_root_dir>/gma_sdk_repo/com/google/....

Abre el archivo build.gradle a nivel de proyecto de tu app.

allprojects {
    repositories {
        maven {
            url "${project.rootDir}/gma_sdk_repo"
        }
        google()
        jcenter()

    }
}

Agrega la línea en negrita a la sección allprojects/repositories. Esto le indica a Gradle que busque un repositorio de Maven en la carpeta gma_sdk_repo que acabas de crear cuando resuelves dependencias.

Cómo agregar una dependencia de compilación

Para usar la compilación de acceso anticipado del SDK de anuncios de Google para dispositivos móviles en tu proyecto, también debes hacer referencia a él como una dependencia en tu archivo build.gradle de nivel de app: abre el archivo build.gradle de nivel de app y agrega la línea en negrita del fragmento en la sección dependencies.

dependencies {
    implementation 'com.google.android.gms:play-services-ads:x.y.z'
}
...

La versión de dependencia, que muestra x.y.z en el fragmento anterior, se puede determinar buscando la versión más reciente presente en el directorio com/google/android/gms/play-services-ads/ en el contenido desarchivado del archivo ZIP del SDK de Android para anuncios de Google para dispositivos móviles de acceso anticipado.

Resuelve los conflictos de Firebase

Si usas una biblioteca de Firebase junto con el SDK de anuncios para dispositivos móviles, es posible que tu proyecto incluya las dependencias com.google.android.gms:play-services-measurement-api y com.google.android.gms:play-services-measurement-sdk-api. Las versiones de estas dos dependencias deben coincidir, pero es posible que descubras que la compilación de acceso anticipado del SDK de anuncios para dispositivos móviles y la versión actual de Firebase extraída en versiones diferentes para estas dos dependencias.

Como solución alternativa, puedes forzar la resolución de la dependencia a una versión específica de la biblioteca play-services-measurement-sdk-api en el archivo build.gradle de la app de la siguiente manera:

android {
    ...
    configurations.all {
        resolutionStrategy {
            force 'com.google.android.gms:play-services-measurement-sdk-api:x.y.z'
        }
    }
}
...

La versión x.y.z depende de tu versión de Firebase. Estas son las versiones correctas de las versiones más recientes de Firebase:

Versión de firebase-core Versión de play-services-measurement-sdk-api
16.0.7 16.3.0
16.0.6 16.0.4
16.0.5 16.0.3
16.0.4 16.0.2

A fin de buscar la versión correcta de otras versiones de Firebase, ejecuta gradle androidDependencies en tu app y usa la versión impresa para la dependencia com.google.android.gms:play-services-measurement-api.

Tu app para Android ya está lista para usarse con una compilación de acceso anticipado del SDK de Android para anuncios de Google para dispositivos móviles.