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.

    CONSEJO

    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 de visitante exclusivo y específico para la aplicación que se genera durante el primer inicio y que se almacena y utiliza a partir de ese momento. El 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.

    CONSEJO

    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.

    CONSEJO

    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.

    CONSEJO

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

      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

    IMPORTANTE

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

En esta página

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free