Show Menu
TEMAS×

Métodos de Analytics

Esta es una lista de métodos de Adobe Analytics que proporciona la biblioteca Android.
Ahora mismo, el SDK admite varias soluciones de Adobe Experience Cloud, incluidas Analytics, Target, Audience Manager y el servicio de ID de Adobe Experience Platform. Los métodos tienen un prefijo de acuerdo con la solución. Por ejemplo, los métodos de Experience Cloud ID llevan el prefijo analytics .
Los siguientes métodos se emplean para enviar datos a su grupo de informes de Adobe Analytics:
  • trackState
    Realiza el seguimiento del estado de una aplicación con datos de contexto opcionales. Los estados son las vistas que están disponibles en la aplicación, como home dashboard , app settings o cart , entre otros. Estos estados son similares a las páginas de un sitio web y las llamadas trackState incrementan las visualizaciones de página.
    Si el state está vacío, en los informes se muestra app name app version (build) . Si observa este valor en los informes, asegúrese de que establece un state en cada llamada trackState .
    Esta es la única llamada de seguimiento que incrementa las visualizaciones de página.
    • Esta es la sintaxis para este método:
      public static void trackState(String state, Map<String, Object> contextData);
      
      
    • Este es un ejemplo de código para este método:
      Analytics.trackState("loginScreen", null);
      
      
  • trackAction Realiza el seguimiento de una acción en la aplicación.
    Acciones que le interesará medir, como logons , banner taps , feed subscriptions y otras métricas que se producen en la aplicación.
    • Esta es la sintaxis para este método:
      public static void trackAction(String state, Map<String, Object> contextData);
      
      
    • Este es un ejemplo de código para este método:
      Analytics.trackAction("heroBannerTouched", null);
      
      
  • getTrackingIdentifier Devuelve el identificador de usuario generado de forma automática para Analytics.
    Se trata de un ID exclusivo y específico para la aplicación que se genera durante el primer inicio, que después se almacena y utiliza a partir de ese momento. Este ID se preserva al actualizar la aplicación y se elimina al desinstalarla.
    • Esta es la sintaxis para este método:
      public static String getTrackingIdentifier();
      
      
    • Este es un ejemplo de código para este método:
      String trackingId = Analytics.getTrackingIdentifier();
      
      
  • trackLocation
    Envía la latitud, longitud y ubicación actuales en un determinado punto de interés. Para obtener más información, consulte Geolocalización y puntos de interés .
    • Esta es la sintaxis para este método:
      public static void trackLocation(Location location, Map<String, Object> contextData);
      
      
    • Este es un ejemplo de código para este método:
      Analytics.trackLocation(userLocation, null);
      
      
  • trackLifetime​ValueIncrease
    Agrega una amount al valor de duración del usuario.
    • Esta es la sintaxis para este método:
      public static void trackLifetimeValueIncrease(BigDecimal amount, Map<String, Object> contextData);
      
      
    • Este es un ejemplo de código para este método:
      Analytics.trackLifetimeValueIncrease(new BigDecimal(30), null);
      
      
  • trackTimed​ActionStart
    Inicia una acción temporizada llamada action .
    Si invoca este método para una acción que ya se ha iniciado, se sobrescribe la acción temporizada anterior.
    Esta llamada no envía una visita.
    • Esta es la sintaxis para este método:
    public static void trackTimedActionStart(String action, Map<String, Object> contextData);
    
    
    • Este es un ejemplo de código para este método:
      Analytics.trackTimedActionStart("cartToCheckout", null)
      
      
  • trackTimed​ActionUpdate
    Pasa contextData para actualizar los datos de contexto asociados con action . Los data que se pasan se anexan a los ya existentes para la acción. Si la misma clave ya está definida para action , los datos se sobrescriben.
    Esta llamada no envía una visita.
    • Esta es la sintaxis para este método:
      public static void trackTimedActionUpdate(String action, Map<String, Object> contextData);
      
      
    • Este es un ejemplo de código para este método:
      HashMap cdata = new HashMap<String Object> ();
      cdata.put("quantity",3);
      Analytics.trackTimedActionUpdate("cartToCheckout", cdata);
      
      
  • trackTimed​ActionEnd
    Finaliza una acción temporizada. Si proporciona un valor para block , puede acceder a los valores de tiempo finales y manipular los data antes de enviar la visita final.
    Si proporciona block , debe devolver true para enviar una visita. Pasar el valor null para block envía la visita final.
    • Esta es la sintaxis para este método:
      public static void trackTimedActionEnd(String action, TimedActionBlock<Boolean> logic);
      
      
    • Este es un ejemplo 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
    Requiere SDK 4.1.
    Independientemente de cuántas visitas haya en cola, este método obliga a la biblioteca a enviar todas las visitas en la cola sin conexión.
    • Esta es la sintaxis para este método:
      public static void sendQueuedHits();
      
      
    • Este es un ejemplo de código para este método:
      Analytics.sendQueuedHits();
      
      
  • getQueueSize
    Devuelve el número de llamadas de seguimiento almacenadas en la cola sin conexión.
    • Esta es la sintaxis para este método:
      public static long getQueueSize();
      
      
    • Este es un ejemplo de código para este método:
      long queueSize = Analytics.getQueueSize();
      
      
  • clearQueue
    Borra todas las visitas de la cola sin conexión.
    • Esta es la sintaxis para este método:
      public static void clearQueue();
      
      
    • Este es un ejemplo de código para este método:
      Analytics.clearQueue();
      
      
      Tenga cuidado al borrar la cola de forma manual. Este proceso no se puede revertir.
  • processReferrer
    Procesa los datos de campaña del referente desde la tienda Google Play para utilizarlo posteriormente.
    • Esta es la sintaxis para este método:
      public static void processReferrer(final Context context, final Intent intent);
      
      
    • Este es un ejemplo de código para este método:
      Analytics.processReferrer(getApplicationContext(), intent);
      
      
  • processGooglePlayInstallReferrerUrl
    Esta API está disponible a partir de la versión 4.18.0 del SDK
    Recupera datos de adquisición de la URL del referente de instalación de Google Play proporcionada.
    Los datos recopilados de esta API se enviarán en las visitas de instalación enviadas a Analytics y estarán disponibles en la llamada de retorno de datos de Adobe.
    Si el SDK ya ha recopilado los datos del referente, invocar este método dará como resultado una «no-operation».
    Para obtener información sobre cómo recuperar la dirección URL del referente, consulte la documentación de Google: https://developer.android.com/google/play/installreferrer/library.
    • Esta es la sintaxis para este método:
      public static void processGooglePlayInstallReferrerUrl(final String referrerUrl);
      
      
    • Este es un ejemplo de código para este método:
      Analytics.processGooglePlayInstallReferrerUrl(referrerUrl);