Show Menu
THEMEN×

Adobe Mobile class and method reference

Klassen und Methoden, die von der BlackBerry-Bibliothek bereitgestellt werden.
The SDK currently has support for Adobe Analytics, and methods are in separate classes based on the solution.

SDK settings

  • getPrivacyStatus
    Gibt die Enum-Darstellung für den Datenschutzstatus des aktuellen Benutzers zurück.
    • ADBMobilePrivacyStatusOptIn: Treffer werden sofort gesendet.
    • ADBMobilePrivacyStatusOptOut: Treffer werden verworfen.
    • ADBMobilePrivacyStatusUnknown: Wenn für Ihre Report Suite Zeitstempel aktiviert sind, werden Treffer so lange gespeichert, bis der Datenschutzstatus in „opt-in“ (Treffer werden gesendet) oder „opt-out“ (Treffer werden verworfen) geändert wird. Wenn für Ihre Report Suite keine Zeitstempel aktiviert sind, werden die Treffer verworfen, bis der Datenschutzstatus zu „optedin“ geändert wird.
      Der Standardwert wird in der Datei ADBMobileConfig.json festgelegt.
    • Hier finden Sie die Syntax für diese Methode:
      static ADBMobilePrivacyStatus getPrivacyStatus();
      
      
    • Hier finden Sie ein Code-Beispiel für diese Methode:
      ADBMobilePrivacyStatus privacyStatus = ADBMobile::getPrivacyStatus();
      
      
  • setPrivacyStatus
    Legt für den aktuellen Benutzer den Datenschutzstatus status fest. Die folgenden Werte sind zulässig:
    • ADBMobilePrivacyStatusOptIn - Treffer werden sofort gesendet.
    • ADBMobilePrivacyStatusOptOut - werden Treffer verworfen.
    • ADBMobilePrivacyStatusUnknown : Wenn für Ihre Report Suite Zeitstempel aktiviert sind, werden Treffer so lange gespeichert, bis der Datenschutzstatus in „opt-in“ (Treffer werden gesendet) oder „opt-out“ (Treffer werden verworfen) geändert wird. Wenn für Ihre Report Suite keine Zeitstempel aktiviert sind, werden die Treffer verworfen, bis der Datenschutzstatus zu „optedin“ geändert wird.
    • Hier finden Sie die Syntax für diese Methode:
      static void setPrivacyStatus(ADBMobilePrivacyStatus status);
      
      
    • Hier finden Sie ein Code-Beispiel für diese Methode:
      ADBMobile::setPrivacyStatus(ADBMobilePrivacyStatusOptIn);
      
      
  • getUserIdentifier
    Gibt die Benutzer-ID zurück, sofern eine benutzerdefinierte ID festgelegt wurde. Returns null if a custom identifier is not set. Der Standardwert lautet  null .
    • Hier finden Sie die Syntax für diese Methode:
      static QString getUserIdentifier();
      
      
    • Hier finden Sie ein Code-Beispiel für diese Methode:
      QString userId = ADBMobile::getUserIdentifier(); 
      
      
  • setUserIdentifier
    Legt die Benutzerkennung auf identifier fest.
    • Hier finden Sie die Syntax für diese Methode:
      static void setUserIdentifier(QString identifier);
      
      
    • Hier finden Sie ein Code-Beispiel für diese Methode:
      ADBMobile::setUserIdentifier("billybob");
      
      
  • getDebugLogging
    Gibt die aktuelle Vorgabe für die Debug-Protokollierung zurück. Der Standardwert lautet  false .
    • Hier finden Sie die Syntax für diese Methode:
      static bool getDebugLogging();
      
      
    • Hier finden Sie ein Code-Beispiel für diese Methode:
       bool debugging = ADBMobile::getDebugLogging(); 
      
      
  • setDebugLogging
    Legt die Debug-Protokollierungseinstellung auf debugLogging fest.
    • Hier finden Sie die Syntax für diese Methode:
      static void setDebugLogging(bool debugLogging);
      
      
    • Hier finden Sie ein Code-Beispiel für diese Methode:
        ADBMobile::setDebugLogging(true); 
      
      
  • collectLifecycleData
    Gibt dem SDK gegenüber an, dass Lebenszyklusdaten für die Nutzung aller Lösungen im SDK erfasst werden sollen. Weitere Informationen finden Sie unter Lebenszyklusmetriken .
    • Hier finden Sie die Syntax für diese Methode:
      static void collectLifecycleData();
      
      
    • Hier finden Sie ein Code-Beispiel für diese Methode:
      ApplicationUI::ApplicationUI(bb::cascades::Application *app):  QObject(app)  { 
      //... 
      ADBMobile::collectLifecycleData(); 
      }
      
      

Analytics methods

