User ID - iOS SDK

このデベロッパーガイドでは、iOS 向け Google アナリティクス SDK v3.x を使って User ID を実装する方法を説明します。

概要

User ID 機能を使用して、デバイスをまたいで発生するユーザーアクティビティを Google アナリティクスで測定することができます。たとえば、あるモバイルデバイスで実施しているマーケティングキャンペーンで発生した操作を、別のモバイルデバイスやブラウザで発生したコンバージョンに結び付けて貢献度を割り当てる（アトリビューション）ことが可能です。

Google アナリティクスのヒットに userId フィールドを使って User ID を送出すると、レポートにユニークユーザー数がより正確に反映され、新しいクロスデバイスレポートオプションを利用できるようになります。User ID を使用するメリットの詳細をご確認ください。

このガイドでは、userId フィールドと iOS 向け Google アナリティクス SDK を使ってユーザー ID を Google アナリティクスに送信する方法を説明します。

前提条件

Google アナリティクスに User ID を送る前に、次の準備が必要です、

実装

iOS アプリで既知のユーザーについては、userId フィールドを使って、そのユーザーを表す Google アナリティクスのすべてのヒット（ページビュー、イベント、e コマーストランザクションなど）で、そのユーザーを表す 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];