با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
Google Analytics یک تماس setUserID دارد که به شما امکان می‌دهد یک شناسه کاربری را برای فردی که از برنامه خود استفاده می‌کند ذخیره کنید. این تماس اختیاری است و معمولاً توسط سازمان‌هایی استفاده می‌شود که می‌خواهند از Analytics همراه با BigQuery برای مرتبط کردن داده‌های تجزیه و تحلیل برای یک کاربر در چندین برنامه، چندین دستگاه یا چندین ارائه‌دهنده تجزیه و تحلیل استفاده کنند.
راه های زیادی وجود دارد که می توانید شناسه های کاربری معتبر بسازید. یکی از روش‌ها استفاده از شناسه‌ای است که شما اختصاص می‌دهید و فقط شما می‌توانید به یک کاربر خاص ردیابی کنید. برای یک مثال ممکن، یک توسعه‌دهنده بازی‌های موبایل فرضی، AwesomeGameCompany را در نظر بگیرید که شناسه داخلی AwesomeGameCompanyID خود را دارد که برای هر کاربر ایجاد می‌کند. اگر برای یک سازمان خارجی امکان ردیابی آن AwesomeGameCompanyID به کاربر اصلی وجود ندارد، ممکن است از آن AwesomeGameCompanyID - یا بهتر از آن، نسخه هش شده AwesomeGameCompanyID - به عنوان مقدار شناسه کاربر برای Analytics استفاده کند. سپس به آنها اجازه می دهد تا مقادیری مانند کل هزینه کاربر در تمام بازی های خود را محاسبه کنند.
برای اینکه Analytics به درستی کار کند هرگز نیازی به تنظیم شناسه کاربری نیست. اگر فقط به یافتن رویدادهای متعلق به یک کاربر برای یک برنامه در یک دستگاه علاقه دارید، می‌توانید از user_pseudo_id استفاده کنید. این مقدار به طور خودکار توسط Analytics تولید می شود و برای هر رویداد در BigQuery ذخیره می شود.
تنظیم شناسه کاربری
با روش زیر می توانید یک شناسه کاربری تنظیم کنید:
سویفت
توجه: این محصول Firebase در هدف macOS در دسترس نیست.
Analytics.setUserID("123456")
هدف-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)."]]
