User-ID – iOS SDK

In diesem Entwicklerleitfaden erfahren Sie, wie Sie die User-ID mit dem Google Analytics SDK for iOS v3.x implementieren.

Überblick

Mit der User-ID-Funktion können Nutzeraktivitäten geräteübergreifend in Google Analytics erfasst werden. Beispielsweise kann eine Interaktion mit einer Marketingkampagne auf einem Mobilgerät einer Conversion zugeordnet werden, die auf einem anderen Mobilgerät oder im Browser erfolgt.

Wenn User-IDs mit Google Analytics-Treffern über das Feld userId gesendet werden, enthalten Ihre Berichte eine genauere Anzahl der einzelnen Nutzer und bieten neue geräteübergreifende Berichtsoptionen. Weitere Informationen zu den Vorteilen der User-ID

In diesem Leitfaden erfahren Sie, wie Sie mit dem Feld userId und dem Google Analytics SDK für iOS User-IDs an Google Analytics senden.

Voraussetzungen

Bevor Sie die User-ID an Google Analytics senden:

Implementierung

Wenn ein Nutzer Ihre iOS-App kennt, sollten Sie mit dem Feld userId eine ID für diesen Nutzer mit allen Google Analytics-Treffern, z. B. Seitenaufrufen, Ereignissen oder E-Commerce-Transaktionen, senden.

Wenn Sie die User-ID senden möchten, müssen Sie das Feld userId mit der kaufmännischen Und-Zeichen des Measurement Protocol sowie den Namen des Parameters kGAIUserId festlegen, wie im folgenden Beispiel gezeigt:

/**
 * An example method called when a user signs in to an authentication system.
 *
 * @param user represents a generic User object returned by an authentication system on sign in.
 */
- void signInWithUser:(User *)user {

  id<GAITracker> tracker = [[GAI sharedInstance] defaultTracker];

  // You only need to set User ID on a tracker once. By setting it on the tracker, the ID will be
  // sent with all subsequent hits.
  [tracker set:kGAIUserId
         value:user.id];

  // This hit will be sent with the User ID value and be visible in User-ID-enabled views (profiles).
  [tracker send:[[GAIDictionaryBuilder createEventWithCategory:@"UX"            // Event category (required)
                                                        action:@"User Sign In"  // Event action (required)
                                                         label:nil              // Event label
                                                         value:nil] build]];    // Event value
}

In diesem Beispiel wird gezeigt, wie Sie die User-ID abrufen:

NSString *userId = [tracker get:kGAIUserId];