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, como 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.

DICA

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.

Este é um identificador de visitante único e específico do aplicativo, gerado na primeira inicialização e armazenado e usado 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);
```
trackLifetimeValueIncrease

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);
```
trackTimedActionStart

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.

DICA

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)
```
trackTimedActionUpdate

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.

DICA

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);
```
trackTimedActionEnd

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.

DICA

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();
```
  AVISO
  
  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

IMPORTANTE

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);
```