Show Menu
TÓPICOS×

Métodos do Analytics

Esta é uma lista de métodos do Adobe Analytics fornecida pela biblioteca do Android.
Atualmente, o SDK é compatível com várias soluções da Adobe Experience Cloud, incluindo o Analytics, o Target, o Audience Manager e o Adobe Experience Platform Identity Service. Os métodos recebem o prefixo de acordo com a solução, por exemplo, métodos da Experience Cloud ID recebem o prefixo analytics .
Cada um destes métodos é usado para enviar dados para o conjunto de relatórios do Adobe Analytics:
  • trackState
    Rastreia um estado de aplicativo com dados de contexto opcionais. Os estados são as exibições disponíveis no aplicativo, como home dashboard , app settings , cart , e assim por diante. Esses estados são semelhantes às páginas em um site, e as chamadas de trackState aumentam as visualizações de página.
    Se state estiver vazio, app name app version (build) será exibido nos relatórios. Caso veja esse valor em relatórios, certifique-se de configurar state em cada chamada de trackState .
    Esta é a única chamada de rastreamento que aumenta as exibições de página.
    • Esta é a sintaxe para este método:
      public static void trackState(String state, Map<String, Object> contextData);
      
      
    • Esta é a amostra de código para este método:
      Analytics.trackState("loginScreen", null);
      
      
  • trackAction Rastreia uma ação no seu aplicativo.
    Ações que deseja medir, como logons , banner taps , feed subscriptions e outras métricas que ocorrem no aplicativo.
    • Esta é a sintaxe para este método:
      public static void trackAction(String state, Map<String, Object> contextData);
      
      
    • Esta é a amostra de código para este método:
      Analytics.trackAction("heroBannerTouched", null);
      
      
  • getTrackingIdentifier Retorna o identificador de visitante gerado automaticamente pelo Analytics.
    Esta é uma ID de visitante única e específica do aplicativo gerada na primeira inicialização, armazenada e utilizada a partir desse ponto. A ID é preservada entre as atualizações do aplicativo e é removida quando o aplicativo é desinstalado.
    • Esta é a sintaxe para este método:
      public static String getTrackingIdentifier();
      
      
    • Esta é a amostra de código para este método:
      String trackingId = Analytics.getTrackingIdentifier();
      
      
  • trackLocation
    Envia latitude, longitude e localização atuais em um ponto de interesse definido. Para obter mais informações, consulte Geolocalização e pontos de interesse .
    • Esta é a sintaxe para este método:
      public static void trackLocation(Location location, Map<String, Object> contextData);
      
      
    • Esta é a amostra de código para este método:
      Analytics.trackLocation(userLocation, null);
      
      
  • trackLifetime​ValueIncrease
    Adiciona uma amount ao valor do ciclo de vida do usuário.
    • Esta é a sintaxe para este método:
      public static void trackLifetimeValueIncrease(BigDecimal amount, Map<String, Object> contextData);
      
      
    • Esta é a amostra de código para este método:
      Analytics.trackLifetimeValueIncrease(new BigDecimal(30), null);
      
      
  • trackTimed​ActionStart
    Inicia uma ação programada com a action de nome.
    Se você chamar este método para uma ação já iniciada, a ação programada anterior será substituída.
    Essa chamada não envia uma ocorrência.
    • Esta é a sintaxe para este método:
    public static void trackTimedActionStart(String action, Map<String, Object> contextData);
    
    
    • Esta é a amostra de código para este método:
      Analytics.trackTimedActionStart("cartToCheckout", null)
      
      
  • trackTimed​ActionUpdate
    Passa em contextData para atualizar os dados de contexto associados a action . Os data passados estão anexados aos dados existentes da ação e, se a mesma chave já estiver definida como action , eles substituirão os dados.
    Essa chamada não envia uma ocorrência.
    • Esta é a sintaxe para este método:
      public static void trackTimedActionUpdate(String action, Map<String, Object> contextData);
      
      
    • Esta é uma amostra de código para este método:
      HashMap cdata = new HashMap<String Object> ();
      cdata.put("quantity",3);
      Analytics.trackTimedActionUpdate("cartToCheckout", cdata);
      
      
  • trackTimed​ActionEnd
    Encerra uma ação programada. Se você fornecer block , poderá acessar os valores de tempo finais e manipular data antes de enviar a ocorrência final.
    Se você fornecer block , deverá retornar true para enviar uma ocorrência. Passar null para block envia a ocorrência final.
    • Esta é a sintaxe para este método:
      public static void trackTimedActionEnd(String action, TimedActionBlock<Boolean> logic);
      
      
    • Esta é a amostra de código para este método:
      Analytics.trackTimedActionEnd("cartToCheckout",new
      Analytics.TimedActionBlock<Boolean>(){
          @Override
          public Boolean call(long inAppDuration, long totalDuration, Map<String, Object> contextData) {
              contextData.put("price", 49.95);
              return true;
          }
      });
      
      
  • sendQueuedHits
    Exige SDK 4.1.
    Independentemente de quantas ocorrências estejam na fila, esse método faz com que biblioteca envie todas as ocorrências para a fila offline.
    • Esta é a sintaxe para este método:
      public static void sendQueuedHits();
      
      
    • Esta é a amostra de código para este método:
      Analytics.sendQueuedHits();
      
      
  • getQueueSize
    Devolve o número de chamadas de rastreamento armazenadas na fila offline.
    • Esta é a sintaxe para este método:
      public static long getQueueSize();
      
      
    • Esta é a amostra de código para este método:
      long queueSize = Analytics.getQueueSize();
      
      
  • clearQueue
    Apaga todas as ocorrências da fila offline.
    • Esta é a sintaxe para este método:
      public static void clearQueue();
      
      
    • Esta é a amostra de código para este método:
      Analytics.clearQueue();
      
      
      Tenha cuidado ao limpar manualmente a fila. Esse processo não pode ser revertido.
  • processReferrer
    Processa dados de campanha do referenciador da Google Play Store para uso posterior.
    • Esta é a sintaxe para este método:
      public static void processReferrer(final Context context, final Intent intent);
      
      
    • Esta é a amostra de código para este método:
      Analytics.processReferrer(getApplicationContext(), intent);
      
      
  • processGooglePlayInstallReferrerUrl
    Essa API está disponível a partir do SDK versão 4.18.0
    Recupera dados de aquisição do URL do Referenciador de instalação do Google Play fornecido.
    Os dados coletados dessa API serão enviados com ocorrências de instalação enviadas ao Analytics e estarão disponíveis na chamada de retorno de dados da Adobe.
    Se os dados do referenciador já tiverem sido coletados pelo SDK, chamar esse método resultará em uma operação inútil.
    Para obter informações sobre como recuperar o URL do referenciador, consulte a documentação do Google: https://developer.android.com/google/play/installreferrer/library.
    • Esta é a sintaxe para este método:
      public static void processGooglePlayInstallReferrerUrl(final String referrerUrl);
      
      
    • Esta é a amostra de código para este método:
      Analytics.processGooglePlayInstallReferrerUrl(referrerUrl);