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.
Para descargar los SDK, debe utilizar Android 2.2 o una versión posterior.
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:
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.
Proyecto IntelliJ IDEA
Para añadir el SDK y el archivo de configuración a su proyecto:
Añada el archivo ADBMobileConfig.json
a la carpeta assets
de su proyecto.
En el panel Navegación del proyecto, haga clic en el proyecto con el botón secundario.
Seleccione Abrir configuración del módulo.
En Configuración del proyecto, seleccione Bibliotecas.
Haga clic en el icono + para agregar una biblioteca nueva.
Seleccione Java y busque el archivo adobeMobileLibrary.jar
.
Seleccione los módulos donde quiere usar la biblioteca móvil.
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:
ADBMobileConfig.json
a la carpeta assets
de su proyecto.adobeMobileLibrary.jar
.adobeMobileLibrary.jar
está seleccionado.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" />
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());
}
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:
Importe la biblioteca:
import com.adobe.mobile.*;
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);
}
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.
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.
Complete las siguientes tareas: