ضبط رقم تعريف مستخدم

تتضمّن Google Analytics طلبًا setUserID، ما يتيح لك تخزين رقم تعريف مستخدم للفرد الذي يستخدم تطبيقك. هذا الطلب اختياري، ويستخدمه بشكل عام المؤسسات التي تريد استخدام Analytics بالاشتراك مع BigQuery لربط بيانات الإحصاءات للمستخدم نفسه على مستوى تطبيقات متعددة أو أجهزة متعددة أو مزوّدي خدمات إحصاءات متعددين.

ملاحظة: تقع على عاتقك مسؤولية التأكّد من توافق استخدامك لرقم تعريف المستخدِم مع بنود خدمة Google Analytics. ويشمل ذلك تجنُّب استخدام معلومات تحديد الهوية الشخصية غير المسموح بها، وتقديم إشعار مناسب بشأن استخدامك للمعرّفات في سياسة الخصوصية. يجب ألا يحتوي رقم تعريف المستخدم على معلومات يمكن لجهة خارجية استخدامها لتحديد هوية مستخدم فردي. على سبيل المثال، لا يمكنك استخدام عنوان البريد الإلكتروني للمستخدم أو رقم تأمينه الاجتماعي كرقم تعريف مستخدم.

هناك العديد من الطرق التي يمكنك من خلالها إنشاء أرقام تعريف مستخدمين صالحة. ومن الطرق التي يمكنك اتّباعها استخدام معرّف تحدّده بنفسك ويمكنك وحدك تتبُّعه إلى مستخدم فردي. على سبيل المثال، لنفترض أنّ شركة AwesomeGameCompanyID، وهي شركة افتراضية لتطوير الألعاب على الأجهزة الجوّالة، تمتلك AwesomeGameCompanyID داخليًا يتم إنشاؤه لكل مستخدم. إذا لم يكن بإمكان مؤسسة خارجية تتبُّع AwesomeGameCompanyID هذا للوصول إلى المستخدم الأصلي، قد تفكر في استخدام AwesomeGameCompanyID هذا — أو أفضل من ذلك، نسخة مجزّأة من AwesomeGameCompanyID — كقيمة رقم تعريف المستخدم لـ Analytics. سيتيح لهم ذلك بعد ذلك احتساب قيم مثل إجمالي إنفاق المستخدم في جميع ألعابه.

لا يُشترط أبدًا ضبط رقم تعريف مستخدم لكي يعمل Analytics بشكل صحيح. إذا كنت مهتمًا فقط بالعثور على الأحداث التي تخصّ المستخدِم نفسه في التطبيق نفسه على جهاز واحد، يمكنك استخدام user_pseudo_id. يتم إنشاء هذه القيمة تلقائيًا بواسطة Analytics ويتم تخزينها في BigQuery لكل حدث.

ضبط رقم تعريف المستخدم

يمكنك ضبط رقم تعريف مستخدم باستخدام الطريقة التالية:

Swift

ملاحظة: لا يتوفّر منتج Firebase هذا على نظام التشغيل macOS.

Analytics.setUserID("123456")

Objective-C

ملاحظة: لا يتوفّر منتج Firebase هذا على نظام التشغيل macOS.

[FIRAnalytics setUserID:@"123456"]

Android

mFirebaseAnalytics.setUserId("123456");

Web

import { getAnalytics, setUserId } from "firebase/analytics";

const analytics = getAnalytics();
setUserId(analytics, "123456");

Web

firebase.analytics().setUserId("123456");

Dart

await FirebaseAnalytics.instance.setUserId(id: '123456');

Unity

Firebase.Analytics.FirebaseAnalytics.SetUserID("123456");

C++‎

analytics::SetUserId("123456");

بعد ضبط رقم تعريف مستخدم، سيتم تلقائيًا وضع علامة بهذه القيمة على جميع الأحداث المستقبلية، ويمكنك الوصول إليها من خلال طلب القيمة user_id في BigQuery. لن تؤثّر إضافة معرّف مستخدم في أي أحداث سجّلها Google Analytics في السابق.

للاطّلاع على مزيد من المعلومات عن الوصول إلى بيانات Analytics في BigQuery، يُرجى الاطّلاع على دليل المطوّر هذا.