Adobe Riferimento classe e metodo Mobile

Classi e metodi forniti dalla libreria BlackBerry.

Al momento l’SDK supporta Adobe Analytics e i metodi si trovano in classi separate in base alla soluzione.

Impostazioni SDK

  • getPrivacyStatus

    Restituisce la rappresentazione enum dello stato di privacy per l’utente corrente.

    • ADBMobilePrivacyStatusOptIn: gli hit vengono inviati immediatamente.

    • ADBMobilePrivacyStatusOptOut: gli hit vengono scartati.

    • ADBMobilePrivacyStatusUnknown - Se le marche temporali sono abilitate nella suite di rapporti, gli hit vengono salvati fino alla modifica dello stato di privacy, quando l’utente acconsente (opt in, gli hit vengono inviati) o rinuncia (opt out, gli hit vengono eliminati). Se le marche temporali non sono abilitate nella suite di rapporti, gli hit vengono eliminati fino alla modifica dello stato di privacy, quando l'utente acconsente (optedin).

      Il valore predefinito è impostato nel file ADBMobileConfig.json.

    • Di seguito è riportata la sintassi per questo metodo:

      static ADBMobilePrivacyStatus getPrivacyStatus();
      
    • Di seguito è riportato un esempio di codice per questo metodo:

      ADBMobilePrivacyStatus privacyStatus = ADBMobile::getPrivacyStatus();
      
  • Il metodo setPrivacyStatus

    Imposta lo stato di privacy per l'utente corrente su status. Imposta uno dei valori seguenti:

    • ADBMobilePrivacyStatusOptIn - gli hit vengono inviati immediatamente.

    • ADBMobilePrivacyStatusOptOut - gli hit vengono eliminati.

    • ADBMobilePrivacyStatusUnknown - Se le marche temporali sono abilitate nella suite di rapporti, gli hit vengono salvati fino alla modifica dello stato di privacy, quando l’utente acconsente (optedin, gli hit vengono inviati) o rinuncia (optedout, gli hit vengono eliminati). Se le marche temporali non sono abilitate nella suite di rapporti, gli hit vengono eliminati fino alla modifica dello stato di privacy, quando l'utente acconsente (optedin).

    • Di seguito è riportata la sintassi per questo metodo:

      static void setPrivacyStatus(ADBMobilePrivacyStatus status);
      
    • Di seguito è riportato un esempio di codice per questo metodo:

      ADBMobile::setPrivacyStatus(ADBMobilePrivacyStatusOptIn);
      
  • getUserIdentifier

    Restituisce l'identificatore utente se è stato impostato un identificatore personalizzato. Returns null if a custom identifier is not set. Il valore predefinito è null.

    • Di seguito è riportata la sintassi per questo metodo:

      static QString getUserIdentifier();
      
    • Di seguito è riportato un esempio di codice per questo metodo:

      QString userId = ADBMobile::getUserIdentifier(); 
      
  • setUserIdentifier

    Imposta l'identificatore utente su identifier.

    • Di seguito è riportata la sintassi per questo metodo:

      static void setUserIdentifier(QString identifier);
      
    • Di seguito è riportato un esempio di codice per questo metodo:

      ADBMobile::setUserIdentifier("billybob");
      
  • getDebugLogging

    Restituisce l'attuale preferenza di accesso di debug. Il valore predefinito è false.

    • Di seguito è riportata la sintassi per questo metodo:

      static bool getDebugLogging();
      
    • Di seguito è riportato un esempio di codice per questo metodo:

       bool debugging = ADBMobile::getDebugLogging(); 
      
  • setDebugLogging

    Imposta la preferenza per l'accesso di su debugLoggingdebug.

    • Di seguito è riportata la sintassi per questo metodo:

      static void setDebugLogging(bool debugLogging);
      
    • Di seguito è riportato un esempio di codice per questo metodo:

        ADBMobile::setDebugLogging(true); 
      
  • collectLifecycleData

    Indica all'SDK che i dati del ciclo di vita devono essere raccolti per l'utilizzo in tutte le soluzioni dell'SDK. Per ulteriori informazioni, vedi Metriche del ciclo di vita.

    • Di seguito è riportata la sintassi per questo metodo:

      static void collectLifecycleData();
      
    • Di seguito è riportato un esempio di codice per questo metodo:

      ApplicationUI::ApplicationUI(bb::cascades::Application *app):  QObject(app)  { 
      //... 
      ADBMobile::collectLifecycleData(); 
      }
      

Metodi di Analytics

