AdMob+Firebase 102 Unity: Ajusta el comportamiento de tu 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 nueva versión de la app, y los usuarios también deben actualizarla en sus teléfonos.

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

En estos casos, la actualización de la app no funcionaría bien. Porque requiere un tiempo hasta que la actualización se propague por completo a los usuarios Además, es bastante difícil ejecutar los experimentos en varias versiones de la aplicación.

Además, ¿cómo puedes determinar si el recorrido del usuario de la aplicación 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 preciso como para tomar una decisión clara.

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

• Unity 2018.4.4f1 o una versión posterior
• Xcode 10 o versiones posteriores (para compilar el destino para iOS)
• Una Cuenta de Google
• Un dispositivo de prueba con Android 5.0 o versiones posteriores con un cable USB para conectar el dispositivo, o un Android Emulator que ejecute un AVD(dispositivo virtual de Android) con una imagen del sistema compatible con las APIs de Play Store y Google
• Un dispositivo con iOS o un simulador que ejecute iOS 8.0 o una versión posterior

¿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. Se descomprimirá una carpeta raíz llamada admob-firebase-codelabs-unity-master.

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

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

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 para el codelab 102.
• 102-complete: Código completo para el codelab 102

Prepara los archivos requeridos

Awesome Drawing Quiz usa varios códigos de código abierto, que son necesarios para compilar y ejecutar el proyecto.

Abre la terminal y dirígete al directorio raíz del repositorio. Luego, ejecuta ./gradlew :prepareThirdPartyFiles (gradlew.bat :prepareThirdPartyFiles en Windows) desde la terminal para copiar los archivos necesarios en el proyecto.

Importa la app de partida

Inicia Unity, elige “Open” 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 Unity.

Importante: Los archivos del complemento de Unity (anuncios de Google para dispositivos móviles y Firebase) NO SE INCLUYEN en el repositorio de código fuente de los codelabs. Debes agregarlo manualmente al proyecto siguiendo los pasos que se indican a continuación. De lo contrario, el proyecto NO COMPILAR.

Agrega el complemento Google Mobile Ads para Unity

Para publicar anuncios de AdMob en la app de Unity, debes agregar el complemento de Unity de Google Mobile Ads al proyecto.

1. Descarga el paquete del complemento 3.18.1 de Google Mobile Ads para Unity. Ten en cuenta que este codelab puede no ser compatible con la otra versión del complemento.
2. En el proyecto de Unity de Awesome Drawing Quiz En el proyecto, navega a Recursos > Importar paquete > Custom Package
3. Importa el paquete GoogleMobileAds.unitypackage al proyecto que descargaste.

También debes establecer el ID de la app de AdMob. En Unity Editor, selecciona Assets > Anuncios de Google para dispositivos móviles > Configuración en el menú.

Para habilitar AdMob, haz clic en la casilla de verificación Habilitada en la sección Google AdMob. Luego, ingresa el ID de la app de AdMob como se indica a continuación:

• Android: ca-app-pub-3940256099942544~3048611032
• iOS: ca-app-pub-3940256099942544~2753522596

Agrega archivos de configuración de Firebase al proyecto de Unity

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 cada app para iOS y Android a fin de descargar el archivo google-service.json (para Android) y el archivo GoogleService-Info.plist (para iOS).
3. Traslada ambos archivos de configuración a la carpeta Assets en el proyecto de Unity.

Agrega el SDK de Firebase Analytics

1. Descarga el SDK de Firebase Unity 5.5.0 y descomprímelo en el lugar que prefieras. (omite este paso si ya descargaste el SDK)
2. Abre el proyecto de Unity de Awesome Drawing Quiz, navega a Recursos > Importar paquete > Custom Package
3. Desde el SDK que descomprimiste, importa el SDK de Firebase Analytics (dotnet4/FirebaseAnalytics.unitypackage).
4. En la ventana Importar paquete de Unity, haz clic en Importar.

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+Firebase 101.

4. Cómo crear un embudo de eventos de aplicaciones

Es posible que hayas agregado algunos eventos de aplicaciones 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 con el evento, como los recuentos totales, los recuentos promedio por usuario, los datos demográficos, etcétera.

Sin embargo, ¿qué sucede si quieres ver la tasa 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 aplicaciones.

Importante: Los embudos de Firebase son 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).

Cómo crear un embudo

Para crear un embudo, siga estos pasos:

1. Ve a Firebase console y selecciona el proyecto de 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:

Nombre del embudo n.o 1: Tasa de éxito del nivel Eventos: level_start, level_success

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

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

