Diese Information unterstützt Sie beim Implementieren der Android-Bibliothek und Erfassen von Lebenszyklusmetriken, wie z. B. Starts, Upgrades, Sitzungen, erreichte Benutzer usw.
Um das SDK herunterzuladen, müssen Sie Android 2.2 oder höher verwenden.
Führen Sie die Schritte in den folgenden Abschnitten aus, um eine Entwicklungs-Report Suite einzurichten und eine vorausgefüllte Version der Konfigurationsdatei herunterzuladen:
Laden Sie die Datei [Your_App_Name_]AdobeMobileLibrary-4.*-Android.zip
herunter und dekomprimieren Sie sie. Stellen Sie sicher, dass die folgenden Softwarekomponenten vorhanden sind:
adobeMobileLibrary.jar
: die Bibliothek, die mit Android-Geräten und Simulatoren verwendet wird.
ADBMobileConfig.json
: die SDK-Konfigurationsdatei, die für Ihre App angepasst ist.
Wenn Sie das SDK außerhalb der Adobe Mobile Services-Benutzeroberfläche herunterladen, muss die Datei ADBMobileConfig.json
manuell konfiguriert werden. Wenn Sie mit Analytics und dem Mobile SDK noch nicht vertraut sind und eine Entwicklungsberichtssuite einrichten und eine vorinstallierte Version der Konfigurationsdatei herunterladen möchten, lesen Sie Vorbereitung.
IntelliJ IDEA-Projekt
So fügen Sie das SDK und die Konfigurationsdatei zu Ihrem Projekt hinzu:
Fügen Sie die Datei ADBMobileConfig.json
in den Ordner assets
Ihres Projekts ein.
Klicken Sie im Bereich „Project Navigation“ (Projektnavigation) mit der rechten Maustaste auf das Projekt.
Wählen Sie Moduleinstellungen öffnen.
Wählen Sie unter Projekteinstellungen die Option Bibliotheken.
Klicken Sie auf das Symbol +, um eine neue Bibliothek hinzuzufügen.
Wählen Sie Java und navigieren Sie zur Datei adobeMobileLibrary.jar
.
Wählen Sie die Module aus, in denen Sie die Mobilbibliothek verwenden möchten.
Klicken Sie auf Anwenden und anschließend auf OK, um das Fenster „Moduleinstellungen“ zu schließen.
Eclipse-Projekt
So fügen Sie das SDK und die Konfigurationsdatei zu Ihrem Projekt hinzu:
ADBMobileConfig.json
in den Ordner assets
Ihres Projekts ein.adobeMobileLibrary.jar
aus.adobeMobileLibrary.jar
ausgewählt ist.Die AppMeasurement-Bibliothek erfordert folgende Berechtigungen, um Daten zu senden und Offline-Verfolgungsaufrufe aufzuzeichnen:
INTERNET
ACCESS_NETWORK_STATE
Ergänzen Sie die Datei AndroidManifest.xml
im Projektverzeichnis der Anwendung um die folgenden Zeilen, um diese Berechtigungen hinzuzufügen:
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
Der folgende Code sollte der onCreate
-Methode Ihrer Hauptaktivität hinzugefügt werden:
@Override
public void onCreate(BundlesavedInstanceState){
super.onCreate(savedInstanceState)
setContentView(R.layout.main);
Config.setContext(this.getApplicationContext());
}
Nachdem Sie den Lebenszyklus aktiviert haben, wird bei jedem Start Ihrer App ein Treffer gesendet, um Starts, Upgrades, Sitzungen, erreichte Benutzer und viele andere Metriken zu messen. Weitere Informationen finden Sie unter Lebenszyklusmetriken.
Führen Sie die folgenden Schritte in jeder Aktivität Ihrer Anwendung aus:
Importieren Sie die Bibliothek:
import com.adobe.mobile.*;
Starten Sie in der Funktion onResume
die Erfassung der Lebenszyklusdaten:
@Override
public void onResume() {
Config.collectLifecycleData(this);
// -or- Config.collectLifecycleData(this, contextData);
}
Halten Sie in der Funktion onPause
die Erfassung der Lebenszyklusdaten an:
@Override
public void onPause() {
Config.pauseCollectingLifecycleData();
}
Sie müssen diese Aufrufe zu jeder Aktivität hinzufügen, um präzise Absturzberichte zu gewährleisten. Weitere Informationen finden Sie unter App-Abstürze verfolgen.
Um beim Lebenszyklusmetrik-Aufrufen zusätzliche Daten hinzuzufügen, übergeben Sie einen zusätzlichen Parameter mit Kontextdaten an collectLifecycleData
:
@Override
public void onResume() {
HashMap<String, Object> contextData = new HashMap<String, Object>();
contextData.put("myapp.category", "Game");
Config.collectLifecycleData(this, contextData);
}
Zusätzliche Kontextdatenwerte, die mit collectLifecycleData
gesendet werden, müssen benutzerdefinierten Variablen in Adobe Mobile Services zugeordnet sein:
Andere Lebenszyklusmetriken werden automatisch erfasst. Weitere Informationen finden Sie unter Lebenszyklusmetriken.
Führen Sie die folgenden Aufgaben aus: