AdMob+Firebase 102 Android: Ajusta el comportamiento de una app sin actualizarla

1. Introducción

Supongamos que necesitas ajustar los valores de algunos parámetros en tu app después de publicarla en Play Store. Por lo general, debes volver a publicar una versión nueva de tu app y los usuarios también deben actualizarla en sus teléfonos.

En general, la actualización de la app funcionará si quieres confirmar un cambio duradero en ella. Sin embargo, ¿qué sucede si vas a ajustar el valor de algunos parámetros de tu app con frecuencia? ¿O qué sucede si quieres realizar algunos experimentos para encontrar la configuración óptima de la app?

En estos casos, las actualizaciones de la app no funcionarían bien. Esto se debe a que la actualización tarda un tiempo en propagarse por completo a los usuarios. Además, es bastante difícil ejecutar los experimentos en varias versiones de la app.

Además, ¿cómo puedes determinar si el recorrido del usuario de la app funciona según lo previsto? Puedes confiar en los comentarios de los usuarios en Play Console. Sin embargo, es posible que no sea lo suficientemente precisa como para tomar una decisión clara.

Si a medida que avanzas con este codelab encuentras algún problema (errores de código, errores gramaticales, texto poco claro, etc.), infórmalo mediante el vínculo Informa un error que se encuentra en la esquina inferior izquierda del codelab.

Qué aprenderás

• Cómo crear un embudo en Google Analytics para Firebase
• Cómo usar Firebase Remote Config
• Cómo ejecutar Firebase A/B Testing

Requisitos

• Android Studio versión 4.1 o posterior
• Una Cuenta de Google
• Un dispositivo de prueba con Android 5.0 o versiones posteriores y un cable USB para conectarlo, o un emulador de Android que ejecute un AVD(dispositivo virtual Android) con una imagen del sistema que admita Play Store o las APIs de Google

¿Cómo calificarías tu nivel de experiencia con AdMob?

Principiante Intermedio Avanzado

¿Cómo calificarías tu nivel de experiencia con Firebase?

Principiante Intermedio Avanzado

2. Configura el entorno de desarrollo

Descarga el código

Haz clic en el siguiente botón para descargar todo el código de este codelab:

Descargar código fuente

Descomprime el archivo zip descargado. Esto descomprimirá una carpeta raíz llamada admob-firebase-codelabs-android-master.

… o clona el repositorio de GitHub desde la línea de comandos.

$ git clone https://github.com/googlecodelabs/admob-firebase-codelabs-android

El repositorio contiene cuatro carpetas de la siguiente manera:

• 101-base: Código inicial que compilarás en este codelab
• 101-complete_and_102-base: Código completo para este codelab y código inicial para el codelab 102
• 102-complete: Código completo para el codelab 102

Cómo importar la app de inicio

Inicia Android Studio y elige "Import project" en la pantalla de bienvenida. Luego, selecciona el directorio 101-complete_and_102-base del código que descargaste.

Ahora deberías tener el proyecto abierto en Android Studio.

Agrega el archivo de configuración de Firebase al proyecto de Android

1. En la pantalla de descripción general del proyecto Awesome Drawing Quiz, haz clic en el ícono de configuración.
2. En la pestaña General, selecciona la app para Android para descargar el archivo google-service.json.
3. Mueve el archivo de configuración al directorio app de tu proyecto.

3. Abre el proyecto de Firebase desde la consola.

Antes de continuar con el siguiente paso, abre el proyecto desde Firebase console que creaste en el paso "Configura el proyecto de Firebase" del Codelab de AdMob y Firebase 101.

4. Crea un embudo de eventos de la aplicación

Es posible que hayas agregado algunos eventos de la aplicación para hacer un seguimiento de la actividad del usuario dentro de la aplicación. Si lees el informe de cada evento de la aplicación, puedes obtener los detalles asociados al evento, como los recuentos totales, los recuentos promedio por usuario, los datos demográficos, etcétera.

Sin embargo, ¿qué sucede si deseas ver el porcentaje de finalización de una serie de eventos en lugar de enfocarte en un evento específico? En Google Analytics para Firebase, puedes usar el embudo para visualizar y optimizar el porcentaje de respuesta de una serie de eventos de la aplicación.

Importante: Los embudos de Firebase son embudos abiertos, lo que significa que los usuarios no tienen que completar un paso anterior (p.ej., el paso 1) para que se los incluya en las métricas de un paso posterior (p.ej., el paso 2).

Crea un embudo

Para crear un embudo, siga estos pasos:

