Estas informações ajudam a implementar a biblioteca do Android e coletar medições de ciclo de vida, como lançamentos, atualizações, sessões, usuários envolvidos e assim por diante.
Para baixar o SDK, é necessário usar o Android 2.2, ou versão posterior.
Complete as etapas nas seções a seguir para configurar um conjunto de relatórios de desenvolvimento e baixar uma versão pré-preenchida do arquivo de configuração:
Baixe e descompacte o arquivo [Your_App_Name_]AdobeMobileLibrary-4.*-Android.zip
e verifique se os seguintes componentes de software existem:
adobeMobileLibrary.jar
, que é a biblioteca que será usada pelos dispositivos e simuladores Android.
ADBMobileConfig.json
, que é o arquivo de configuração de SDK personalizado para o seu aplicativo.
Se você baixar o SDK fora da interface do Adobe Mobile Services, o arquivo ADBMobileConfig.json
deverá ser configurado manualmente. Se você nunca usou o Analytics e o Mobile SDK, e deseja configurar um conjunto de relatórios de desenvolvimento e baixar uma versão já preenchida do arquivo de configuração, consulte Antes de começar.
Projeto IntelliJ IDEA
Para adicionar o SDK e o arquivo de configuração ao projeto:
Adicione o arquivo ADBMobileConfig.json
à pasta assets
do projeto.
Clique com o botão direito no seu projeto, no painel Navegação do projeto.
Selecione Abrir configurações do módulo.
Em Configurações do projeto, selecione Bibliotecas.
Clique no ícone + para adicionar uma nova biblioteca.
Selecione Java e navegue até o arquivo adobeMobileLibrary.jar
.
Selecione os módulos nos quais planeja usar a biblioteca móvel.
Clique em Aplicar e em OK para fechar a janela Configurações do módulo.
Projeto Eclipse
Para adicionar o SDK e o arquivo de configuração ao projeto:
ADBMobileConfig.json
à pasta assets
do projeto.adobeMobileLibrary.jar
.adobeMobileLibrary.jar
esteja selecionado.A biblioteca do AppMeasurement pede as seguintes permissões para enviar dados e gravar chamadas de rastreamento offline:
INTERNET
ACCESS_NETWORK_STATE
Para adicionar essas permissões, adicione as seguintes linhas no arquivo AndroidManifest.xml
, localizado no diretório do projeto do aplicativo:
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
O código a seguir deve ser adicionado ao método onCreate
da atividade principal:
@Override
public void onCreate(BundlesavedInstanceState){
super.onCreate(savedInstanceState)
setContentView(R.layout.main);
Config.setContext(this.getApplicationContext());
}
Após habilitar o ciclo de vida, cada vez que o aplicativo é iniciado uma ocorrência é enviada para medir as inicializações, atualizações, usuários engajados e muitas outras métricas. Para obter mais informações, consulte Medições de ciclo de vida.
Complete as etapas a seguir em cada atividade do aplicativo:
Importe a biblioteca:
import com.adobe.mobile.*;
Na função onResume
, inicie a coleção de dados do ciclo de vida:
@Override
public void onResume() {
Config.collectLifecycleData(this);
// -or- Config.collectLifecycleData(this, contextData);
}
Na função onPause
, pause a coleção de dados do ciclo de vida:
@Override
public void onPause() {
Config.pauseCollectingLifecycleData();
}
É necessário adicionar essas chamadas em todas as atividades para garantir relatórios de falhas precisos. Para obter mais informações, consulte Rastrear falhas do aplicativo.
Para incluir dados adicionais com chamadas de medições de ciclo de vida, passe um parâmetro adicional para o collectLifecycleData
que contém os dados de contexto:
@Override
public void onResume() {
HashMap<String, Object> contextData = new HashMap<String, Object>();
contextData.put("myapp.category", "Game");
Config.collectLifecycleData(this, contextData);
}
Os valores dos dados de contexto adicionais enviados com o collectLifecycleData
devem ser mapeados para variáveis personalizadas no Adobe Mobile Services:
As outras medições de ciclo de vida são coletadas automaticamente. Para obter mais informações, consulte Medições de ciclo de vida.
Conclua as seguintes tarefas: