Show Menu
ARGOMENTI×

Metodi di Analytics

Elenco dei metodi di Adobe Analytics forniti dalla libreria Android.
L'SDK supporta attualmente più soluzioni Adobe Experience Cloud, tra cui Analytics, Target, Audience Manager e il servizio Adobe Experience Platform Identity. I metodi hanno un prefisso in base alla soluzione; ad esempio, i metodi del servizio Experience Cloud ID hanno il prefisso analytics .
Ciascuno dei seguenti metodi è utilizzato per inviare dati alla suite di rapporti di Adobe Analytics:
  • trackState
    Tiene traccia dello stato di un'app con dati contestuali facoltativi. Gli stati sono le visualizzazioni disponibili nell'app, ad esempio home dashboard , app settings , cart e così via. Questi stati sono simili alle pagine di un sito Web e le chiamate trackState incrementano le visualizzazioni di pagina.
    Se state è vuoto, nei rapporti viene visualizzato app name app version (build) . Se visualizzi questo valore nei rapporti, accertati di impostare state in ciascuna chiamata trackState .
    Questa è l'unica chiamata di tracciamento che incrementa le visualizzazioni pagina.
    • Di seguito è riportata la sintassi per questo metodo:
      public staticvoidtrackState(Stringstate, Map<String,Object> contextData);
      
      
    • Di seguito è riportato un esempio di codice per questo metodo:
      Analytics.trackState("loginScreen",null);
      
      
  • trackAction Tiene traccia di un'azione nell'applicazione.
    Azioni che si verificano nell'app e che desideri misurare, ad esempio logons , banner taps , feed subscriptions e altre metriche.
    • Di seguito è riportata la sintassi per questo metodo:
      publicstaticvoidtrackAction(Stringstate,Map<String,Object> contextData);
      
      
    • Di seguito è riportato un esempio di codice per questo metodo:
      Analytics.trackAction("heroBannerTouched",null);
      
      
  • getTrackingIdentifier Restituisce l'identificatore del visitatore generato automaticamente per Analytics.
    Si tratta di un ID visitatore univoco specifico per l'app, che viene generato all'avvio iniziale e quindi memorizzato e utilizzato da quel momento in poi. L'ID viene conservato durante gli aggiornamenti dell'app e rimosso quando l'app viene disinstallata.
    • Di seguito è riportata la sintassi per questo metodo:
      public static String getTrackingIdentifier(); 
      
      
    • Di seguito è riportato un esempio di codice per questo metodo:
      String trackingId = Analytics.getTrackingIdentifier(); 
      
      
  • trackLocation
    Invia la latitudine, la longitudine e la posizione attuali in un punto di interesse definito. Per ulteriori informazioni, vedi Geolocalizzazione e punti di interesse .
    • Di seguito è riportata la sintassi per questo metodo:
      public static void trackLocation(Location location, Map<String,Object> contextData); 
      
      
    • Di seguito è riportato un esempio di codice per questo metodo:
      Analytics.trackLocation(userLocation, null);
      
      
  • trackLifetime​ValueIncrease
    Aggiunge al valore "lifetime" del ciclo di vita dell'utente un incremento pari a amount .
    • Di seguito è riportata la sintassi per questo metodo:
      publicstaticvoidtrackLifetimeValueIncrease(BigDecimalamount,Map<String,Object>contextData);
      
      
    • Di seguito è riportato un esempio di codice per questo metodo:
      Analytics.trackLifetimeValueIncrease(new BigDecimal(30), null);
      
      
  • trackTimed​ActionStart
    Avvia un'azione temporizzata con il nome action .
    Se invochi questo metodo per un'azione già avviata, l'azione temporizzata precedente viene sovrascritta.
    Questa chiamata non invia un hit.
    • Di seguito è riportata la sintassi per questo metodo:
    publicstaticvoidtrackTimedActionStart(Stringaction,Map<String,Object>contextData);
    
    
    • Di seguito è riportato un esempio di codice per questo metodo:
      Analytics.trackTimedActionStart("cartToCheckout",null)
      
      
  • trackTimed​ActionUpdate
    Passa in contextData per aggiornare i dati contestuali associati all'azione action . I dati data passati vengono aggiunti alla fine dei dati esistenti per l'azione, e li sovrascrivono se per l'azione action , è già definita la stessa chiave.
    Questa chiamata non invia un hit.
    • Di seguito è riportata la sintassi per questo metodo:
      public static void trackTimedActionUpdate(Stringaction,Map <String,Object> contextData); 
      
      
    • Di seguito è riportato un esempio di codice per questo metodo:
      HashMap cdata = new HashMap<String Object> (); 
      cdata.put("quantity",3); 
      Analytics.trackTimedActionUpdate("cartToCheckout", cdata);
      
      
  • trackTimed​ActionEnd
    Termina un'azione temporizzata. Se fornisci block , puoi accedere ai valori finali di tempo e manipolare i data prima di inviare l'hit finale.
    Se fornisci block , devi restituire true per inviare un hit. Passando null per block si invia l'hit finale.
    • Di seguito è riportata la sintassi per questo metodo:
      public static void trackTimedActionEnd(Stringaction,TimedActionBlock<Boolean> logic); 
      
      
    • Di seguito è riportato un esempio di codice per questo metodo:
      Analytics.trackTimedActionEnd("cartToCheckout",new
      Analytics.TimedActionBlock<Boolean>(){
        @Override
        public Booleancall(long inAppDuration,long totalDuration, Map<String,
      Object> contextData) {
              contextData.put("price", 49.95);
              return true;
         }
      });
      
      
  • sendQueuedHits
    Richiede SDK 4.1.
    Indipendentemente dal numero di hit nella coda, questo metodo forza la libreria a inviare tutti gli hit nella coda offline.
    • Di seguito è riportata la sintassi per questo metodo:
      voidsendQueuedHits()
      
      
    • Di seguito è riportato un esempio di codice per questo metodo:
      Analytics.sendQueuedHits();
      
      
  • getQueueSize
    Restituisce il numero di chiamate di tracking memorizzate nella coda offline.
    • Di seguito è riportata la sintassi per questo metodo:
      long getQueueSize()
      
      
    • Di seguito è riportato un esempio di codice per questo metodo:
      long queueSize = Analytics.getQueueSize(); 
      
      
  • clearQueue
    Elimina tutti gli hit dalla coda offline.
    • Di seguito è riportata la sintassi per questo metodo:
      voidclearQueue()
      
      
    • Di seguito è riportato un esempio di codice per questo metodo:
      Analytics.clearQueue();
      
      
      Fai molta attenzione quando cancelli manualmente la coda. Questo processo non può essere annullato.