In diesem Dokument wird beschrieben, wie Sie die Weiterleitung von Daten an Google Analytics mithilfe des Google Analytics SDK for Android Version 2 verwalten.
Überblick
Im Google Analytics SDK for Android werden erfasste Daten wie Bildschirmaufrufe oder Ereignisse lokal in einer Warteschlange gespeichert, bevor sie an die Google Analytics-Server gesendet werden. Der Prozess, bei dem diese Daten (hier als „Treffer“ bezeichnet) vom SDK an Google Analytics gesendet werden, wird als „Senden“ bezeichnet.
Das Dispatching ist einzigartig für die mobilen Sammlungsbibliotheken und dient dazu, die Herausforderungen eines unzuverlässigen Netzwerkzugriffs und einer begrenzten Akkulaufzeit zu minimieren.
Es gibt zwei Arten der Weiterleitung:
- Regelmäßige Weiterleitung: Sendet automatisch Treffer in wiederkehrenden Intervallen, die Sie entweder programmatisch oder in der Datei
analytics.xmlangeben. - Manuelle Weiterleitung – Sie senden Treffer manuell, um Daten zu senden, wenn dies für Sie praktisch ist, z. B. wenn eine bestehende HTTP-Verbindung vorhanden ist.
Beide Arten der Weiterleitung erfolgen über den Haupt-UI-Thread in Version 2 des SDK.
Im weiteren Verlauf dieses Dokuments erhalten Sie ausführlichere Informationen zu den einzelnen Weiterleitungstypen und deren Implementierung in Ihrer Anwendung.
Regelmäßige Sendungen
Während Ihre App GA-Daten erfasst, werden diese Daten einer Warteschlange hinzugefügt und regelmäßig an Google Analytics weitergeleitet. Die Weiterleitung kann in regelmäßigen Abständen erfolgen, wenn die App im Vordergrund oder im Hintergrund ausgeführt wird.
Der standardmäßige Weiterleitungszeitraum beträgt 30 Minuten.
Sie können Ihr eigenes Intervall in Sekunden angeben. Verwenden Sie dazu den Parameter ga_dispatchPeriod in Ihrer analytics.xml-Datei oder rufen Sie setDispatchPeriod(int dispatchPeriodInSeconds) wie in diesem Beispiel auf:
In der Datei analytics.xml:
<integer name="ga_dispatchPeriod">60</integer>
Programmatisch:
GAServiceManager.getInstance().setDispatchPeriod(60);
Wenn Sie einen negativen Wert festlegen, wird die regelmäßige Weiterleitung deaktiviert. Wenn Sie Daten an Google Analytics senden möchten, müssen Sie die manuelle Weiterleitung verwenden. Wenn Sie dagegen den Wert 0 festlegen, wird jeder Treffer sofort gesendet, wenn eine Netzwerkverbindung verfügbar ist.
Sobald alle Treffer gesendet wurden, wechselt die regelmäßige Weiterleitung in den Energiesparmodus und wird deaktiviert, bis ein weiterer Sendeaufruf erfolgt.
Wenn ein Nutzer den Netzwerkzugriff verliert oder Ihre Anwendung schließt, während noch Treffer gesendet werden müssen, werden diese Treffer im lokalen Speicher beibehalten. Sie werden abgefertigt, wenn Ihre Anwendung das nächste Mal ausgeführt und die Weiterleitung aufgerufen wird.
Manueller Versand
Neben dem regelmäßigen Versand kann es auch Situationen geben, in denen Sie Treffer manuell senden möchten. Sie könnten beispielsweise Ihre Weiterleitungen mit anderen HTTP-Anfragen Ihrer Anwendung bündeln, um den Aufwand zu reduzieren.
Treffer können manuell über die Instanz GAServiceManager ausgelöst werden:
GAServiceManager.getInstance().dispatch();