Show Menu
TEMAS×

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

Para descargar los SDK, debe utilizar Android 2.2 o una versión posterior.
  1. Complete los pasos de las secciones siguientes para configurar un grupo de informes de desarrollo y descargar una versión previamente rellenada del archivo de configuración:
  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.
    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. Select 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 siguiente pasos en cada actividad de su 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(); 
    }
    
    
Debe añadir estas llamadas a todas las actividades para garantizar la precisión al realizar informes de bloqueo. Para obtener más información, consulte Seguimiento de bloqueos de aplicaciones .

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: