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

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

نظرة عامة

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

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

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

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

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

• إعداد User ID.
• راجِع سياسة أرقام تعريف المستخدمين.
• تعرّف على طريقة عمل User ID من خلال مراجعة مرجع ميزات User ID.

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

التنفيذ

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

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