1. Ve a Firebase console y selecciona el proyecto Awesome Drawing Quiz que creaste anteriormente.
2. Haz clic en Embudos.
3. Haga clic en EMBUDO NUEVO.
4. Ingrese un nombre y una descripción para el embudo.
5. Seleccione los dos primeros eventos que desea usar como pasos en el embudo.
6. Para cada paso adicional, haga clic en AGREGAR OTRO EVENTO y seleccione un evento.
7. Haz clic en CREAR.

Sigue los pasos anteriores para crear los siguientes embudos:

#1 Funnel name: Tasa de éxito del nivel Events: level_start, level_success

#2 Nombre del embudo: Tasa de finalización de anuncios recompensados Eventos: ad_reward_prompt, ad_reward_impression, ad_reward

Nº 3 Nombre del embudo: Tasa de finalización del juego Eventos: game_start, game_complete

Cómo ver el análisis de embudo

Una vez que hayas creado algunos embudos, podrás acceder a ellos en el menú Embudos de Firebase console. Si haces clic en el nombre del embudo en la lista, puedes ver el análisis detallado de cada embudo.

Por ejemplo, haz clic en Tasa de éxito del nivel. Se mostrarán los detalles del embudo de la siguiente manera:

En la captura de pantalla anterior, puedes ver el porcentaje de usuarios que completaron un nivel (activaron el evento level_success) después de comenzar un nivel (activaron el evento level_start). Aquí puedes ver que el 46.2% de los usuarios completaron el nivel.

Una vez que hagas clic en Cantidad de eventos, se mostrarán las métricas basadas en la cantidad de eventos de la siguiente manera:

Según las métricas de la captura de pantalla anterior, hubo 116 intentos (se activó el evento level_start) y 57 superaciones (se activó el evento level_success) durante el período.

Dado que la tasa de finalización basada en los eventos(49.1%) es ligeramente más alta que la tasa basada en el usuario(46.2%), puedes decir que hay algunas personas que tienen un mejor rendimiento que las demás.

5. Integra Remote Config en la app

Dado que puedes obtener algunas estadísticas sobre tu aplicación en función de los eventos de la aplicación y el embudo, es posible que desees optimizarla. Por lo general, esto incluye un ajuste preciso del valor del parámetro en la aplicación. Para modificar el valor de esos parámetros, deberás actualizar la aplicación para que los cambios se puedan aplicar a los usuarios.

Con Remote Config en Firebase, puedes ajustar esos valores sin una actualización de la app, lo que significa que puedes cambiar el comportamiento de la app sin molestar a los usuarios obligándolos a descargar la actualización.

En este codelab, aprenderás a hacer que el importe de la recompensa (cantidad de letras que se divulgarán después de mirar un anuncio de video recompensado) se pueda ajustar sin actualizar la app con Remote Config.

Agrega Remote Config a la dependencia de la app

Comencemos por agregar Firebase Remote Config a la dependencia de la app.

app/build.gradle

apply plugin: 'com.android.application'

android {
    ...
}

dependencies {
    ...

    // TODO: Add Firebase Remote Config dependency (102)
    implementation 'com.google.firebase:firebase-config-ktx'

    ...
}

...

Sincroniza tu proyecto con archivos de Gradle

Para asegurarte de que todas las dependencias estén disponibles para tu app, sincroniza tu proyecto con los archivos Gradle. Selecciona el menú File > Sync Project with Gradle Files para sincronizar tu proyecto con los archivos de Gradle.

Establece un valor predeterminado del parámetro de Remote Config

Para recuperar los valores de Remote Config, se requiere una conexión de red. En el caso de que la red no esté disponible, debes definir un valor predeterminado para cada parámetro de Remote Config.

Crea el archivo remote_config_defaults.xml en la carpeta res/xml. Luego, establece un valor predeterminado para el importe de la recompensa (reward_amount)) de la siguiente manera.

res/xml/remote_config_defaults.xml

<?xml version="1.0" encoding="utf-8"?>
<defaultsMap>
    <entry>
        <key>reward_amount</key>
        <value>1</value>
    </entry>
</defaultsMap>

Ten en cuenta que reward_amount es el nombre del parámetro en Remote Config.

Recupera el importe de la recompensa de Remote Config

Modifica AwesomeDrawingQuiz.kt para que la clase GameSettings contenga una referencia a la instancia RemoteConfig.

Ten en cuenta que la instancia de RemoteConfig está configurada para recuperar los valores más recientes del servidor en el modo de depuración para ayudar en el proceso de desarrollo. (Establece el intervalo de recuperación mínimo en cero segundos llamando a fetch(0L)).