Jede dieser Methoden wird zum Senden von Daten in Ihre Adobe Analytics Report Suite verwendet.
  • trackState
    Verfolgt einen App-Status mit optionalen Kontextdaten. Status sind die in Ihrer App verfügbaren Ansichten wie „Startseiten-Dashboard“, „App-Einstellungen“, „Warenkorb“ usw. Diese Statusangaben sind mit den Seiten in einer Website vergleichbar, und trackState -Aufrufe inkrementieren die Seitenansichten.
    Dies ist der einzige Verfolgungsaufruf, durch den die Seitenansichten inkrementiert werden.
    • Hier finden Sie die Syntax für diese Methode:
      static void trackState(QString state, QHash<QString, QString> contextData = QHash<QString, QString>()); 
      
      
    • Hier finden Sie ein Code-Beispiel für diese Methode:
         ADBMobile::trackState("loginScreen", null);
      
      
  • trackAction
    Verfolgt eine Aktion in der App. Bei Aktionen handelt es sich um die Dinge, die in Ihrer App vor sich gehen, die Sie messen möchten, beispielsweise „Anmeldungen“, „Banner-Tippvorgänge“, „Feed-Abonnements“ und andere Metriken.
    • Hier finden Sie die Syntax für diese Methode:
      static void trackAction(QString action, QHash<QString, QString> contextData = QHash<QString, QString>()); 
      
      
    • Hier finden Sie ein Code-Beispiel für diese Methode:
        ADBMobile::trackAction("heroBannerTouched", null); 
      
      
  • trackLocation
    Sendet die aktuellen XY-Koordinaten. Ersetzen Sie „event“ mit dem Ereignis, das vom BPS-Abonnenten empfangen wurde.
    • Hier finden Sie die Syntax für diese Methode:
      static void trackLocation(bps_event_t *geoEvent, QHash<QString, QString> contextData = QHash<QString, QString> ());
      
      
    • Hier finden Sie ein Code-Beispiel für diese Methode:
        ADBMobile::trackLocation(event, null);
      
      

ADBMobileConfig.json config file reference

The ADBMobileConfig.json file must be placed in the assets folder.
  • rsids
    (Erforderlich) Eine oder mehrere Report Suites zum Empfangen von Analytics-Daten. Verschiedene Report Suite-IDs müssen durch Kommas getrennt und ohne Leerzeichen zwischen den einzelnen Suites angegeben werden.
    Here are the code sample for this variable:
    "rsids" : "rsid"
    
    
    "rsids" : "rsid1,rsid2"
    
    
  • server
    (Erforderlich). Analytics-Server. This variable should be populated with the server domain, without an https:// or https:// protocol prefix. Das Protokollpräfix wird anhand der Variable ssl automatisch von der Bibliothek verarbeitet. Wenn ssl auf true gesetzt ist, wird eine sichere Verbindung zu diesem Server hergestellt. Wenn ssl auf false gesetzt ist, wird eine nicht sichere Verbindung zu diesem Server hergestellt.
  • charset
    Definiert den Zeichensatz, den Sie für die an Analytics gesendeten Daten verwenden. Der Zeichensatz wird verwendet, um eingehende Daten zum Speichern und Reporting in das UTF-8-Format umzuwandeln.
  • ssl
    Enables ( true ) or disables ( false ) sending measurement data via SSL (HTTPS). Der Standardwert lautet  false .
  • offlineEnabled
    When enabled ( true ), hits are queued while the device is offline and sent later when the device is online. Für Ihre Report Suite müssen Zeitstempel aktiviert sein, um die Offline-Verfolgung zu nutzen.
    If timestamps are enabled on your report suite, your offlineEnabled configuration property must be true . Wenn Zeitstempel nicht für Ihre Report Suite aktiviert sind, offlineEnabled muss die Konfigurationseigenschaft ** „false“ lauten. Wenn dies nicht ordnungsgemäß konfiguriert ist, gehen Daten verloren. Wenn Sie sich nicht sicher sind, ob Zeitstempel für Ihre Report Suite aktiviert sind, wenden Sie sich bitte an Enterprise Support. enterprise-support.ec.html
    Wenn Sie aktuell AppMeasurement-Daten in einer Report Suite erfassen, in der auch Daten aus JavaScript gesammelt werden, müssen Sie möglicherweise eine separate Report Suite für mobile Daten einrichten oder einen benutzerdefinierten Zeitstempel für JavaScript-Treffer einfügen, die die Variable s.timestamp nutzen.
    Der Standardwert lautet  false .
  • lifecycleTimeout
    Legt die Dauer in Sekunden fest, die zwischen verschiedenen Startvorgängen einer App verstreichen muss, damit ein Startvorgang als neue Sitzung gilt. Dieses Zeitlimit wird auch angewendet, wenn eine Anwendung in den Hintergrund verschoben und später reaktiviert wird. Die Dauer, für welche die App im Hintergrund ausgeführt wird, wird nicht in die Sitzungsdauer eingerechnet.
    Der Standardwert ist 300 Sekunden.
  • batchLimit
    Maximale Anzahl der in der Warteschlange gespeicherten Treffer. Der Standardwert ist 0 (Keine Begrenzung).
  • privacyDefault
    • optedin - Treffer werden sofort gesendet.
    • optedout - werden Treffer verworfen.
    • optunknown : Wenn für Ihre Report Suite Zeitstempel aktiviert sind, werden Treffer so lange gespeichert, bis der Datenschutzstatus in „opt-in“ (Treffer werden gesendet) oder „opt-out“ (Treffer werden verworfen) geändert wird.
      Wenn für Ihre Report Suite keine Zeitstempel aktiviert sind, werden die Treffer verworfen, bis der Datenschutzstatus zu „optedin“ geändert wird. Diese Variable legt nur den Ausgangswert fest. Wenn dieser Wert im Code festgelegt oder geändert wird, wird der neue Wert verwendet, bis er wieder geändert oder die App entfernt und erneut installiert wird.
    Der Standardwert lautet  optedin .
Im Folgenden finden Sie ein Beispiel für eine ADBMobileConfig.json -Datei:
{ 
    "version" : "1.0", 
    "analytics" : { 
        "rsids" : "coolApp", 
        "server" : "my.CoolApp.com", 
        "charset" : "UTF-8", 
        "ssl" : true, 
        "offlineEnabled" : true, 
        "lifecycleTimeout" : 5, 
        "privacyDefault" : "optedin", 
    } 
}