Benutzerdefinierte Dimensionen und Messwerte – iOS SDK

Wichtig: In diesem Dokument wird eine alte SDK-Version beschrieben. Neue Nutzer sollten das neueste SDK verwenden.

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

Überblick

Bevor Sie die Funktion implementieren, sollten Sie die Funktion für benutzerdefinierte Dimensionen und Messwerte lesen, um ihre Funktionsweise genau zu erklären.

Wenn Sie mit dem Google Analytics SDK für iOS eine benutzerdefinierte Dimension oder einen benutzerdefinierten Messwert festlegen, wird dieser Wert 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:

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

Festlegen eines benutzerdefinierten Dimensionswerts

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

// Get the tracker object.
id tracker = [[GAI sharedInstance].defaultTracker;

// Set the dimension value for index 1.
[tracker setCustom:1
         dimension:@"myValue"];

// Dimension value is associated and sent with this hit.
[tracker sendView:screenName];

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 eine automatische Bildschirmmessung gesendet wurde, müssen Sie den Wert in der Methode viewDidAppear: des Ansichts-Controllers festlegen. Die Datei .m Ihres Ansichts-Controllers könnte dann so aussehen:

#import "myViewController.h"
#import "GAI.h"

@implementation myViewController

-(void)viewDidAppear
{
    id tracker = [[GAI sharedInstance].defaultTracker;  // Get the tracker object.
    [tracker setCustom:1
             dimension:@"myValue"];  // Set the custom dimension value.
    [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

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:

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

Hinweis : Für benutzerdefinierte Messwerte, die als Währungstyp konfiguriert sind, können Sie einen festen Dezimalwert anstelle einer Ganzzahl verwenden.

Wert für benutzerdefinierten Messwert festlegen

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

// Get the tracker object.
id tracker = [GAI sharedInstance].defaultTracker;

// Increment the metric at index 1.
[tracker setCustom:1
            metric:[NSNumber numberWithLongLong:1]];

// Metric value sent with this hit.
[tracker sendView:screenName];

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

// Get the tracker.
id tracker = [GAI sharedInstance].defaultTracker;

// Create a dictionary for hit params.
NSDictionary *params = [[NSDictionary alloc] initWithObjectsAndKeys:
    @"Product Page", @"&cd",
   // Set currency value to custom metric slot 1.
   // Currency values may be fixed decimal.
    @"24.99", @"&cm1", nil];

// Send the custom metric value with a screen view.
[tracker send:@"appview"
       params: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)