Consulta el análisis de embudo

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

Como ejemplo, haz clic en Índice de éxito de niveles. Se mostrarán los detalles del embudo de la siguiente manera:

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

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

Según las métricas de la captura de pantalla anterior, hubo 116 intentos (se activaron el evento level_start) y 57 eliminaciones (se activaron 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 otras.

5. Integra Remote Config en la app

Dado que puedes obtener estadísticas sobre tu aplicación en función de sus eventos y el embudo, te recomendamos que la optimices. Por lo general, incluye un ajuste del valor del parámetro en la app. Para modificar el valor de esos parámetros, deberás actualizar la app de modo que los cambios se puedan aplicar a los usuarios.

Con Remote Config en Firebase, puedes ajustar esos valores sin necesidad de actualizar la app. Esto significa que puedes cambiar el comportamiento de la app sin tener que forzar a los usuarios a descargar la actualización.

En este codelab, aprenderás a ajustar el importe de la recompensa (cantidad de letras que se divulgarán después de mirar un anuncio de video recompensado) sin una actualización de la app. Para ello, usarás Remote Config.

Agrega el SDK de Firebase Remote Config

5. Descarga el SDK de Firebase Unity 5.5.0 y descomprímelo en el lugar que prefieras.
6. Abre el proyecto de Unity de Awesome Drawing Quiz, navega a Recursos > Importar paquete > Custom Package
7. Desde el SDK que descomprimiste, importa el SDK de Remote Config (dotnet4/FirebaseRemoteConfig.unitypackage).
8. En la ventana Importar paquete de Unity, haz clic en Importar.

Importa Firebase.RemoteConfig

Modifica Main.cs para que puedas usar el tipo de Firebase.RemoteConfig sin tener que usar el nombre completamente calificado.

Escenas/Main.cs

...

using AwesomeDrawingQuiz.Game;

// TODO: Import Firebase.RemoteConfig (102)
using Firebase.RemoteConfig;

namespace AwesomeDrawingQuiz.Scene {
    ...
}

Inicializa y Recupera valores de Remote Config

Modifica el método InitAndFetchRemoteConfig() en Main.cs para inicializar la instancia de Remote Config como se indica a continuación. Ten en cuenta que GameSettings.KEY_REWARD_AMOUNT contiene el nombre del parámetro en Remote Config. (Pronto declararás este campo en este codelab)

Escenas/Main.cs

private Task InitAndFetchRemoteConfig() {
    // TODO: Initialize and Fetch values from the Remote Config (102)
    Dictionary<string, object> defaults = new Dictionary<string, object>();
    defaults.Add(GameSettings.KEY_REWARD_AMOUNT, 1);
    FirebaseRemoteConfig.SetDefaults(defaults);

    if (Debug.isDebugBuild) {
        ConfigSettings config = new ConfigSettings();
        config.IsDeveloperMode = true;
        FirebaseRemoteConfig.Settings = config;
        return FirebaseRemoteConfig.FetchAsync(System.TimeSpan.Zero);
    } else {
        return FirebaseRemoteConfig.FetchAsync();
    }
}

Verás que la instancia FirebaseRemoteConfig está configurada para recuperar los valores más recientes del servidor en modo de depuración a fin de facilitar el proceso de desarrollo. (IsDeveloperMode = true y FetchAsync(System.TimeSpan.Zero))

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

Activa valores recuperados de Remote Config

Cuando hayas recuperado correctamente los valores de Remote Config, debes activarlos para que estén disponibles en la app. Modifica el método ActivateRemoteConfigValues() como se indica a continuación.

Escenas/Main.cs

private void ActivateRemoteConfigValues() {
    // TODO: Activate fetched Remote Config values (102)
    FirebaseRemoteConfig.ActivateFetched();
}

Cómo modificar el método Start()

Para que la app recupere datos activa el valor de Remote Config cuando se inicia la app, modifica el método Start() en el archivo Main.cs como se indica a continuación.

Escenas/Main.cs

void Start () {
    ...
    Firebase.FirebaseApp.CheckAndFixDependenciesAsync().ContinueWith(task => {
        ...
    }).ContinueWith(task => { 
        // TODO: Call InitAndFetchRemoteConfig() (102)
        InitAndFetchRemoteConfig();
    }).ContinueWith(task => {
        // TODO: Call ActivateRemoteConfigValues() (102)
        ActivateRemoteConfigValues();

        // Enable 'Start a game' button
        UnityMainThreadDispatcher.Instance()
            .Enqueue(() => buttonStartGame.interactable = true);
    });
    #else
    QuizAnalytics.SetScreenName(QuizAnalytics.SCREEN_MAIN);

    // TODO: Call InitAndFetchRemoteConfig() (102)
    InitAndFetchRemoteConfig().ContinueWith(task => {
        // TODO: Call ActivateRemoteConfigValues() (102)
        ActivateRemoteConfigValues();
    });
    #endif
}

Recupera el importe de la recompensa desde Remote Config

Modifica la clase GameSettings para recuperar el importe de la recompensa desde Remote Config.

Game/GameSettings.cs

// TODO: Import Firebase.RemoteConfig (102)
using Firebase.RemoteConfig;

namespace AwesomeDrawingQuiz.Game {
    public class GameSettings {

        ...
        
        // TODO: Apply reward amount from the Remote Config (102)
        public const string KEY_REWARD_AMOUNT = "reward_amount";

        public static GameSettings Instance {
            get {
                return instance;
            }
        }

        ...

        public int RewardAmount {
            get {
                // TODO: Apply reward amount from the Remote Config (102)
                return (int) FirebaseRemoteConfig.GetValue(KEY_REWARD_AMOUNT).LongValue;
            }
            private set { }
        }
    }
}

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 selecciona el proyecto de Awesome Drawing Quiz que creaste anteriormente. Haz clic en Remote Config -> ADD YOUR FIRST PARAMETER.

Asigna el nombre reward_amount al parámetro 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 publicar el cambio para los usuarios.

6. Cambia 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 personajes más a modo de pista después de ver un anuncio recompensado.

Actualiza el valor predeterminado del parámetro recompensa_amount

Ve a Firebase console y, luego, selecciona el proyecto de 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 haz clic en el botón Actualizar.

Haz clic en el botón Publicar cambios para publicar el cambio 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. Cuando termines de ver un anuncio recompensado, notarás que la app mostrará dos letras como recompensa, tal como lo configuramos en la consola de Remote Config.

Antes de mirar un anuncio recompensado

Se reveló 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 que el importe que se modifica es bueno para la app?

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

Diseña el experimento

Antes de crear un experimento nuevo, debes establecer un objetivo claro del 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 de los anuncios, etcétera)
• Por qué: ¿Cuál es tu objetivo comercial para ejecutar el experimento? (p.ej., para maximizar los ingresos publicitarios, aumentar la retención, etcétera).
• Quién: ¿Quién es sujeto a participar en el experimento? (p. ej., Todos los usuarios, público específico de usuarios, etc.)

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

