Dispatching – iOS SDK

In diesem Dokument wird beschrieben, wie Sie die Weiterleitung von Daten an Google Analytics mithilfe des Google Analytics SDK für iOS Version 2 verwalten.

Überblick

Im Google Analytics SDK für iOS 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 von Ihnen festgelegten wiederkehrenden Intervallen.
  • 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.

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 2 Minuten. Sie können Ihr eigenes Intervall in Sekunden angeben. Dazu rufen Sie setDispatchPeriod:(NSTimeInterval) wie in diesem Beispiel auf:

[[GAI sharedInstance] 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 gesendet werden, indem dispatch wie unten dargestellt aufgerufen wird:

[[GAI sharedTracker] dispatch];