ابعاد و معیارهای پشتیبانی شده در پرس و جوهای روش Realtime در Analytics Data API. روش‌های گزارش اصلی (مثلاً RunReport ) مجموعه‌ای از ابعاد و متریک‌ها را نسبت به روش Realtime می‌پذیرد.
ابعاد
ابعاد زیر را می توان در گزارشات برای هر ملکی درخواست کرد. "نام API" را در قسمت name منبع Dimension برای ستونی از بعد در پاسخ گزارش مشخص کنید.
| نام API | نام رابط کاربری | شرح |
|---|---|---|
| نسخه برنامه | نسخه برنامه | نسخه نام برنامه (اندروید) یا نسخه کوتاه باندل (iOS). |
| شناسه مخاطب | شناسه مخاطب | شناسه عددی یک مخاطب. کاربران در محدوده تاریخ گزارش در مخاطبانی که به آنها تعلق داشتند گزارش می شوند. رفتار کاربر فعلی بر عضویت مخاطبان تاریخی در گزارش‌ها تأثیر نمی‌گذارد. |
| نام مخاطب | نام مخاطب | نام داده شده یک مخاطب کاربران در محدوده تاریخ گزارش در مخاطبانی که به آنها تعلق داشتند گزارش می شوند. رفتار کاربر فعلی بر عضویت مخاطبان تاریخی در گزارش‌ها تأثیر نمی‌گذارد. |
| شهر | شهر | شهری که فعالیت کاربر از آن سرچشمه گرفته است. |
| شهر شناسه | شناسه شهر | شناسه جغرافیایی شهری که فعالیت کاربر از آن سرچشمه گرفته است، از آدرس IP آنها مشتق شده است. |
| کشور | کشور | کشوری که فعالیت کاربر از آن منشا گرفته است. |
| شناسه کشور | شناسه کشور | شناسه جغرافیایی کشوری که فعالیت کاربر از آن سرچشمه گرفته است، برگرفته از آدرس IP آنها. فرمت شده بر اساس استاندارد ISO 3166-1 alpha-2. |
| دسته دستگاه | دسته دستگاه | نوع دستگاه: رومیزی، تبلت یا موبایل. |
| نام رخداد | نام رخداد | نام رویداد. |
| دقیقه قبل | دقایقی پیش بیدرنگ | تعداد دقایقی پیش که یک رویداد جمع آوری شد. 00 دقیقه فعلی است و 01 به معنای دقیقه قبل است. |
| سکو | سکو | پلتفرمی که برنامه یا وب سایت شما روی آن اجرا می شود؛ برای مثال، وب، iOS یا اندروید. برای تعیین نوع جریان در گزارش، از هر دو پلتفرم و streamId استفاده کنید. |
| streamId | شناسه جریان | شناسه جریان داده عددی برای برنامه یا وب سایت شما. |
| نام جریان | نام جریان | نام جریان داده برای برنامه یا وب سایت شما. |
| unifiedScreenName | عنوان صفحه و نام صفحه | عنوان صفحه (وب) یا نام صفحه (برنامه) که رویداد در آن ثبت شده است. |
ابعاد سفارشی
Realtime Data API می‌تواند گزارش‌هایی درباره ابعاد سفارشی با محدوده کاربر ایجاد کند. برای کسب اطلاعات بیشتر در مورد ابعاد سفارشی ، ویژگی های کاربر سفارشی را ببینید. ابعاد سفارشی در یک درخواست گزارش API با نام پارامتر و محدوده ابعاد مشخص می‌شوند. برای مثال، "customUser:last_level" را در درخواست Data API برای ایجاد گزارشی برای بعد سفارشی محدوده کاربر با نام پارامتر "last_level" قرار دهید. این درخواست API در صورتی که دارایی این بعد سفارشی با محدوده کاربر را ثبت نکرده باشد ناموفق خواهد بود.
در زیر دستور کلی برای ابعاد سفارشی آمده است. می‌توانید برای فهرست کردن همه ابعاد سفارشی برای یک ویژگی، از متد API فراداده پرس و جو کنید.
| نام API عمومی | شرح |
|---|---|
| customUser:parameter_name | ابعاد سفارشی با محدوده کاربر برای parameter_name |
ابعاد سفارشی با محدوده رویداد در API Realtime پشتیبانی نمی‌شود.
معیارهای
معیارهای زیر را می توان در گزارش برای هر ملک درخواست کرد. "نام API" را در قسمت name منبع Metric برای ستونی از متریک در پاسخ گزارش مشخص کنید.
| نام API | نام رابط کاربری | شرح |
|---|---|---|
| فعال کاربران | کاربران فعال | تعداد کاربران مشخصی که از سایت یا برنامه شما بازدید کردند. |
| تبدیل ها | تبدیل ها | تعداد رویدادهای تبدیل رویدادها در زمان جمع آوری به عنوان تبدیل علامت گذاری می شوند. تغییرات در علامت تبدیل رویداد در آینده اعمال می شود. می‌توانید هر رویدادی را به‌عنوان تبدیل در Google Analytics علامت‌گذاری کنید، و برخی رویدادها (یعنی first_open، خرید) به‌طور پیش‌فرض به‌عنوان تبدیل علامت‌گذاری می‌شوند. برای اطلاعات بیشتر، درباره تبدیل‌ها را ببینید. |
| شمارش رویداد | شمارش رویداد | شمارش رویدادها |
| screenPageViews | بازدیدها | تعداد صفحه‌های برنامه یا صفحات وب که کاربران شما مشاهده کرده‌اند. بازدیدهای مکرر از یک صفحه یا صفحه شمارش می شود. (رویدادهای screen_view + page_view). |
معیارهای سفارشی با محدوده رویداد در API Realtime پشتیبانی نمی‌شوند.