شناسه کاربری - Android SDK

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

بررسی اجمالی

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

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

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

پیش نیازها

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

پیاده سازی

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

برای ارسال User ID، فیلد userId را با استفاده از آمپر و نحو پروتکل اندازه گیری و نام پارامتر Fields.USER_ID تنظیم کنید، مانند این مثال:

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

  Tracker t = GoogleAnalytics.getInstance(context).getTracker("UA-XXXX-Y");

  // 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.
  t.set(Fields.USER_ID, user.getId());

  // This hit will be sent with the User ID value and be visible in User-ID-enabled views (profiles).
  t.send(MapBuilder
      .createEvent("UX",       // Event category (required)
                   "Sign In",  // Event action (required)
                   null,       // Event label
                   null)       // Event value
      .build()
  );
}