In diesem Entwicklerleitfaden wird beschrieben, wie Sie mit dem Google Analytics SDK Version 4 für Android benutzerdefinierte Dimensionen und Messwerte implementieren.
Überblick
Du kannst Folgendes tun:
- Verwenden Sie die Google Analytics-Weboberfläche, um die benutzerdefinierte Dimension oder den benutzerdefinierten Messwert zu konfigurieren. Informationen zum Konfigurieren benutzerdefinierter Dimensionen und Messwerte (Google Ads-Hilfe)
- Benutzerdefinierte 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 ist 1-basiert. |
Wert | String |
Wert der benutzerdefinierten Dimension oder des benutzerdefinierten Messwerts. In diesem Fall werden Messwerte als Ganzzahl oder als Festkommakommawert geparst, wenn der Messwert für einen Währungstyp konfiguriert ist. |
Werte festlegen und senden
So legen Sie einen benutzerdefinierten Dimensionswert 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() );
Benutzerdefinierte Dimensionswerte können mit jedem Google Analytics-Treffertyp gesendet werden, einschließlich Bildschirmaufrufen, Ereignissen, E-Commerce-Transaktionen, Nutzertimings und Interaktionen in sozialen Netzwerken. Der für die benutzerdefinierte Dimension definierte Umfang bestimmt bei der Verarbeitung, welche Treffer dem Dimensionswert zugeordnet werden.
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 zusätzliche Überlegungen beschrieben, die Sie beim Implementieren von benutzerdefinierten Dimensionen oder Messwerten beachten sollten.
Hinweise zu benutzerdefinierten Dimensionen
Werte mit Umfang auf Nutzer- und Sitzungsebene werden auf frühere Treffer angewendet
- 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 der benutzerdefinierten Dimension festlegen. So wird sichergestellt, dass die Treffer vor dem Upgrade dem alten Mitgliedschaftswert und 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 gemäß dem Umfang dieses benutzerdefinierten Dimensionswerts gefiltert. Weitere Informationen dazu, wie Filter und Werte benutzerdefinierter Dimensionen bei der Verarbeitung Ihrer Daten interagieren
Hinweise zu benutzerdefinierten Messwerten
Benutzerdefinierte Messwerte werden in Berichten zusammengefasst
- Benutzerdefinierte Messwerte werden in Berichten wie andere vordefinierte Messwerte in Google Analytics zusammengefasst. Daher würden Sie den Wert
1
für den benutzerdefinierten Messwert 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)
Werte mit automatischer Bildschirmmessung festlegen
- Wenn Sie einen benutzerdefinierten Dimensionswert auf einen Bildschirmaufruf anwenden möchten, der über eine automatische Bildschirmmessung gesendet wurde, legen Sie den Wert fest, bevor
activityStart()
währendonStart()
aufgerufen wird. Falls der Wert bei der Ausführung vononStart()
nicht bekannt ist, wird stattdessen eine 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.