Cómo crear el experimento

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

Selecciona Remote Config para crear un experimento de la función.

Asigna el nombre "Importe de la recompensa" al experimento, como se muestra en la siguiente captura de pantalla.

Configura las opciones de segmentación. En este codelab, te orientarás al 100% de los usuarios de 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 Participación diaria de los usuarios como la métrica principal a la que deseas hacer un seguimiento.

Precaución: Si seleccionas un evento de estadísticas (p.ej., level_success, level_fail, etc.) como métrica principal, 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 variantes porque la capacidad de procesamiento (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 control y el grupo de variantes para determinar cuál tiene el mejor rendimiento. Selecciona reward_amount en el grupo de control y deja su valor sin modificar. Para el 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 "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 recompensas afecta a los usuarios.

Cuando hagas clic en el botón Revisar, verás una descripción general del experimento de la siguiente manera.

Ejecutar 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

Cómo consultar el progreso del experimento

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

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

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

En la tabla que se encuentra debajo de la sección Descripción general de la mejora, puedes verificar los detalles de las métricas de objetivos del experimento, así como de las métricas adicionales a las que se les hace un seguimiento. En la siguiente captura de pantalla, se muestra un ejemplo de la sección de detalles de las métricas.

Implementar la variante principal para todos los usuarios

Una vez que el experimento se haya ejecutado durante un tiempo prolongado y tengas una variante ganadora o líder, puedes lanzarlo para el 100% de los usuarios. Una vez que A/B Testing haya encontrado una variante principal clara, te alentará a lanzar la variante principal para todos los usuarios.

Sin embargo, incluso si no se declaró una variante evidente en el experimento, puedes implementar una variante para todos los usuarios.

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

Elige una variante para lanzarla para todos los usuarios y, luego, haz clic en el botón Revisar en Remote Config para revisar los cambios antes de hacer una modificación 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 se publique para todos los usuarios.

9. Todo listo

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