بُعدها و سنجههای پشتیبانیشده در پُرسمانهای روش همزمان Analytics Data API. روشهای
«گزارشدهی اصلی» (RunReport
برای مثال) مجموعه متفاوتی از ابعاد و سنجهها
را نسبتبه روش «بلادرنگ» میپذیرند.
ابعاد
بُعدهای زیر را میتوان در گزارشهای هر دارایی درخواست کرد. «نام API» را در فیلد name منبع Dimension برای ستونی از بُعد در پاسخ گزارش مشخص کنید.
| نام میانای برنامهسازی کاربردی | نام میانای کاربر | شرح |
|---|---|---|
appVersion |
نسخه برنامه | versionName (برای Android) یا نسخه بسته کوتاه (برای iOS) برنامه. |
audienceId |
شناسه مخاطب | شناسه عددی «مخاطب». کاربران در مخاطبانی گزارش میشوند که درطول محدوده تاریخ گزارش به آنها تعلق داشتهاند. رفتار کنونی کاربر بر عضویت مخاطبان گذشته در گزارشها تأثیر نمیگذارد. |
audienceName |
نام مخاطب | نام دادهشده «مخاطب». کاربران در مخاطبانی گزارش میشوند که درطول محدوده تاریخ گزارش به آنها تعلق داشتهاند. رفتار کنونی کاربر بر عضویت مخاطبان گذشته در گزارشها تأثیر نمیگذارد. |
audienceResourceName |
نام منبع مخاطب | نام منبع این مخاطب. نامهای منبع حاوی شناسههای مجموعه و منبع هستند تا منبع را بهطور منحصربهفرد شناسایی کنند؛ برای اطلاعات بیشتر، نامهای منبع را ببینید. |
city |
شهر | شهری که فعالیت کاربر از آنجا آغاز شده است. |
cityId |
شناسه شهر | شناسه جغرافیایی شهری که فعالیت کاربر از آن نشأت گرفته است، که از نشانی IP او مشتق شده است. |
country |
کشور | کشوری که فعالیت کاربر از آن نشأت گرفته است. |
countryId |
شناسه کشور | شناسه جغرافیایی کشوری که فعالیت کاربر از آن نشأت گرفته است، که از نشانی IP او مشتق شده است. قالببندیشده طبق استاندارد ISO 3166-1 alpha-2. |
deviceCategory |
دسته دستگاه | نوع دستگاه: رایانه، رایانه لوحی، یا تلفن همراه. |
eventName |
نام رویداد | نام رویداد. |
minutesAgo |
تماشای بیدرنگ چند دقیقه گذشته | تعداد دقیقههایی که از جمعآوری رویداد گذشته است. 00 دقیقه فعلی است و 01 یعنی دقیقه قبلی. |
platform |
پلاتفرم | پلاتفرمی که برنامه یا وبسایت شما در آن اجرا شده است؛ برای مثال، وب، iOS، یا Android. برای تعیین نوع جریان داده در گزارش، از هر دو پلاتفرم و streamId استفاده کنید. |
streamId |
شناسه جریان داده | شناسه عددی جریان داده برای برنامه یا وبسایت شما. |
streamName |
نام جریان | نام جاریسازی داده برای برنامه یا وبسایت شما. |
unifiedScreenName |
عنوان صفحه و نام صفحهنمایش | عنوان صفحه (وب) یا نام صفحهنمایش (برنامه) که رویداد در آن ثبت شده است. |
ابعاد سفارشی
Realtime Data API میتواند گزارشهایی درباره «بُعدهای سفارشی» با گستره «کاربر» ایجاد کند. برای کسب اطلاعات بیشتر درباره ابعاد سفارشی،
ویژگیهای سفارشی کاربر را ببینید. ابعاد سفارشی در درخواست گزارش میانای برنامهسازی کاربردی
براساس نام پارامتر و دامنه بُعد مشخص میشوند. برای مثال،
"customUser:last_level" را در درخواست Data API اضافه کنید تا گزارشی برای
«بُعد سفارشی کاربرمحور» با نام پارامتر "last_level" ایجاد شود. اگر دارایی این «بُعد سفارشی کاربرمحور» را ثبت نکرده باشد، این درخواست API ناموفق خواهد بود.
در زیر نحو کلی «ابعاد سفارشی» آمده است. میتوانید روش Metadata API را برای فهرست کردن همه «ابعاد سفارشی» برای «دارایی» جستجو کنید.
| Generic API Name | شرح |
|---|---|
customUser:parameter_name |
بُعد سفارشی کاربرمحور برای parameter_name. |
ابعاد سفارشی رویدادمحور در Realtime API پشتیبانی نمیشود.
سنجهها
معیارهای زیر را میتوان در گزارشهای هر دارایی درخواست کرد. «نام API» را در فیلد name منبع Metric برای ستون سنجه در پاسخ گزارش مشخص کنید.
| نام میانای برنامهسازی کاربردی | نام میانای کاربر | شرح |
|---|---|---|
activeUsers |
کاربران فعال | تعداد کاربران متمایزی که از سایت یا برنامه شما بازدید کردهاند. |
eventCount |
تعداد رویدادها | تعداد رویدادها. |
keyEvents |
رویدادهای کلیدی | تعداد رویدادهای کلیدی. علامتگذاری رویداد بهعنوان رویداد کلیدی بر گزارشهای زمان ایجاد تأثیر میگذارد. این کار دادههای گذشته را تغییر نمیدهد. میتوانید هر رویدادی را در Google Analytics بهعنوان رویداد کلیدی علامتگذاری کنید و برخیاز رویدادها (مثل first_open یا purchase) بهطور پیشفرض بهعنوان رویداد کلیدی علامتگذاری میشوند. |
screenPageViews |
بازدیدها | تعداد صفحههای برنامه یا صفحههای وبی که کاربران شما مشاهده کردهاند. بازدیدهای تکراری از یک صفحه یا صفحه نمایش شمارش میشوند. (رویدادهای screen_view + page_view). |
سنجههای سفارشی با گستره رویداد در Realtime API پشتیبانی نمیشوند.