ابعاد و معیارهای پشتیبانیشده در کوئریهای مربوط به روش گزارشهای دسترسی به دادهها از API مدیریت تحلیلی.
ابعاد
ابعاد زیر را میتوان در گزارشهای دسترسی به دادهها درخواست کرد. در فیلد name بُعد منبع AccessDimension برای ستونی از بُعد در پاسخ گزارش، "نام API" را مشخص کنید.
| نام API | نام رابط کاربری | ویژگیهای مجاز | توضیحات |
|---|---|---|---|
accessDateHour | تاریخ دسترسی، ساعت | همه ویژگیهای گوگل آنالیتیکس | تاریخ و ساعت کاربر GA که به دادههای گزارش GA دسترسی داشته است. با فرمت YYYYMMDDHH. |
accessMechanism | مکانیزم دسترسی | ویژگیهای گوگل آنالیتیکس ۳۶۰ | مکانیزمی که از طریق آن یک کاربر GA به دادههای گزارشدهی GA دسترسی پیدا کرده است. مقادیر ممکن شامل «رابط کاربری Google Analytics»، «API Google Analytics»، «Firebase»، «Google Ads» و موارد دیگر است. |
accessedPropertyId | شناسه ملک مورد دسترسی | همه ویژگیهای گوگل آنالیتیکس | شناسه ویژگی که دادههای گزارش GA از طریق آن مورد دسترسی قرار گرفتهاند. اکثر گزارشهای دسترسی به دادهها فقط شامل یک ویژگی هستند، اما اگر ویژگی درخواستی دارای یک زیر ویژگی باشد، گزارشهای دسترسی به دادهها شامل دسترسی به هر دو ویژگی منبع و زیر ویژگی هستند. برای کسب اطلاعات بیشتر، به بخش «زیر ویژگیها» مراجعه کنید. |
accessedPropertyName | نام ویژگی دسترسی یافته | همه ویژگیهای گوگل آنالیتیکس | نام نمایشی ویژگی که دادههای گزارش GA در آن مورد دسترسی قرار گرفتهاند. اکثر گزارشهای دسترسی به دادهها فقط شامل یک ویژگی هستند، اما اگر ویژگی درخواستی دارای یک زیر ویژگی باشد، گزارشهای دسترسی به دادهها شامل دسترسی به هر دو ویژگی منبع و زیر ویژگی هستند. برای کسب اطلاعات بیشتر، به «زیر ویژگیها» مراجعه کنید. |
accessorAppName | نام برنامه دسترسی | همه ویژگیهای گوگل آنالیتیکس | نام برنامهای که به دادههای گزارشدهی گوگل آنالیتیکس دسترسی داشته است. شما به برنامهها و سرویسهای شخص ثالث اجازه میدهید تا دادههای گزارشدهی گوگل آنالیتیکس شما را مشاهده کنند. برای کسب اطلاعات بیشتر، به مدیریت ارتباطات بین حساب گوگل شما و اشخاص ثالث مراجعه کنید. |
costDataReturned | دادههای هزینه بازگردانده شدند | ویژگیهای گوگل آنالیتیکس ۳۶۰ | اگر دادههای هزینه در این گزارش برگردانده شده باشد، true را برمیگرداند. در غیر این صورت، این بُعد مقدار false را برمیگرداند. کاربران GA که محدودیت «بدون معیارهای هزینه» دارند، قادر به دیدن معیارهای هزینه نیستند. این بُعد تا زمانی که این محدودیت فعال باشد، همیشه false خواهد بود. برای کسب اطلاعات بیشتر، به مدیریت دسترسی و محدودیت دادهها مراجعه کنید. |
dataApiQuotaCategory | دسته سهمیه API داده | همه ویژگیهای گوگل آنالیتیکس | دسته سهمیه برای درخواست API داده. مقادیر ممکن عبارتند از: 'هسته'، 'زمان واقعی' و 'قیف'. |
epochTimeMicros | ریزپردازندههای زمان عصر | ویژگیهای گوگل آنالیتیکس ۳۶۰ | میکروثانیههای یونیکس از زمانی که کاربر GA به دادههای گزارش GA دسترسی پیدا کرده است. برای مثال، یک میکروثانیه یونیکس از '1655220215027371' در America/New_York برابر با 2022-06-14 11:23:35 است. |
mostRecentAccessEpochTimeMicros | جدیدترین ریزمقیاسهای زمان دسترسی | ویژگیهای گوگل آنالیتیکس ۳۶۰ | آخرین زمان دسترسی برای این سطر. از زمان شروع به کار بر حسب میکروثانیه یونیکس برگردانده میشود. معمولاً با 'userEmail' و ابعاد مشابه برای تعیین آخرین زمان دسترسی کاربران GA استفاده میشود. |
reportType | نوع گزارش | ویژگیهای گوگل آنالیتیکس ۳۶۰ | نوع دادههای گزارشدهی که کاربر GA به آنها دسترسی داشته است. مقادیر ممکن شامل «گزارشدهی»، «زمان واقعی»، «کاوش فرم رایگان»، «کاوش قیف» و موارد دیگر است. |
revenueDataReturned | دادههای درآمد بازگردانده شد | ویژگیهای گوگل آنالیتیکس ۳۶۰ | اگر دادههای درآمد در این گزارش برگردانده شده باشد، true را برمیگرداند. در غیر این صورت، این بُعد مقدار false را برمیگرداند. کاربران GA که محدودیت «بدون معیارهای درآمد» دارند، قادر به دیدن معیارهای درآمد نیستند. این بُعد تا زمانی که این محدودیت فعال باشد، همیشه false خواهد بود. برای کسب اطلاعات بیشتر، به مدیریت دسترسی و محدودیت دادهها مراجعه کنید. |
userCountry | کشور کاربر | ویژگیهای گوگل آنالیتیکس ۳۶۰ | کشور کاربر GA که به دادههای گزارش GA دسترسی داشته است. |
userCountryId | شناسه کشور کاربر | ویژگیهای گوگل آنالیتیکس ۳۶۰ | شناسه کشور کاربر GA که به دادههای گزارش GA دسترسی داشته است. مطابق با استاندارد ISO 3166-1 alpha-2 قالببندی شده است. |
userEmail | ایمیل کاربر | همه ویژگیهای گوگل آنالیتیکس | ایمیل کاربر GA که به دادههای گزارش GA دسترسی داشته است. برخی از ادغامها به کاربران اجازه میدهند از طریق ادغام به دادههای گزارش GA دسترسی پیدا کنند، بدون اینکه کاربر مستقیماً به آن ویژگی دسترسی داشته باشد؛ در این صورت، «userEmail» بسته به ادغام، مثلاً «کاربر مرتبط با تبلیغات گوگل» را برمیگرداند. |
userIP | آیپی کاربر | ویژگیهای گوگل آنالیتیکس ۳۶۰ | آیپی کاربر GA که به دادههای گزارشدهی GA دسترسی داشته است. |
معیارها
معیارهای زیر را میتوان در گزارشهای دسترسی به دادهها درخواست کرد. برای ستونی از معیار در پاسخ گزارش، در فیلد name معیار منبع AccessMetric ، "نام API" را مشخص کنید.
| نام API | نام رابط کاربری | ویژگیهای مجاز | توضیحات |
|---|---|---|---|
accessCount | تعداد دسترسی | ویژگیهای گوگل آنالیتیکس ۳۶۰ | تعداد دفعاتی که به دادههای گزارش گوگل آنالیتیکس دسترسی پیدا شده است. هنگام استفاده از رابط کاربری گوگل آنالیتیکس، هر کارت گزارش میتواند منجر به یک یا چند رویداد دسترسی به دادهها شود. در نتیجه، پیمایش در رابط کاربری گوگل آنالیتیکس میتواند منجر به رویدادهای دسترسی بیشتری نسبت به تعداد گزارشهای مشاهده شده شود. |
dataApiQuotaPropertyTokensConsumed | توکنهای مصرفشدهی ویژگی سهمیهبندی API داده | همه ویژگیهای گوگل آنالیتیکس | کل توکنهای سهمیهی دارایی مصرفشده برای درخواستهای Data API را برمیگرداند. |