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