تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يتضمّن Google Analytics طلبًا باسم setUserID، ما يتيح لك تخزين رقم تعريف مستخدم للفرد الذي يستخدم تطبيقك. هذا الطلب اختياري، وتستخدمه عادةً المؤسسات التي تريد استخدام Analytics بالتزامن مع BigQuery لربط بيانات الإحصاءات الخاصة بالمستخدم نفسه على مستوى تطبيقات أو أجهزة أو مقدّمي خدمات إحصاءات متعدّدين.
هناك العديد من الطرق التي يمكنك من خلالها إنشاء أرقام تعريف مستخدمين صالحة. أحد الأساليب هو استخدام معرّف تحدّده أنت وحدك ويمكنك من خلاله تتبُّع بيانات مستخدم فردي. على سبيل المثال، لنفترض أنّ هناك مطوّرًا افتراضيًا لألعاب الأجهزة الجوّالة، وهو AwesomeGameCompany، لديه AwesomeGameCompanyID داخلي خاص به ينشئه لكل مستخدم. إذا لم يكن بإمكان مؤسسة خارجية تتبُّع AwesomeGameCompanyID والوصول إلى المستخدم الأصلي، قد تفكّر في استخدام AwesomeGameCompanyID، أو الأفضل من ذلك، نسخة مجزّأة من AwesomeGameCompanyID، كقيمة لرقم تعريف المستخدم في Analytics.
سيسمح ذلك بعد ذلك بحساب قيم مثل إجمالي إنفاق المستخدم على جميع ألعابه.
لا يُشترط أبدًا ضبط رقم تعريف المستخدم لكي تعمل Analytics بشكلٍ سليم.
إذا كنت مهتمًا فقط بالعثور على الأحداث التي تخص المستخدم نفسه للتطبيق نفسه على جهاز واحد، يمكنك استخدام user_pseudo_id.
يتم إنشاء هذه القيمة تلقائيًا بواسطة Analytics ويتم تخزينها في BigQuery لكل حدث.
ضبط رقم تعريف المستخدم
يمكنك ضبط رقم تعريف المستخدم باستخدام الطريقة التالية:
Swift
ملاحظة: لا يتوفّر منتج Firebase هذا على نظام التشغيل macOS.
Analytics.setUserID("123456")
Objective-C
ملاحظة: لا يتوفّر منتج Firebase هذا على نظام التشغيل macOS.
بعد إعداد رقم تعريف مستخدم، سيتم تلقائيًا وضع علامة على جميع الأحداث المستقبلية باستخدام هذه القيمة، ويمكنك الوصول إليها من خلال طلب البحث عن user_idالقيمة في BigQuery. لن تؤثّر إضافة معرّف مستخدم في أي أحداث سجّلتها Google Analytics سابقًا.
لمزيد من المعلومات حول الوصول إلى بيانات Analytics في BigQuery، يُرجى الاطّلاع على دليل المطوّرين هذا.
تاريخ التعديل الأخير: 2025-08-30 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-30 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["Google Analytics has a `setUserID` call, which allows you to\nstore a user ID for the individual using your app. This call is optional, and\nis generally used by organizations that want to use Analytics\nin conjunction with BigQuery to associate analytics data for the same user across\nmultiple apps, multiple devices, or multiple analytics providers.\n| **Note:** You are responsible for ensuring that your use of the user ID is in accordance with the [Google Analytics Terms of Service](https://www.google.com/analytics/terms/). This includes avoiding the use of impermissible personally identifiable information, and providing appropriate notice of your use of identifiers in your Privacy Policy. Your user ID must not contain information that a third party could use to determine the identity of an individual user. For example, you cannot use a user's email address or social security number as a user ID.\n\nThere are many ways you can construct valid user IDs. One approach is to use an\nidentifier you assign and only you can track back to an individual user. For one\npossible example, consider a hypothetical mobile game developer,\nAwesomeGameCompany, that has their own internal `AwesomeGameCompanyID` that they\ncreate for every user. If it isn't possible for an outside organization to track\nthat `AwesomeGameCompanyID` back to the original user, they might consider using\nthat `AwesomeGameCompanyID` --- or, better yet, a hashed version of\n`AwesomeGameCompanyID` --- as the user ID value for Analytics.\nThis would then allow them to calculate values such as a user's total spend\nacross all of their games.\n\nSetting a user ID is never required for Analytics to work correctly.\nIf you're only interested in finding events belonging to the same user for the\nsame app on a single device, you can use the `user_pseudo_id`.\nThis value is generated automatically by Analytics and is\nstored within BigQuery for each event.\n\nSetting the user ID\n\nYou can set a user ID with the following method: \n\nSwift\n\n\n**Note:** This Firebase product is not available on the macOS target. \n\n```swift\nAnalytics.setUserID(\"123456\")\n```\n\nObjective-C\n\n\n**Note:** This Firebase product is not available on the macOS target. \n\n```objective-c\n[FIRAnalytics setUserID:@\"123456\"]\n```\n\nAndroid \n\n```java\nmFirebaseAnalytics.setUserId(\"123456\");\n```\n\nWeb \n\n```java\nimport { getAnalytics, setUserId } from \"firebase/analytics\";\n\nconst analytics = getAnalytics();\nsetUserId(analytics, \"123456\");\n```\n\nWeb \n\n```java\nfirebase.analytics().setUserId(\"123456\");\n```\n\nDart \n\n```dart\nawait FirebaseAnalytics.instance.setUserId(id: '123456');\n```\n\nUnity \n\n```c#\nFirebase.Analytics.FirebaseAnalytics.SetUserID(\"123456\");\n```\n\nC++ \n\n```c++\nanalytics::SetUserId(\"123456\");\n```\n\nAfter setting a user ID, all future events will be automatically tagged\nwith this value, and you can access it by querying for the `user_id`\nvalue in BigQuery. Adding a user ID will not affect any\nevents previously recorded by Google Analytics.\n\nTo find out more about accessing Analytics data in BigQuery, please see\nthis [development guide](https://cloud.google.com/solutions/mobile/mobile-firebase-analytics-big-query)."]]
