Benutzerdefinierte Dimensionen und Messwerte – Android SDK Version 2 (alte Version)

In diesem Entwicklerleitfaden wird beschrieben, wie Sie mit dem Google Analytics SDK for Android Version 2 benutzerdefinierte Dimensionen und Messwerte implementieren.

Überblick

Wenn Sie mit dem Google Analytics SDK for Android einen benutzerdefinierten Dimensions- oder Messwert festlegen, wird dieser mit dem nächsten Treffer als Parameter gesendet. Diese Werte lassen sich auf jeden Google Analytics-Treffertyp anwenden, einschließlich Bildschirmaufrufen, Ereignissen, E-Commerce-Transaktionen, Nutzertimings und Interaktionen in sozialen Netzwerken.

Zum Implementieren einer benutzerdefinierten Dimension oder eines benutzerdefinierten Messwerts sind zwei wichtige Schritte erforderlich:

  1. Legen Sie die benutzerdefinierte Dimension bzw. den benutzerdefinierten Messwert über die Google Analytics-Weboberfläche fest.
    Legen Sie den Index, den Namen und den Umfang der benutzerdefinierten Dimension oder des benutzerdefinierten Messwerts im Bereich für die Property-Einstellungen der Weboberfläche fest.
    Informationen zum Definieren von benutzerdefinierten Dimensionen und Messwerten
  2. Implementieren Sie Code, um Werte für benutzerdefinierte Dimensionen und Messwerte festzulegen und zu erfassen.
    Fügen Sie Ihrer App Code hinzu, um benutzerdefinierte Dimensionen oder Messwerte für Ihre Google Analytics-Treffer an den Indizes festzulegen, die Sie im vorherigen Schritt definiert haben.

Im weiteren Verlauf dieses Artikels wird beschrieben, wie Sie den Code implementieren, um benutzerdefinierte Dimensionen oder Messwerte festzulegen und an Google Analytics zu senden.

Benutzerdefinierte Dimensionen

Werte für benutzerdefinierte Dimensionen können für alle Google Analytics-Treffertypen festgelegt werden. Legen Sie kurz vor dem Sendeaufruf, auf den der Wert angewendet werden soll, einen benutzerdefinierten Dimensionswert fest.

Der definierte Umfang der benutzerdefinierten Dimension bestimmt bei der Verarbeitung, welche zusätzlichen Treffer dem Wert zugeordnet werden können.

Diese Felder sind erforderlich, um einen benutzerdefinierten Dimensionswert festzulegen:

  • Integer Index: Der Index der Definition einer benutzerdefinierten Dimension. Dieser Index ist 1-basiert.
  • String Wert: Der Wert der benutzerdefinierten Dimension.

Festlegen eines benutzerdefinierten Dimensionswerts

Wenn Sie einen benutzerdefinierten Dimensionswert festlegen möchten, rufen Sie setCustomDimension vor dem Sendeaufruf auf, mit dem Sie den Wert verknüpfen möchten:

// Get the tracker object.
Tracker tracker = EasyTracker.getTracker();

// Set the dimension value for index 1.
tracker.setCustomDimension(1, "myValue");

// Dimension value is associated and sent with this hit.
tracker.sendView();

Hinweise zur Implementierung

In diesem Abschnitt werden zusätzliche Überlegungen beschrieben, die beim Implementieren einer benutzerdefinierten Dimension zu beachten sind.

Nutzer- und Sitzungsebene sind gierig

Werte benutzerdefinierter Dimensionen mit Umfang auf Nutzer- oder Sitzungsebene werden auf alle Treffer der aktuellen Sitzung angewendet, einschließlich früherer Treffer. Wenn Sie nicht möchten, dass ein Wert einer benutzerdefinierten Dimension mit Umfang auf Sitzungs- oder Nutzerebene auf frühere Treffer in der aktuellen Sitzung angewendet wird, starten Sie eine neue Sitzung, bevor Sie den Wert auf einen Treffer anwenden.

Wenn Sie beispielsweise den Mitgliedschaftstyp als benutzerdefinierte Dimension auf Nutzerebene verwenden und ein Nutzer seine Mitgliedschaft mitten in einer Sitzung aktualisiert, sollten Sie eine neue Sitzung starten, bevor Sie den neuen Wert für die benutzerdefinierte Dimension festlegen. So wird sichergestellt, dass die Treffer vor dem Upgrade dem alten Mitgliedschaftswert zugeordnet werden, während neue Treffer dem neuen Wert zugeordnet werden.

