Implementación principal y ciclo vital

Esta información le ayuda a implementar la biblioteca Android y a recopilar métricas del ciclo vital como lanzamientos, actualizaciones, sesiones, usuarios comprometidos, etcétera.

Descargar el SDK

1. Complete los pasos de las secciones siguientes para configurar un grupo de informes de desarrollo y descargar una versión previamente completada del archivo de configuración:

   • Crear un grupo de informes
   • Descargar el SDK

2. Descargue y descomprima el archivo [Your_App_Name_]AdobeMobileLibrary-4.*-Android.zip y compruebe que contiene los siguientes componentes de software:

   • adobeMobileLibrary.jar, esta es la biblioteca que se utilizará con los simuladores y dispositivos Android.

   • ADBMobileConfig.json, que es el archivo de configuración del SDK personalizado para su aplicación.

   IMPORTANTE

   Si descarga el SDK fuera de la interfaz de usuario de Adobe Mobile Services, el archivo ADBMobileConfig.json deberá configurarse de forma manual. Si no tiene experiencia previa con Analytics ni con el SDK de Mobile y desea configurar un grupo de informes de desarrollo y descargar una versión previamente rellenada del archivo de configuración, consulte Antes de comenzar.

Añadir el SDK y el archivo de configuración a su proyecto IntelliJ IDEA o Eclipse

Proyecto IntelliJ IDEA

Para añadir el SDK y el archivo de configuración a su proyecto:

1. Añada el archivo ADBMobileConfig.json a la carpeta assets de su proyecto.

2. En el panel Navegación del proyecto, haga clic en el proyecto con el botón secundario.

3. Seleccione Abrir configuración del módulo.

4. En Configuración del proyecto, seleccione Bibliotecas.

5. Haga clic en el icono + para agregar una biblioteca nueva.

6. Seleccione Java y busque el archivo adobeMobileLibrary.jar.

7. Seleccione los módulos donde quiere usar la biblioteca móvil.

8. Haga clic en Aplicar y en Aceptar para cerrar la ventana Configuración del módulo.

Proyecto Eclipse

Para añadir el SDK y el archivo de configuración a su proyecto:

1. Añada el archivo ADBMobileConfig.json a la carpeta assets de su proyecto.
2. En Eclipse IDE, haga clic con el botón secundario en el nombre del proyecto.
3. Haga clic en Ruta de compilación > Agregar archivos externos.
4. Seleccione adobeMobileLibrary.jar.
5. Haga clic en Abrir.
6. Vuelva a hacer clic con el botón secundario en el proyecto y seleccione Ruta de compilación > Configurar ruta de compilación.
7. En la ficha Ordenar y exportar, asegúrese de que adobeMobileLibrary.jar está seleccionado.

Añadir permisos de aplicaciones

La biblioteca AppMeasurement requiere los siguientes permisos para enviar datos y registrar llamadas de seguimiento sin conexión:

• INTERNET
• ACCESS_NETWORK_STATE

Para agregar estos permisos, agregue las siguientes líneas al archivo AndroidManifest.xml, que se encuentra en el directorio del proyecto de la aplicación:

<uses-permission android:name="android.permission.INTERNET" /> 
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

Establecer el contexto de la aplicación

Se debe agregar el siguiente código en el método onCreate de la actividad principal:

   @Override
   public void onCreate(BundlesavedInstanceState){
     super.onCreate(savedInstanceState)
     setContentView(R.layout.main);
     Config.setContext(this.getApplicationContext());
   }

Implementar métricas del ciclo vital

Después de habilitar el ciclo vital, cada vez que inicie la aplicación se enviará una visita para medir inicios, actualizaciones, sesiones, usuarios comprometidos y muchas otras métricas. Para obtener más información, consulte Métricas del ciclo vital.

Complete los pasos siguientes en cada actividad de la aplicación:

1. Importe la biblioteca:

   import com.adobe.mobile.*;
   

2. En la función onResume, inicie la recopilación de datos del ciclo vital:

   @Override 
   public void onResume() { 
       Config.collectLifecycleData(this); 
       // -or- Config.collectLifecycleData(this, contextData); 
   }
   

3. En la función onPause, ponga en pausa la recopilación de datos del ciclo vital:

   @Override 
   public void onPause() { 
       Config.pauseCollectingLifecycleData(); 
   }
   

Incluir datos adicionales en las llamadas al ciclo vital

Para incluir datos adicionales en las llamadas a métricas del ciclo vital, pase a collectLifecycleData un parámetro adicional que contenga datos de contexto:

@Override 
public void onResume() {
    HashMap<String, Object> contextData = new HashMap<String, Object>(); 
    contextData.put("myapp.category", "Game"); 
    Config.collectLifecycleData(this, contextData); 
}

El valor de los datos de contexto adicionales que se envían con collectLifecycleData debe asignarse a variables personalizadas en Adobe Mobile Services:

Otras métricas del ciclo vital se recopilan automáticamente. Para obtener más información, consulte Métricas del ciclo vital.

Qué hacer a continuación

Complete las siguientes tareas:

• Seguimiento de estados de aplicaciones
• Seguimiento de acciones de aplicaciones