طرحواره دسترسی به داده‌ها

ابعاد و سنجه‌های پشتیبانی‌شده در پُرسمان‌های روش گزارش‌های دسترسی به داده‌ها در Analytics Admin API.

ابعاد

ابعاد زیر را می‌توان در گزارش‌های دسترسی به داده‌ها درخواست کرد. «نام API» را در فیلد AccessDimension ابعاد منبع name برای ستون ابعاد در پاسخ گزارش مشخص کنید.

نام میانای برنامه‌سازی کاربردی	نام میانای کاربر	دارایی‌های مجاز	شرح
accessDateHour	ساعت تاریخ دسترسی	همه دارایی‌های Google Analytics	تاریخ ساعت کاربر GA که به داده‌های گزارش GA دسترسی داشته است. به‌صورت YYYYMMDDHH قالب‌بندی شده است.
accessMechanism	سازوکار دسترسی	دارایی‌های Google Analytics 360	سازوکاری که کاربر GA ازطریق آن به داده‌های گزارش‌دهی GA دسترسی پیدا کرده است. مقادیر ممکن شامل «میانای کاربر Google Analytics»،‏ «Google Analytics API»،‏ «Firebase»،‏ «Google Ads»، و موارد دیگر می‌شود.
accessedPropertyId	شناسه ملک دردسترس قرارگرفته	همه دارایی‌های Google Analytics	شناسه دارایی که داده‌های گزارش‌دهی GA در آن دسترسی پیدا شده است. بیشتر «گزارش‌های دسترسی به داده‌ها» فقط یک دارایی دارند، اما اگر دارایی درخواست‌شده دارای دارایی فرعی باشد، «گزارش‌های دسترسی به داده‌ها» شامل دسترسی به دارایی منبع و دارایی فرعی می‌شود. برای کسب اطلاعات بیشتر، درباره دارایی‌های فرعی را ببینید.
accessedPropertyName	نام دارایی دسترسی‌پذیر	همه دارایی‌های Google Analytics	نام نمایشی دارایی که داده‌های گزارش GA در آن دسترسی پیدا شده است. بیشتر «گزارش‌های دسترسی به داده‌ها» فقط یک دارایی دارند، اما اگر دارایی درخواست‌شده دارای دارایی فرعی باشد، «گزارش‌های دسترسی به داده‌ها» شامل دسترسی به دارایی منبع و دارایی فرعی می‌شود. برای کسب اطلاعات بیشتر، درباره دارایی‌های فرعی را ببینید.
accessorAppName	نام برنامه دسترسی‌دهنده	همه دارایی‌های Google Analytics	نام برنامه‌ای که به داده‌های گزارش‌دهی Google Analytics دسترسی پیدا کرده است. به برنامه‌ها و سرویس‌های طرف سوم اجازه می‌دهید داده‌های گزارش Google Analytics شما را ببینند. برای کسب اطلاعات بیشتر، مدیریت اتصال‌های بین «حساب Google» و طرف‌های سوم را ببینید.
costDataReturned	داده‌های هزینه برگردانده شد	دارایی‌های Google Analytics 360	اگر داده‌های هزینه در این گزارش برگردانده شده باشد، true را برمی‌گرداند. درغیراین‌صورت، این بُعد false را برمی‌گرداند. کاربران GA با محدودیت «بدون سنجه‌های هزینه» نمی‌توانند سنجه‌های هزینه را ببینند. تا زمانی که این محدودیت فعال باشد، این بُعد همیشه false خواهد بود. برای کسب اطلاعات بیشتر، مدیریت دسترسی و محدودیت داده را ببینید.
dataApiQuotaCategory	دسته سهمیه Data API	همه دارایی‌های Google Analytics	دسته سهمیه برای درخواست Data API. مقادیر ممکن عبارت‌اند از: «اصلی»، «هم‌زمان»، و «قیف».
epochTimeMicros	زمان دوره برحسب میکروثانیه	دارایی‌های Google Analytics 360	میکروثانیه‌های یونیکس از زمان آغاز که کاربر GA به داده‌های گزارش GA دسترسی پیدا کرده است. برای مثال، میکروثانیه یونیکس «۱۶۵۵۲۲۰۲۱۵۰۲۷۳۷۱» برابر با ۱۴ ژوئن ۲۰۲۲ ساعت ۱۱:۲۳:۳۵ در امریکا/نیویورک است.
mostRecentAccessEpochTimeMicros	زمان مبدأ دسترسی اخیر به میکروثانیه	دارایی‌های Google Analytics 360	جدیدترین مُهر زمان دسترسی برای این ردیف. برحسب میکروثانیه یونیکس از تاریخ برگردانده می‌شود. معمولاً با «userEmail» و ابعاد مشابه برای تعیین آخرین زمان‌های دسترسی کاربران GA استفاده می‌شود.
reportType	نوع گزارش	دارایی‌های Google Analytics 360	نوع داده‌های گزارشی که کاربر GA به آن دسترسی داشته است. مقادیر ممکن شامل «گزارش‌دهی»، «هم‌زمان»، «کاوش آزاد»، «کاوش قیف»، و غیره می‌شود.
revenueDataReturned	داده‌های درآمد برگردانده شد	دارایی‌های Google Analytics 360	اگر داده‌های درآمد در این گزارش برگردانده شده باشد، true را برمی‌گرداند. درغیراین‌صورت، این بُعد false را برمی‌گرداند. کاربران GA با محدودیت «بدون سنجه‌های درآمد» نمی‌توانند سنجه‌های درآمد را ببینند. تا زمانی که این محدودیت فعال باشد، این بُعد همیشه false خواهد بود. برای کسب اطلاعات بیشتر، مدیریت دسترسی و محدودیت داده را ببینید.
userCountry	کشور کاربر	دارایی‌های Google Analytics 360	کشور کاربر GA که به داده‌های گزارش GA دسترسی پیدا کرده است.
userCountryId	شناسه کشور کاربر	دارایی‌های Google Analytics 360	شناسه کشور کاربر GA که به داده‌های گزارش GA دسترسی داشته است. قالب‌بندی‌شده طبق استاندارد ISO 3166-1 alpha-2.
userEmail	ایمیل کاربر	همه دارایی‌های Google Analytics	ایمیل کاربر GA که به داده‌های گزارش‌دهی GA دسترسی داشته است. برخی‌از یکپارچه‌سازی‌ها به کاربران اجازه می‌دهند بدون اینکه دسترسی مستقیم به دارایی داشته باشند ازطریق یکپارچه‌سازی به داده‌های گزارش GA دسترسی پیدا کنند؛ در این حالت، بسته به یکپارچه‌سازی، «userEmail» برای مثال «کاربر پیوندشده Google Ads» را برمی‌گرداند.
userIP	پروتکل اینترنتی کاربر	دارایی‌های Google Analytics 360	نشانی IP کاربر GA که به داده‌های گزارش‌دهی GA دسترسی داشته است.

سنجه‌ها

سنجه‌های زیر را می‌توان در گزارش‌های دسترسی به داده‌ها درخواست کرد. «نام API» را در فیلد name سنجه منبع AccessMetric برای ستون سنجه در پاسخ گزارش مشخص کنید.

نام میانای برنامه‌سازی کاربردی	نام میانای کاربر	دارایی‌های مجاز	شرح
accessCount	تعداد دسترسی	دارایی‌های Google Analytics 360	تعداد دفعاتی که به داده‌های گزارش‌دهی GA دسترسی شده است. هنگام استفاده از «میانای کاربری Google Analytics»، هر کارت گزارش می‌تواند منجر به یک یا چند رویداد دسترسی به داده‌ها شود. درنتیجه، پیمایش در «میانای کاربری Google Analytics» می‌تواند منجر به رویدادهای دسترسی بیشتری نسبت‌به تعداد گزارش‌های مشاهده‌شده شود.
dataApiQuotaPropertyTokensConsumed	تعداد دارایی‌های سهمیه Data API مصرف‌شده	همه دارایی‌های Google Analytics	تعداد کل نشان‌های سهمیه دارایی مصرف‌شده برای درخواست‌های Data API را برمی‌گرداند.