Benutzerdefinierte Dimensionen und Filter für Datenansichten (Profil)

Werte von benutzerdefinierten Dimensionen auf Nutzer- oder Sitzungsebene werden weiterhin auf alle Treffer in der aktuellen und/oder künftigen Sitzungen angewendet, auch wenn der Treffer, mit dem sie gesendet werden, aus einer Datenansicht (Profil) herausgefiltert wird.

Beim Filtern nach einem benutzerdefinierten Dimensionswert werden Treffer entsprechend dem Umfang dieses Werts für die benutzerdefinierte Dimension gefiltert.

Weitere Informationen dazu, wie Filter und Werte benutzerdefinierter Dimensionen bei der Verarbeitung Ihrer Daten interagieren

Werte mit automatischer Bildschirmmessung festlegen

Wenn Sie einen benutzerdefinierten Dimensionswert auf einen Bildschirmaufruf anwenden möchten, der über die automatische Bildschirmmessung von EasyTracker gesendet wurde, legen Sie den Wert fest, bevor activityStart() während des onStart() aufgerufen wird.

Falls der Wert zum Zeitpunkt der Ausführung von onStart() nicht bekannt ist, empfiehlt es sich, stattdessen eine manuelle Bildschirmmessung zu verwenden.

Keine personenidentifizierbaren Informationen als Werte senden

Gemäß den Nutzungsbedingungen von Google Analytics dürfen keine personenidentifizierbaren Informationen an Google Analytics-Server gesendet werden. Weitere Informationen finden Sie in den Nutzungsbedingungen.

Benutzerdefinierte Messwerte

Benutzerdefinierte Dimensionen müssen zwar sorgfältig auf bestimmte Treffer angewendet und anhand des Umfangs verwaltet werden, aber der Treffer, auf den ein benutzerdefinierter Messwert angewendet wird, wirkt sich in der Regel nicht auf die Berichterstellung aus. Sie können daher festgelegt werden, wann immer der Messwert bekannt ist.

Diese Felder sind erforderlich, um einen benutzerdefinierten Messwert festzulegen:

  • Integer Index: Der Index der benutzerdefinierten Messwertdefinition.
  • Integer Wert: Der Wert des benutzerdefinierten Messwerts. Die Werte können negativ sein.

Wert für benutzerdefinierten Messwert festlegen

Wenn Sie einen benutzerdefinierten Messwert festlegen möchten, rufen Sie setCustomMetric vor einem weiteren Sendeaufruf auf:

// Get the tracker object.
Tracker tracker = EasyTracker.getTracker();

// Increment the metric at index 1.
tracker.setCustomMetric(1, 1);

// Metric value sent with this hit.
tracker.sendView();

Sie können auch einen benutzerdefinierten Währungsmesswert festlegen:

// Get the tracker.
Tracker tracker = EasyTracker.getTracker();

// Create a map for hit params.
HashMap params = new HashMap();
params.put(ModelFields.APP_SCREEN, "Product Page");

// Set currency value to custom metric slot 1.
// Currency values may be fixed decimal.
params.put("&cm1", "24.99");

// Send the custom metric value with a screen view.
tracker.send("appview", params);

Hinweise zur Implementierung

Im folgenden Abschnitt werden zusätzliche Überlegungen beschrieben, die Sie bei der Planung einer Implementierung benutzerdefinierter Dimensionen oder Messwerte berücksichtigen sollten.

Benutzerdefinierte Messwerte werden in Berichten zusammengefasst

Benutzerdefinierte Messwerte werden in Berichten wie vordefinierte Messwerte in Google Analytics zusammengefasst. Daher würden Sie den benutzerdefinierten Messwert 1 festlegen, um die zusammengefasste Gesamtsumme des Messwerts in Ihren Berichten zu erhöhen.

Benutzerdefinierte Messwerte und Filter für Datenansichten (Profil)

Auch wenn es in der Regel möglich ist, benutzerdefinierte Messwerte zu verwenden, sollten Sie keine benutzerdefinierten Messwerte für Treffer festlegen, die wahrscheinlich aus Ihren Datenansichten (Profilen) herausgefiltert werden. Wird ein Treffer durch einen Datenansichts- bzw. Profilfilter gefiltert, werden auch alle zugehörigen benutzerdefinierten Messwerte herausgefiltert. Weitere Informationen zu benutzerdefinierten Dimensionen und Messwerten sowie zu Datenansichtsfiltern (Profilen)