Ciascuno di questi metodi viene usato 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 "dashboard iniziale", "impostazioni dell’app", "carrello" e così via. Questi stati sono simili alle pagine di un sito Web e le chiamate trackState incrementano le visualizzazioni di pagina.

    SUGGERIMENTO

    Questa è l'unica chiamata di tracciamento che incrementa le visualizzazioni pagina.

    • Di seguito è riportata la sintassi per questo metodo:

      static void trackState(QString state, QHash<QString, QString> contextData = QHash<QString, QString>()); 
      
    • Di seguito è riportato un esempio di codice per questo metodo:

         ADBMobile::trackState("loginScreen", null);
      
  • trackAction

    Tiene traccia di un'azione nell'applicazione. Le azioni sono gli eventi che avvengono nell’app e che desideri misurare, come "accessi", "tap sui banner", "abbonamenti ai feed" e altre metriche.

    • Di seguito è riportata la sintassi per questo metodo:

      static void trackAction(QString action, QHash<QString, QString> contextData = QHash<QString, QString>()); 
      
    • Di seguito è riportato un esempio di codice per questo metodo:

        ADBMobile::trackAction("heroBannerTouched", null); 
      
  • trackLocation

    Invia le coordinate x,y correnti. Sostituire l'evento con l'evento ricevuto dal sottoscrittore a BPS.

    • Di seguito è riportata la sintassi per questo metodo:

      static void trackLocation(bps_event_t *geoEvent, QHash<QString, QString> contextData = QHash<QString, QString> ());
      
    • Di seguito è riportato un esempio di codice per questo metodo:

        ADBMobile::trackLocation(event, null);
      

ADBMobileConfig.jsonGuida di riferimento per il file di configurazione

The ADBMobileConfig.json file must be placed in the assets folder.

  • rsids

    (Obbligatorio) Una o più suite di rapporti che dovrà ricevere i dati Analytics. Gli ID suite di rapporti multipli devono essere separati da virgole senza spazi intermedi.

    Esempio di codice per questa variabile:

    "rsids" : "rsid"
    
    "rsids" : "rsid1,rsid2"
    
  • server

    (Obbligatorio). Server di Analytics. Questa variabile deve essere compilata con il dominio del server, senza il prefisso del protocollo https:// o https://. Il prefisso del protocollo viene gestito automaticamente dalla libreria in base alla ssl variabile. Se ssl è true, viene eseguita una connessione sicura al server. Se ssl è false, viene eseguita una connessione non sicura.

  • charset

    Definisce il set di caratteri utilizzato per i dati inviati ad Analytics. Il set di caratteri serve per convertire i dati in entrata in UTF-8 per l'archiviazione e la generazione di rapporti.

  • ssl

    Abilita (true) o disabilita (false) l’invio di dati di misurazione tramite SSL (HTTPS). Il valore predefinito è false.

  • offlineEnabled

    When enabled (true), hits are queued while the device is offline and sent later when the device is online. Per poter usare il tracciamento offline, nella suite di rapporti devono essere abilitate le marche temporali.

    SUGGERIMENTO

    Se le marche temporali sono abilitate nella suite di rapporti, la proprietà di configurazione offlineEnabled deve essere true. Se le marche temporali non sono abilitate nella suite di rapporti, la proprietà di configurazione offlineEnabled deve essere false. Se questo non viene configurato correttamente, i dati andranno perduti. Se non sei sicuro se le marche temporali sono abilitate o meno nella suite di rapporti, contatta SupportoEnterprise.

    If you are currently reporting AppMeasurement data to a report suite that also collects data from JavaScript, you might need to set up a separate report suite for mobile data, or include a custom timestamp on all JavaScript hits using the s.timestamp variable.

    Il valore predefinito è false.

  • lifecycleTimeout

    Specifica il tempo, in secondi, che deve trascorrere tra gli avvii dell'app prima che l'avvio venga considerato una nuova sessione. Questo timeout si applica anche quando l’applicazione viene messa in background e riattivata. Il tempo trascorso in background dall’app non viene incluso nella durata della sessione.

    Il valore predefinito è 300 secondi.

  • batchLimit

    Numero massimo di hit offline memorizzati nella coda. Il valore predefinito è 0 (nessun limite).

  • privacyDefault

    • optedin - gli hit vengono inviati immediatamente.

    • optedout - gli hit vengono eliminati.

    • optunknown - Se le marche temporali sono abilitate nella suite di rapporti, gli hit vengono salvati fino alla modifica dello stato di privacy, quando l’utente acconsente (optedin, gli hit vengono inviati) o rinuncia (optedout, gli hit vengono eliminati).

      Se le marche temporali non sono abilitate nella suite di rapporti, gli hit vengono eliminati fino alla modifica dello stato di privacy, quando l'utente acconsente (optedin).
      Questa variabile imposta solo il valore iniziale. Se questo valore viene impostato o modificato nel codice, il nuovo valore viene utilizzato finché non viene modificato oppure finché l'app non viene disinstallata e reinstallata.

    Il valore predefinito è optedin.

The following is an example of an ADBMobileConfig.json file:

{ 
    "version" : "1.0", 
    "analytics" : { 
        "rsids" : "coolApp", 
        "server" : "my.CoolApp.com", 
        "charset" : "UTF-8", 
        "ssl" : true, 
        "offlineEnabled" : true, 
        "lifecycleTimeout" : 5, 
        "privacyDefault" : "optedin", 
    } 
}

In questa pagina