شناسه کاربر - iOS SDK

این راهنمای برنامه‌نویس نحوه پیاده‌سازی User ID با استفاده از Google Analytics SDK برای iOS v3.x را نشان می‌دهد.

بررسی اجمالی

ویژگی User ID اندازه‌گیری فعالیت‌های کاربر را در دستگاه‌های Google Analytics اندازه‌گیری می‌کند، مانند نسبت دادن یک تعامل با یک کمپین بازاریابی در یک دستگاه تلفن همراه به تبدیلی که در دستگاه تلفن همراه دیگر یا در مرورگر رخ می‌دهد.

وقتی شناسه‌های کاربری با بازدیدهای Google Analytics با استفاده از فیلد userId ارسال می‌شوند، گزارش‌های شما تعداد دقیق‌تری از کاربران منحصربه‌فرد را منعکس می‌کند و گزینه‌های جدید گزارش‌دهی بین دستگاهی را ارائه می‌دهد. درباره مزایای استفاده از User ID بیشتر بدانید.

این راهنما نحوه استفاده از فیلد userId و Google Analytics SDK برای iOS را برای ارسال شناسه های کاربر به Google Analytics نشان می دهد.

پیش نیازها

قبل از ارسال شناسه کاربری به Google Analytics:

• شناسه کاربری را تنظیم کنید .
• سیاست شناسه کاربری را مرور کنید.
• با بررسی مرجع ویژگی User ID، نحوه کارکرد User ID را بیاموزید.

مهم : این شما هستید که باید شناسه های خود را به Google Analytics ارائه و ارسال کنید، که معمولاً مستلزم آن است که قبلاً یک سیستم احراز هویت را در برنامه خود پیاده سازی کرده باشید و تجربه ورود به سیستم را به کاربران خود ارائه دهید.

پیاده سازی

هنگامی که کاربری برای برنامه iOS شما شناخته شده است، باید با استفاده از فیلد userId ، شناسه ای را ارسال کنید که نشان دهنده آن کاربر با تمام بازدیدهای Google Analytics شما، مانند بازدید از صفحه، رویدادها، تراکنش های تجارت الکترونیک و غیره باشد.

برای ارسال شناسه کاربر، فیلد userId را با استفاده از آمپر و نحو پروتکل اندازه گیری و نام پارامتر kGAIUserId تنظیم کنید، مانند این مثال:

/**
 * 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];