گزارش محوری سفارشی دادههای رویداد Google Analytics شما را برمیگرداند. گزارشهای محوری، فرمتهای پیشرفتهتر و گویاتر از گزارشهای معمولی هستند. در گزارش محوری، ابعاد تنها در صورتی قابل مشاهده هستند که در یک محور قرار گیرند. برای تجزیه و تحلیل بیشتر دادههای شما، میتوان چند محور مشخص کرد.
درخواست HTTP
POST https://analyticsdata.googleapis.com/v1alpha:runPivotReport
URL از دستور GRPC Transcoding استفاده می کند.
درخواست بدن
بدنه درخواست حاوی داده هایی با ساختار زیر است:
نمایندگی JSON | |
---|---|
{ "entity": { object ( |
زمینه های | |
---|---|
entity | ملکی که وقایع آن پیگیری می شود. در یک درخواست دسته ای، این موجودیت باید یا نامشخص باشد یا با موجودیت در سطح دسته ای سازگار باشد. |
dimensions[] | ابعاد درخواستی همه ابعاد تعریف شده باید توسط یکی از موارد زیر استفاده شوند: dimensionExpression، dimensionFilter، pivots، orderBys. |
metrics[] | معیارهای درخواستی، حداقل یک معیار باید مشخص شود. همه معیارهای تعریف شده باید توسط یکی از موارد زیر استفاده شوند: metric_expression، metricFilter، orderBys. |
dimensionFilter | بند فیلتر ابعاد. برای استفاده در این فیلتر باید ابعاد درخواست شود. معیارها را نمی توان در این فیلتر استفاده کرد. |
metricFilter | بند فیلتر معیارها. در مرحله پس از تجمع، مشابه SQL دارای بند اعمال می شود. برای استفاده در این فیلتر باید معیارها را درخواست کرد. در این فیلتر نمی توان از ابعاد استفاده کرد. |
pivots[] | قالب بصری ابعاد گزارش را در ستون یا ردیف توضیح می دهد. اتحاد فیلدNames (نام ابعاد) در همه محورها باید زیرمجموعه ای از نام ابعاد تعریف شده در Dimensions باشد. هیچ دو محوری نمی تواند یک بعد را به اشتراک بگذارد. یک بعد فقط زمانی قابل مشاهده است که در یک محور ظاهر شود. |
dateRanges[] | محدوده تاریخ برای بازیابی اطلاعات رویداد برای گزارش. اگر چندین محدوده تاریخ مشخص شده باشد، داده های رویداد از هر محدوده تاریخ در گزارش استفاده می شود. یک بعد خاص با نام فیلد "DateRange" را می توان در نام فیلدهای Pivot گنجاند. اگر شامل شود، گزارش بین محدوده تاریخ مقایسه می شود. در یک درخواست گروهی، این |
currencyCode | یک کد ارز در قالب ISO4217، مانند "AED"، "USD"، "JPY". اگر فیلد خالی باشد، گزارش از واحد پول پیشفرض موجودیت استفاده میکند. |
cohortSpec | گروه کوهورت مرتبط با این درخواست. اگر یک گروه کوهورت در درخواست وجود دارد، بعد "همگروهی" باید وجود داشته باشد. |
keepEmptyRows | اگر نادرست یا نامشخص باشد، هر ردیف با تمام معیارهای برابر با 0 برگردانده نخواهد شد. اگر درست باشد، اگر این ردیفها بهطور جداگانه توسط فیلتر حذف نشوند، برگردانده میشوند. |
returnPropertyQuota | وضعیت فعلی سهمیه این Analytics Property را تغییر میدهد یا خیر. سهمیه در PropertyQuota برگردانده می شود. |
بدن پاسخگو
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی نمونه ای از RunPivotReportResponse
است.
محدوده مجوز
به یکی از حوزه های OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/analytics.readonly
-
https://www.googleapis.com/auth/analytics