Para obtener más información sobre el modo de desarrollador en Remote Config, consulta este artículo en las Preguntas frecuentes de Firebase.

AwesomeDrawingQuiz.kt

class AwesomeDrawingQuiz : Application() {

    ...

    // COMPLETE: Provide FirebaseRemoteConfig instance (102)
    private fun provideGameSettings() = GameSettings(provideRemoteConfig())

    // COMPLETE: Add a function that provides a FirebaseRemoteConfig instance (102)
    private fun provideRemoteConfig(): FirebaseRemoteConfig {
        val rc = Firebase.remoteConfig.apply {
            setDefaultsAsync(R.xml.remote_config_defaults)
        }
        val fetchTask = if (BuildConfig.DEBUG) rc.fetch(0L) else rc.fetch()
        fetchTask.addOnCompleteListener {
            if (it.isSuccessful) {
                Log.d("AwesomeDrawingQuiz", "Remote config value fetched")
                rc.activate()
            }
        }
        return rc
    }
}

Luego, cambia la clase GameSettings para recuperar el importe de la recompensa de Remote Config.

GameSettings.kt

// TODO: Add FirebaseRemoteConfig as a class member
class GameSettings(private val rc: FirebaseRemoteConfig) {

  ...

  // TODO: Apply reward amount from the Remote Config (102)
  val rewardAmount: Int
    get() = rc.getLong(KEY_REWARD_AMOUNT).toInt()

  companion object {
    ...

    // TODO: Add a key for 'reward_amount' Remote Config parameter (102)
    private const val KEY_REWARD_AMOUNT = "reward_amount"
  }
}

Crea un parámetro de Remote Config desde la consola

A continuación, crearás un nuevo parámetro de Remote Config para el importe de la recompensa, de modo que puedas ajustar su valor sobre la marcha.

Para crear un parámetro nuevo, ve a Firebase console y, luego, selecciona el proyecto Awesome Drawing Quiz que creaste anteriormente. Haz clic en el botón Remote Config -> ADD YOUR FIRST PARAMETER.

Nombra el parámetro como reward_amount y establece su valor predeterminado en 1. Luego, haz clic en el botón Agregar parámetro.

Haz clic en el botón Publicar cambios para que el cambio esté disponible para los usuarios.

6. Cómo cambiar el comportamiento de la app con Remote Config

Ahora se puede configurar la cantidad de la recompensa en el Awesome Drawing Quiz en Firebase console sin tener que actualizar el código de la app.

En esta sección, cambiarás el importe de la recompensa de 1 a 2 para que la app revele dos caracteres más como pista después de mirar un anuncio recompensado.

Actualiza el valor predeterminado del parámetro reward_amount

Ve a Firebase console y, luego, selecciona el proyecto Awesome Drawing Quiz que creaste anteriormente. Haz clic en Remote Config y, luego, en reward_amount en la lista. A continuación, cambia el valor predeterminado a 2 y, luego, haz clic en el botón Actualizar.

Haz clic en el botón Publicar cambios para que el cambio esté disponible para los usuarios.

Verifica el cambio de comportamiento de la app

Para confirmar el cambio de comportamiento de la app, vuelve a ejecutar el proyecto. Una vez que termines de mirar un anuncio recompensado, notarás que la app ahora revela dos letras como recompensa, tal como lo configuramos en la consola de Remote Config.

Antes de mirar un anuncio recompensado

Se revelaron dos letras adicionales como recompensa.

7. Crea el experimento para optimizar el importe de la recompensa

Ahora puedes cambiar el importe de la recompensa sin tener que publicar una actualización de la app. Sin embargo, ¿cómo puedes determinar la cantidad que cambiaste y que es buena para la app?

Con Firebase A/B Testing, puedes ejecutar experimentos para optimizar la experiencia general del usuario de la app sin necesidad de actualizarla ni crear una herramienta independiente para ejecutar y hacer un seguimiento del rendimiento de cada experimento.

Diseña el experimento

Antes de crear un experimento nuevo, debes establecer un objetivo o una meta claros para el experimento. Asegúrate de revisar la siguiente lista de tareas antes de crear un experimento nuevo.

• Qué: ¿Qué deseas optimizar? (p.ej., dificultad del juego, visibilidad o sincronización del anuncio, etc.)
• Por qué: ¿Cuál es tu objetivo comercial para ejecutar el experimento? (p.ej., para maximizar los ingresos publicitarios, aumentar la retención, etc.)
• Quién: ¿Quiénes son los sujetos del experimento? (p. ej., Todos los usuarios, Público de usuarios específicos, etcétera)

