ابعاد و معیارهای پشتیبانی شده در پرس و جوهای روش Realtime در Analytics Data API. روش‌های گزارش اصلی (مثلاً RunReport ) مجموعه‌ای از ابعاد و متریک‌ها را نسبت به روش Realtime می‌پذیرد.
ابعاد
ابعاد زیر را می توان در گزارشات برای هر ملکی درخواست کرد. "نام API" را در قسمت name منبع Dimension برای ستونی از بعد در پاسخ گزارش مشخص کنید.
| نام API | نام رابط کاربری | توضیحات |
|---|---|---|
appVersion | نسخه برنامه | نسخه نام برنامه (اندروید) یا نسخه کوتاه باندل (iOS). |
audienceId | شناسه مخاطب | شناسه عددی یک مخاطب. کاربران در محدوده تاریخ گزارش در مخاطبانی که به آنها تعلق داشتند گزارش می شوند. رفتار کاربر فعلی بر عضویت مخاطبان تاریخی در گزارش‌ها تأثیر نمی‌گذارد. |
audienceName | نام مخاطب | نام داده شده یک مخاطب کاربران در محدوده تاریخ گزارش در مخاطبانی که به آنها تعلق داشتند گزارش می شوند. رفتار کاربر فعلی بر عضویت مخاطبان تاریخی در گزارش‌ها تأثیر نمی‌گذارد. |
audienceResourceName | نام منبع مخاطب | نام منبع این مخاطبان. نام منابع حاوی هر دو شناسه مجموعه و منبع برای شناسایی منحصر به فرد یک منبع است. برای کسب اطلاعات بیشتر، به نام منابع مراجعه کنید. |
city | شهر | شهری که فعالیت کاربر از آن سرچشمه گرفته است. |
cityId | شناسه شهر | شناسه جغرافیایی شهری که فعالیت کاربر از آن سرچشمه گرفته است، از آدرس IP آنها مشتق شده است. |
country | کشور | کشوری که فعالیت کاربر از آن منشا گرفته است. |
countryId | شناسه کشور | شناسه جغرافیایی کشوری که فعالیت کاربر از آن سرچشمه گرفته است، برگرفته از آدرس IP آنها. فرمت شده بر اساس استاندارد ISO 3166-1 alpha-2. |
deviceCategory | دسته دستگاه | نوع دستگاه: رومیزی، تبلت یا موبایل. |
eventName | نام رویداد | نام رویداد. |
minutesAgo | دقایقی قبل بیدرنگ | تعداد دقایقی پیش که یک رویداد جمع آوری شد. 00 دقیقه فعلی است و 01 به معنای دقیقه قبل است. |
platform | پلت فرم | پلتفرمی که برنامه یا وب سایت شما روی آن اجرا می شود؛ برای مثال، وب، iOS یا اندروید. برای تعیین نوع جریان در گزارش، از هر دو پلتفرم و streamId استفاده کنید. |
streamId | شناسه جریان | شناسه جریان داده عددی برای برنامه یا وب سایت شما. |
streamName | نام جریان | نام جریان داده برای برنامه یا وب سایت شما. |
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 | نام رابط کاربری | توضیحات |
|---|---|---|
activeUsers | کاربران فعال | تعداد کاربران مشخصی که از سایت یا برنامه شما بازدید کردند. |
eventCount | شمارش رویداد | شمارش رویدادها |
keyEvents | رویدادهای کلیدی | شمارش رویدادهای کلیدی علامت گذاری یک رویداد به عنوان یک رویداد کلیدی بر گزارش های مربوط به زمان ایجاد تأثیر می گذارد. داده های تاریخی را تغییر نمی دهد. می‌توانید هر رویدادی را به‌عنوان کلید در Google Analytics علامت‌گذاری کنید، و برخی رویدادها (مانند first_open یا purchase ) به‌طور پیش‌فرض به‌عنوان رویدادهای کلیدی علامت‌گذاری می‌شوند. |
screenPageViews | بازدیدها | تعداد صفحه‌های برنامه یا صفحات وب که کاربران شما مشاهده کرده‌اند. بازدیدهای مکرر از یک صفحه یا صفحه شمارش می شود. (رویدادهای screen_view + page_view). |
معیارهای سفارشی با محدوده رویداد در API Realtime پشتیبانی نمی‌شوند.