Benutzerdefinierte Dimensionen und Messwerte – iOS SDK

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

Überblick

Benutzerdefinierte Dimensionen ermöglichen die Verknüpfung von Metadaten mit Treffern, Nutzern und Sitzungen in Google Analytics. Mit benutzerdefinierten Messwerten können Sie hingegen eigene Messwerte in Google Analytics erstellen und erhöhen.

  1. Konfigurieren Sie die benutzerdefinierte Dimension oder den benutzerdefinierten Messwert über die Google Analytics-Weboberfläche. Informationen zum Konfigurieren benutzerdefinierter Dimensionen und Messwerte (Google Ads-Hilfe)
  2. Benutzerdefinierte Dimensionen und Messwerte über eine App festlegen und senden

Benutzerdefinierte Dimensionen und Messwerte bestehen aus zwei Feldern:

  • NSNumber Index: Der Index der benutzerdefinierten Dimension oder des benutzerdefinierten Messwerts. Dieser Index ist 1-basiert.
  • NSString Wert: Der 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:

// May return nil if a tracker has not yet been initialized with a property ID.
id tracker = [[GAI sharedInstance] defaultTracker];

// Set the custom dimension value on the tracker using its index.
[tracker set:[GAIFields customDimensionForIndex:1]
       value:@"Premium user"];

[tracker set:kGAIScreenName
       value:@"Home screen"];

// Send the custom dimension value with a screen view.
// Note that the value only needs to be sent once, so it is set on the Map,
// not the tracker.

// Previous V3 SDK versions.
// [tracker send:[[[GAIDictionaryBuilder createAppView] set:@"premium"
//                                                   forKey:[GAIFields customDimensionForIndex:1]] build]];

// // SDK Version 3.08 and up.
[tracker send:[[[GAIDictionaryBuilder createScreenView] set:@"premium"
                                                     forKey:[GAIFields customDimensionForIndex:1]] 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:

// May return nil if a tracker has not yet been initialized with a property ID.
id tracker = [[GAI sharedInstance] defaultTracker];


// Set the custom metric to be incremented by 5 using its index.
[tracker set:[GAIFields customMetricForIndex:1]
       value:[[NSNumber numberWithInt:5] stringValue]];


[tracker set:kGAIScreenName
       value:@"Home screen"];

// Custom metric value is sent with this screen view.
// [tracker send:[[GAIDictionaryBuilder createAppView] build]];     // Previous V3 SDK versions.
[tracker send:[[GAIDictionaryBuilder createScreenView] build]];     // SDK Version 3.08 and up.

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)

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)

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 während der viewDidAppear:-Methode des Ansichts-Controllers fest. Die Datei .m Ihres Ansichts-Controllers könnte dann so aussehen:
#import "myViewController.h"
#import "GAI.h"

@implementation myViewController

-(void)viewDidAppear
{
    id<GAITracker> tracker = [[GAI sharedInstance] defaultTracker];  // Get the tracker object.
    [tracker set:[GAIFields customDimensionForIndex:1]
           value:@"premium"];
    [super viewDidAppear:animated];   // Custom dimension value will be sent with the screen view.

}

// The remainder of the implementation is omitted.

Keine personenidentifizierbaren Informationen als Werte senden