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

IMPORTANTE

Para baixar o SDK, é necessário usar o Android 2.2, ou versão posterior.

  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:

  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 métricas 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(); 
    }
    
IMPORTANTE

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

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:

Nesta página