In diesem Entwicklerleitfaden wird beschrieben, wie Sie mit dem Google Analytics SDK Version 4 für Android benutzerdefinierte Dimensionen und Messwerte implementieren.
Übersicht
Sie können:
- Verwenden Sie die Google Analytics-Weboberfläche, um die benutzerdefinierte Dimension oder den benutzerdefinierten Messwert zu konfigurieren. Weitere Informationen zum Konfigurieren einer benutzerdefinierten Dimension oder eines benutzerdefinierten Messwerts
- Werte benutzerdefinierter Dimensionen und Messwerte über eine App festlegen und senden.
Benutzerdefinierte Dimensionen und Messwerte bestehen aus zwei Feldern:
Feldname | Typ | Beschreibung |
---|---|---|
Index | Integer |
Index der benutzerdefinierten Dimension oder des benutzerdefinierten Messwerts. Dieser Index basiert auf 1. |
Wert | String |
Der Wert der benutzerdefinierten Dimension oder des benutzerdefinierten Messwerts. Bei Messwerten werden diese als Ganzzahl oder als Festkommazahl geparst, wenn der Messwert für eine Währung konfiguriert ist. |
Werte festlegen und senden
So legen Sie einen Wert für eine benutzerdefinierte Dimension fest und senden ihn:
// Get tracker. Tracker t = ((AnalyticsSampleApp) getActivity().getApplication()).getTracker( TrackerName.APP_TRACKER); t.setScreenName("Home Screen"); // Send the custom dimension value with a screen view. // Note that the value only needs to be sent once. t.send(new HitBuilders.ScreenViewBuilder() .setCustomDimension(1, "premiumUser") .build() );
Werte für benutzerdefinierte Dimensionen können mit jedem Google Analytics-Treffertyp gesendet werden. Dazu zählen Bildschirmaufrufe, Ereignisse, E-Commerce-Transaktionen, Nutzertimings und soziale Interaktionen. Der definierte Umfang der benutzerdefinierten Dimension bestimmt zum Zeitpunkt der Verarbeitung, welche Treffer mit dem Dimensionswert verknüpft sind.
So legen Sie einen benutzerdefinierten Messwert fest und senden ihn:
// Get tracker. Tracker t = ((AnalyticsSampleApp) getActivity().getApplication()).getTracker( TrackerName.APP_TRACKER); t.setScreenName("Home Screen"); // Send the custom dimension value with a screen view. // Note that the value only needs to be sent once. t.send(new HitBuilders.ScreenViewBuilder() .setCustomMetric(1, 5) .build() );
Weitere Informationen zur Methode getTracker
finden Sie unter Erweiterte Konfiguration.
Hinweise zur Implementierung
In diesem Abschnitt werden weitere Überlegungen zum Implementieren benutzerdefinierter Dimensionen oder Messwerte beschrieben.
Hinweise zu benutzerdefinierten Dimensionen
Werte mit Umfang auf Nutzer- und Sitzungsebene werden auf vergangene Treffer angewendet
- Werte der benutzerdefinierten Dimension mit dem Umfang auf Nutzer- oder Sitzungsebene werden auf alle Treffer der aktuellen Sitzung angewendet, einschließlich der bisherigen Treffer. Wenn der Wert einer benutzerdefinierten Dimension mit Umfang auf Sitzungs- oder Nutzerebene nicht auf bisherige Treffer in der aktuellen Sitzung angewendet werden soll, müssen Sie eine neue Sitzung starten, 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 der benutzerdefinierten Dimension festlegen. Dadurch wird sichergestellt, dass die Treffer vor dem Upgrade mit dem alten Mitgliedschaftswert verknüpft werden, während neue Treffer dem neuen Wert zugeordnet werden.
Benutzerdefinierte Dimensionen und Filter für Datenansichten
- Die Werte der benutzerdefinierten Dimension auf Nutzer- oder Sitzungsebene werden auch dann auf alle Treffer in der aktuellen und/oder zukünftigen Sitzung angewendet, wenn der Treffer, aus dem sie gesendet werden, aus einer Datenansicht (Profil) gefiltert ist.
- Beim Filtern nach einem Wert einer benutzerdefinierten Dimension werden Treffer nach dem Umfang dieses Werts gefiltert. Weitere Informationen zur Interaktion von Filtern und Werten benutzerdefinierter Dimensionen bei der Verarbeitung von Daten
Hinweise zu benutzerdefinierten Messwerten
Werte für benutzerdefinierte Messwerte werden in Berichten zusammengefasst
- Werte von benutzerdefinierten Messwerten werden in Berichten wie andere vordefinierte Messwerte in Google Analytics zusammengefasst. Infolgedessen würden Sie einen benutzerdefinierten Messwert von
1
festlegen, um die Gesamtsumme des Messwerts in Ihren Berichten zu erhöhen.
Benutzerdefinierte Messwerte und Datenansichtsfilter
- Die Werte für benutzerdefinierte Messwerte können normalerweise festgelegt werden, wann immer dies sinnvoll ist. Vermeiden Sie es jedoch, benutzerdefinierte Messwerte für Treffer festzulegen, die wahrscheinlich aus Ihren Datenansichten (Profilen) herausgefiltert werden. Wenn ein Treffer nach einem Datenansichts- oder Profilfilter gefiltert wird, werden auch alle zugehörigen benutzerdefinierten Messwerte gefiltert. Weitere Informationen zu benutzerdefinierten Dimensionen und Messwerten sowie Datenansichtsfiltern (Profil)
Werte mit automatischer Bildschirmmessung festlegen
- Wenn du einen benutzerdefinierten Dimensionswert auf einen Bildschirmaufruf anwenden möchtest, der über die automatische Bildschirmmessung gesendet wird, lege den Wert fest, bevor
activityStart()
währendonStart()
aufgerufen wird. Falls der Wert zum Zeitpunkt der Ausführung vononStart()
nicht bekannt ist, wird stattdessen die manuelle Bildschirmmessung empfohlen.
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.