En este codelab, crearás un experimento para optimizar el valor del importe de la recompensa y maximizar la participación diaria de los usuarios en el Awesome Drawing Quiz.

Crea el experimento

Abre el proyecto Awesome Drawing Quiz desde Firebase console. Selecciona el menú Pruebas A/B y, luego, haz clic en el botón Crear experimento.

Selecciona Remote Config para crear un experimento de Remote Config.

Nombra el experimento como "Cantidad de la recompensa", como se muestra en la siguiente captura de pantalla.

Configura las opciones de segmentación. En este codelab, segmentarás el 100% de los usuarios del Awesome Drawing Quiz.

Dado que el objetivo principal del experimento es encontrar un valor óptimo que maximice la participación diaria de los usuarios, selecciona la métrica Participación diaria de los usuarios como métrica principal para hacer un seguimiento.

Precaución: Si seleccionas un evento de Analytics (p.ej., level_success, level_fail, etc.) como métrica principal, se medirá la "cantidad de usuarios que activaron el evento", no la "cantidad total de eventos activados".

Por ejemplo, no debes seleccionar el evento level_success como métrica principal, ya que es probable que todos los usuarios, independientemente de la variante, activen el evento level_success. Esto hará que el experimento no pueda comparar el rendimiento entre las variantes, ya que el rendimiento (cantidad de usuarios que activaron el evento level_success) será igual o similar, como se muestra en la siguiente captura de pantalla.

Por último, configura el grupo de control y el grupo de variantes para determinar qué grupo tiene un mejor rendimiento. Selecciona reward_amount en el grupo de control y deja su valor sin cambios. En el caso del grupo de variantes, asígnale el nombre "Menos recompensa" y, luego, cambia el valor de reward_amount a 1.

Con esta configuración, las personas del grupo de "Menos recompensa" recibirán una letra como recompensa, mientras que las personas del grupo de control recibirán dos letras como recompensa. Como resultado, verás cómo la cantidad de recompensa afecta a los usuarios.

Una vez que hagas clic en el botón Revisar, verás un resumen del experimento como el siguiente.

Ejecuta el experimento

Haz clic en el botón Iniciar experimento para ejecutarlo. Ten en cuenta que no podrás cambiar la configuración del experimento una vez que comience.

8. Administra el experimento

Consulta el progreso del experimento

Puedes verificar el progreso del experimento en el menú A/B Testing de Firebase console, que se verá como la siguiente captura de pantalla. Ten en cuenta que también puedes ver la cantidad de usuarios que participan en el experimento en los últimos 30 minutos en la tarjeta.

Una vez que hagas clic en el experimento de la lista, podrás ver sus detalles. Hasta que el experimento pueda declarar un líder (es decir, la variante con el mejor rendimiento), verás el mensaje "Es demasiado pronto para declarar un líder".

Una vez que el experimento se haya ejecutado durante un tiempo, comenzará a mostrar los datos recopilados durante el experimento hasta el momento en la sección Resumen de la mejora. Puedes comparar el rendimiento de cada variante para ver cuál funciona mejor. En la siguiente captura de pantalla, se muestra un ejemplo de la sección Resumen de mejoras.

En la tabla que se encuentra debajo de la sección Resumen de la mejora, puedes consultar los detalles de las métricas objetivo del experimento, así como las métricas adicionales que se registran en el experimento. En la siguiente captura de pantalla, se muestra un ejemplo de la sección de detalles de las métricas.

Implementa el líder para todos los usuarios

Después de que el experimento se ejecute por un tiempo suficiente para encontrar una variante líder o ganadora, puedes implementarlo para el 100% de los usuarios. Una vez que A/B Testing encuentre una variante ganadora clara, te recomendará que la implementes para todos los usuarios.

Sin embargo, incluso si el experimento no declaró una variante ganadora clara, puedes implementar una variante en todos los usuarios.

En la pantalla de detalles del experimento, haz clic en el menú contextual ( ) y, luego, en Implementar variante.

Elige una variante para lanzar a todos los usuarios y, luego, haz clic en el botón Revisar en Remote Config para revisar los cambios antes de realizar uno en Remote Config.

Después de confirmar que el borrador no tiene ningún problema, haz clic en el botón Publicar cambios para que el cambio esté disponible para todos los usuarios.

9. Todo listo

Completaste el codelab de AdMob+Firebase 102 para Android. Puedes encontrar el código completo de este codelab en la carpeta 102-complete.