رقم تعريف المستخدم - حزمة تطوير البرامج (SDK) لنظام التشغيل Android

توضِّح أدلة المطوِّرين هذه كيفية تنفيذ ميزة User ID باستخدام الإصدار 3.x من حزمة "إحصاءات Google" SDK لنظام التشغيل Android.

نظرة عامة

تتيح ميزة User ID إمكانية قياس أنشطة المستخدمين التي تشمل جميع الأجهزة في "إحصاءات Google"، مثل إحالة تفاعل مع حملة تسويقية على أحد الأجهزة الجوّالة إلى إحالة ناجحة تحدث على جهاز جوّال آخر أو في المتصفِّح.

عند إرسال أرقام تعريف المستخدمين مع نتائج "إحصاءات Google" باستخدام الحقل userId، ستعكس تقاريرك عددًا أكثر دقة من المستخدمين الفريدين وتوفّر خيارات جديدة لجميع الأجهزة لإعداد التقارير. مزيد من المعلومات عن مزايا استخدام User ID.

يوضّح هذا الدليل كيفية استخدام الحقل userId وحزمة تطوير البرامج (SDK) لخدمة "إحصاءات Google" لنظام التشغيل Android من أجل إرسال أرقام تعريف المستخدمين إلى "إحصاءات Google".

المتطلبات الأساسية

قبل إرسال User ID إلى "إحصاءات Google":

التنفيذ

عندما يكون أحد المستخدمين معروفًا بتطبيق Android، يتعيّن إرسال رقم تعريف يمثّل هذا المستخدِم مع جميع نتائج "إحصاءات Google"، مثل مرّات مشاهدة الصفحة على الويب والأحداث ومعاملات التجارة الإلكترونية وما إلى ذلك باستخدام الحقل userId.

لإرسال رقم تعريف المستخدم، اضبط الحقل userId باستخدام بنية العطف في Measurement Protocol واسم المَعلمة 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()
  );
}