User ID - iOS SDK

本开发者指南将演示如何使用 iOS 版 Google Analytics(分析)SDK v3.x 来实现 User ID。

概览

User ID 功能可让您在 Google Analytics(分析)中衡量跨多种设备的用户活动,例如将某台移动设备上发生的某次转化归因于先前在另一台移动设备上或在浏览器中与某个营销活动的某次互动。

如果您使用 userId 字段随 Google Analytics(分析)匹配一起发送 User ID,则不但您的报告中的唯一身份用户数将更加准确,而且您还可以获得新的跨设备报告选项。 详细了解使用 User ID 的好处。

本指南介绍了如何使用 userId 字段和适用于 iOS 的 Google Analytics(分析)SDK 将 user ID 发送到 Google Analytics(分析)。

前提条件

在将 User ID 发送到 Google Analytics(分析)之前:

实现

当您的 iOS 应用能够识别某位用户的身份时,您应当随您的所有 Google Analytics(分析)匹配(例如网页浏览、事件、电子商务交易等)一起,使用 userId 字段发送代表该用户的 ID。

要发送 User ID,请使用 Measurement Protocol“&”符号语法kGAIUserId 参数名称来设置 userId 字段,如下例所示:

/**
 * 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
}

本例显示了如何获得 User ID:

NSString *userId = [tracker get:kGAIUserId];