Implementação principal e ciclo de vida

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.

Baixar o SDK

1. 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:

   • Criar um conjunto de relatórios
   • Baixar o SDK

2. 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.

   IMPORTANTE

   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.

Adicionar o SDK e o arquivo de configuração ao projeto IntelliJ IDEA ou Eclipse

Projeto IntelliJ IDEA

Para adicionar o SDK e o arquivo de configuração ao projeto:

1. Adicione o arquivo ADBMobileConfig.json à pasta assets do projeto.

2. Clique com o botão direito no seu projeto, no painel Navegação do projeto.

3. Selecione Abrir configurações do módulo.

4. Em Configurações do projeto, selecione Bibliotecas.

5. Clique no ícone + para adicionar uma nova biblioteca.

6. Selecione Java e navegue até o arquivo adobeMobileLibrary.jar.

7. Selecione os módulos nos quais planeja usar a biblioteca móvel.

8. 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:

1. Adicione o arquivo ADBMobileConfig.json à pasta assets do projeto.
2. No Eclipse IDE, clique com o botão direito do mouse no nome do projeto.
3. Clique em Criar caminho > Adicionar arquivos externos.
4. Selecione adobeMobileLibrary.jar.
5. Clique em Abrir.
6. Clique com o botão direito no projeto novamente e selecione Criar caminho > Configurar caminho de construção.
7. Na guia Fazer pedido e exportar, certifique-se de que o adobeMobileLibrary.jar esteja selecionado.

Adicionar permissões do aplicativo

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" />

Definir o contexto do aplicativo

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());
   }

Implementar medições de ciclo de vida

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:

1. Importe a biblioteca:

   import com.adobe.mobile.*;
   

2. 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);
   }
   

3. Na função onPause, pause a coleção de dados do ciclo de vida:

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

Incluir dados adicionais com chamadas de ciclo de vida

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.

O que fazer em seguida

Conclua as seguintes tarefas:

• Rastrear estados do aplicativo
• Rastrear ações do aplicativo