- درخواست HTTP
- درخواست بدن
- بدن پاسخگو
- محدوده مجوز
- گزارش درخواست
- نمونه برداری
- بعد، ابعاد، اندازه
- DimensionFilterClause
- FilterLogicalOperator
- DimensionFilter
- اپراتور
- متریک
- نوع متریک
- MetricFilterClause
- فیلتر متریک
- اپراتور
- سفارش توسط
- نوع سفارش
- مرتب سازی
- بخش
- DynamicSegment
- تعریف بخش
- بخش فیلتر
- SimpleSegment
- OrFiltersForSegment
- SegmentFilterClause
- SegmentDimensionFilter
- اپراتور
- SegmentMetricFilter
- محدوده
- اپراتور
- SequenceSegment
- SegmentSequenceStep
- MatchType
- محوری
- گروه کوهورت
- گروه
- تایپ کنید
- گزارش
- ColumnHeader
- MetricHeader
- MetricHeaderEntry
- PivotHeader
- PivotHeaderEntry
- گزارش داده
- ReportRow
- DateRangeValues
- PivotValueRegion
- ResourceQuotasRemaining
- آن را امتحان کنید!
داده های Analytics را برمی گرداند.
درخواست HTTP
POST https://analyticsreporting.googleapis.com/v4/reports:batchGet
URL از دستور GRPC Transcoding استفاده می کند.
درخواست بدن
بدنه درخواست حاوی داده هایی با ساختار زیر است:
نمایندگی JSON | |
---|---|
{
"reportRequests": [
{
object( |
زمینه های | |
---|---|
reportRequests[] | درخواست ها، هر درخواست پاسخ جداگانه ای خواهد داشت. حداکثر 5 درخواست وجود دارد. همه درخواستها باید |
useResourceQuotas | سهمیههای مبتنی بر منابع را فعال میکند، (پیشفرض به |
بدن پاسخگو
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:
کلاس پاسخگویی اصلی که گزارش های مربوط به تماس batchGet
Reporting API را نگه می دارد.
نمایندگی JSON | |
---|---|
{ "reports": [ { object( |
زمینه های | |
---|---|
reports[] | پاسخ های مربوط به هر یک از درخواست ها. |
queryCost | مقدار توکن های سهمیه منابع کسر شده برای اجرای پرس و جو. شامل تمام پاسخ ها می شود. |
resourceQuotasRemaining | میزان سهمیه منابع باقی مانده برای ملک. |
محدوده مجوز
به یکی از حوزه های OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/analytics.readonly
-
https://www.googleapis.com/auth/analytics
گزارش درخواست
کلاس درخواست اصلی که درخواست Reporting API را مشخص می کند.
نمایندگی JSON | |
---|---|
{ "viewId": string, "dateRanges": [ { object( |
زمینه های | |
---|---|
viewId | شناسه نمای Analytics که از آن داده ها بازیابی می شود. هر ReportRequest در متد |
dateRanges[] | محدوده تاریخ در درخواست درخواست می تواند حداکثر 2 محدوده تاریخ داشته باشد. پاسخ شامل مجموعه ای از مقادیر متریک برای هر ترکیبی از ابعاد برای هر محدوده تاریخ در درخواست خواهد بود. بنابراین، اگر دو محدوده تاریخ وجود داشته باشد، دو مجموعه از مقادیر متریک وجود خواهد داشت، یکی برای محدوده تاریخ اصلی و دیگری برای محدوده تاریخ دوم. قسمت |
samplingLevel | حجم نمونه گزارش مورد نظر اگر قسمت |
dimensions[] | ابعاد درخواستی درخواست ها در مجموع می توانند 9 بعد داشته باشند. |
dimensionFilterClauses[] | بندهای فیلتر ابعاد برای فیلتر کردن مقادیر ابعاد. آنها به طور منطقی با عملگر |
metrics[] | معیارهای درخواستی درخواست ها باید حداقل یک معیار را مشخص کنند. درخواست ها در مجموع می توانند 10 معیار داشته باشند. |
metricFilterClauses[] | بندهای فیلتر متریک آنها به طور منطقی با عملگر |
filtersExpression | فیلترهای ابعاد یا متریک که داده های بازگردانده شده برای درخواست شما را محدود می کند. برای استفاده از |
orderBys[] | ترتیب مرتب سازی در ردیف های خروجی برای مقایسه دو سطر، عناصر زیر به ترتیب اعمال می شوند تا اختلاف پیدا شود. همه محدوده های تاریخ در خروجی ترتیب ردیف یکسانی دارند. |
segments[] | داده های بازگشتی برای درخواست را بخش بندی کنید. تعریف بخش به بررسی زیرمجموعه ای از درخواست بخش کمک می کند. یک درخواست می تواند تا چهار بخش داشته باشد. هر ReportRequest در متد |
pivots[] | تعاریف محوری درخواست ها می توانند حداکثر 2 محور داشته باشند. |
cohortGroup | گروه کوهورت مرتبط با این درخواست. اگر یک گروه کوهورت در درخواست وجود دارد، بعد |
pageToken | یک نشانه ادامه برای دریافت صفحه بعدی نتایج. با افزودن این مورد به درخواست، ردیفهای بعد از pageToken برمیگردد. pageToken باید مقداری باشد که در پارامتر nextPageToken در پاسخ به درخواست report.batchGet برگردانده شده است. |
pageSize | اندازه صفحه برای صفحه بندی است و حداکثر تعداد سطرهای برگشتی را مشخص می کند. اندازه صفحه باید >= 0 باشد. یک کوئری پیش فرض 1000 ردیف را برمی گرداند. Analytics Core Reporting API حداکثر 100000 ردیف را در هر درخواست برمی گرداند، مهم نیست که چقدر درخواست کنید. همچنین میتواند ردیفهای کمتری را نسبت به درخواستی بازگرداند، اگر بخشهای بعدی آنقدر که انتظار دارید وجود نداشته باشد. به عنوان مثال، کمتر از 300 مقدار ممکن برای |
includeEmptyRows | اگر روی نادرست تنظیم شود، اگر همه معیارهای بازیابی شده برابر با صفر باشند، پاسخ شامل ردیفها نمیشود. پیش فرض false است که این ردیف ها را حذف می کند. |
hideTotals | اگر روی درست تنظیم شود، مجموع تمام معیارها برای همه ردیفهای منطبق، برای هر محدوده تاریخ پنهان میشود. پیش فرض نادرست است و مجموع را برمی گرداند. |
hideValueRanges | اگر روی درست تنظیم شود، حداقل و حداکثر را در تمام ردیفهای منطبق پنهان میکند. پیش فرض نادرست است و محدوده های مقدار برگردانده می شوند. |
نمونه برداری
مقادیر برای سطح نمونه گیری
Enums | |
---|---|
SAMPLING_UNSPECIFIED | اگر فیلد samplingLevel نامشخص باشد، از سطح نمونهگیری DEFAULT استفاده میشود. |
DEFAULT | پاسخ را با اندازه نمونه برمیگرداند که سرعت و دقت را متعادل میکند. |
SMALL | پاسخ سریع با حجم نمونه کوچکتر را برمی گرداند. |
LARGE | با استفاده از اندازه نمونه بزرگ، پاسخ دقیق تری را برمی گرداند. اما این ممکن است منجر به کندتر شدن پاسخ شود. |
بعد، ابعاد، اندازه
ابعاد ویژگی های داده های شما هستند. به عنوان مثال، بعد ga:city
شهر را نشان می دهد، به عنوان مثال، "پاریس" یا "نیویورک"، که یک جلسه از آن شروع می شود.
نمایندگی JSON | |
---|---|
{ "name": string, "histogramBuckets": [ string ] } |
زمینه های | |
---|---|
name | نام بعد برای واکشی، به عنوان مثال |
histogramBuckets[] | اگر خالی نباشد، مقادیر ابعاد را بعد از رشته تا int64 در سطل ها قرار می دهیم. مقادیر ابعادی که نمایش رشته ای از یک مقدار انتگرال نیستند به صفر تبدیل می شوند. مقادیر سطل باید به ترتیب افزایشی باشند. هر سطل در انتهای پایین بسته و در انتهای بالایی باز است. سطل "اولین" شامل تمام مقادیر کمتر از مرز اول است، سطل "آخرین" شامل تمام مقادیر تا بی نهایت است. مقادیر ابعادی که در یک سطل قرار می گیرند به یک مقدار ابعاد جدید تبدیل می شوند. به عنوان مثال، اگر کسی لیستی از "0، 1، 3، 4، 7" ارائه دهد، سطل های زیر را برمی گردانیم:
توجه: اگر جهش هیستوگرام را روی هر بعد اعمال میکنید و از آن بعد به صورت مرتب استفاده میکنید، میخواهید از نوع مرتبسازی "<50"، "1001+"، "121-1000"، "50-120" و ترتیب صعودی "<50"، "50-120"، "121-1000"، "1001+" مشتری باید صریحاً |
DimensionFilterClause
گروهی از فیلترهای ابعادی مقدار عملگر را برای تعیین نحوه ترکیب منطقی فیلترها تنظیم کنید.
نمایندگی JSON | |
---|---|
{ "operator": enum( |
زمینه های | |
---|---|
operator | عملگر برای ترکیب فیلترهای چند بعدی. اگر مشخص نباشد، به عنوان یک |
filters[] | مجموعه مکرر فیلترها. آنها به طور منطقی بر اساس عملگر مشخص شده ترکیب می شوند. |
FilterLogicalOperator
نحوه ترکیب منطقی فیلترها
Enums | |
---|---|
OPERATOR_UNSPECIFIED | اپراتور نامشخص به عنوان یک OR در نظر گرفته می شود. |
OR | عملگر منطقی OR . |
AND | عملگر AND منطقی. |
DimensionFilter
Dimension filter گزینه های فیلتر را روی یک بعد مشخص می کند.
نمایندگی JSON | |
---|---|
{
"dimensionName": string,
"not": boolean,
"operator": enum( |
زمینه های | |
---|---|
dimensionName | بعد برای فیلتر کردن DimensionFilter باید دارای یک بعد باشد. |
not | عملگر منطقی |
operator | نحوه تطبیق بعد با عبارت پیش فرض REGEXP است. |
expressions[] | رشته ها یا عبارت منظم برای مطابقت با. فقط اولین مقدار لیست برای مقایسه استفاده می شود مگر اینکه عملگر |
caseSensitive | آیا مسابقه باید به حروف کوچک و بزرگ حساس باشد؟ پیش فرض نادرست است. |
اپراتور
انواع بازی های مختلف پشتیبانی می شود.
Enums | |
---|---|
OPERATOR_UNSPECIFIED | اگر نوع مطابقت مشخص نشده باشد، به عنوان یک REGEXP در نظر گرفته می شود. |
REGEXP | عبارت مطابقت به عنوان یک عبارت منظم در نظر گرفته می شود. همه انواع تطابق به عنوان عبارات منظم در نظر گرفته نمی شوند. |
BEGINS_WITH | با مقداری مطابقت دارد که با عبارت مطابقت ارائه شده شروع می شود. |
ENDS_WITH | مقادیری را که با عبارت تطبیق ارائه شده به پایان می رسد مطابقت می دهد. |
PARTIAL | مطابقت رشته فرعی |
EXACT | مقدار باید کاملاً با عبارت مطابقت مطابقت داشته باشد. |
NUMERIC_EQUAL | فیلترهای مقایسه اعداد صحیح حساسیت حروف کوچک برای این موارد نادیده گرفته می شود و عبارت به عنوان رشته ای است که یک عدد صحیح را نشان می دهد. شرایط شکست:
|
NUMERIC_GREATER_THAN | بررسی می کند که آیا بعد از نظر عددی بزرگتر از عبارت مطابقت است یا خیر. توضیحات NUMERIC_EQUALS را برای محدودیت بخوانید. |
NUMERIC_LESS_THAN | بررسی می کند که آیا بعد از نظر عددی کمتر از عبارت مطابقت است یا خیر. توضیحات NUMERIC_EQUALS را برای محدودیت بخوانید. |
IN_LIST | این گزینه برای تعیین فیلتر ابعادی استفاده می شود که عبارت آن می تواند هر مقداری را از لیست انتخاب شده از مقادیر بگیرد. این کمک می کند تا از ارزیابی چندین فیلتر ابعاد تطابق دقیق که برای هر سطر پاسخ OR'd شده اند جلوگیری شود. مثلا:
هر ردیف پاسخی که بعد آن دارای مقدار A، B یا C باشد، با این DimensionFilter مطابقت دارد. |
متریک
متریک ها اندازه گیری های کمی هستند. به عنوان مثال، متریک ga:users
تعداد کل کاربران را برای دوره زمانی درخواستی نشان می دهد.
نمایندگی JSON | |
---|---|
{
"expression": string,
"alias": string,
"formattingType": enum( |
زمینه های | |
---|---|
expression | یک عبارت متریک در درخواست. یک عبارت از یک یا چند متریک و اعداد ساخته می شود. عملگرهای پذیرفته شده عبارتند از: به علاوه (+)، منهای (-)، نفی (یکی -)، تقسیم بر (/)، ضرب در (*)، پرانتز، اعداد اصلی مثبت (0-9)، می تواند شامل اعشار باشد و محدود به 1024 کاراکتر. مثال |
alias | نام مستعار برای عبارت متریک یک نام جایگزین برای عبارت است. نام مستعار را می توان برای فیلتر کردن و مرتب سازی استفاده کرد. این فیلد اختیاری است و در صورتی مفید است که عبارت یک متریک واحد نباشد بلکه یک عبارت پیچیده باشد که در فیلتر کردن و مرتبسازی قابل استفاده نباشد. نام مستعار نیز در سربرگ ستون پاسخ استفاده می شود. |
formattingType | نحوه قالب بندی عبارت متریک را مشخص می کند، برای مثال |
نوع متریک
انواع معیارها
Enums | |
---|---|
METRIC_TYPE_UNSPECIFIED | نوع متریک مشخص نشده است. |
INTEGER | متریک عدد صحیح |
FLOAT | متریک شناور. |
CURRENCY | متریک ارز. |
PERCENT | متریک درصد |
TIME | متریک زمان در قالب HH:MM:SS . |
MetricFilterClause
نشان دهنده گروهی از فیلترهای متریک است. مقدار عملگر را برای تعیین نحوه ترکیب منطقی فیلترها تنظیم کنید.
نمایندگی JSON | |
---|---|
{ "operator": enum( |
زمینه های | |
---|---|
operator | عملگر برای ترکیب چند فیلتر متریک. اگر مشخص نباشد، به عنوان یک |
filters[] | مجموعه مکرر فیلترها. آنها به طور منطقی بر اساس عملگر مشخص شده ترکیب می شوند. |
فیلتر متریک
MetricFilter فیلتر را روی یک متریک مشخص می کند.
نمایندگی JSON | |
---|---|
{
"metricName": string,
"not": boolean,
"operator": enum( |
زمینه های | |
---|---|
metricName | معیاری که روی آن فیلتر خواهد شد. MetricFilter باید دارای یک نام متریک باشد. نام متریک می تواند نام مستعاری باشد که قبلاً به عنوان متریک تعریف شده بود یا همچنین می تواند یک عبارت متریک باشد. |
not | عملگر منطقی |
operator | آیا متریک |
comparisonValue | ارزشی که باید با آن مقایسه کرد. |
اپراتور
گزینه های مختلف نوع مقایسه
Enums | |
---|---|
OPERATOR_UNSPECIFIED | اگر اپراتور مشخص نشده باشد، به عنوان EQUAL تلقی می شود. |
EQUAL | آیا مقدار متریک باید دقیقاً برابر با مقدار مقایسه باشد. |
LESS_THAN | آیا مقدار متریک باید کمتر از مقدار مقایسه باشد. |
GREATER_THAN | آیا مقدار متریک باید بیشتر از مقدار مقایسه باشد. |
IS_MISSING | در صورت عدم وجود معیار، اعتبارسنجی میشود. ارزش مقایسه را در نظر نمی گیرد. |
سفارش توسط
گزینه های مرتب سازی را مشخص می کند.
نمایندگی JSON | |
---|---|
{ "fieldName": string, "orderType": enum( |
زمینه های | |
---|---|
fieldName | فیلدی که بر اساس آن مرتب می شود. ترتیب مرتب سازی پیش فرض صعودی است. مثال: |
orderType | نوع سفارش orderType پیشفرض |
sortOrder | ترتیب مرتب سازی برای فیلد. |
نوع سفارش
OrderType نحوه تعیین ترتیب مرتب سازی را کنترل می کند.
Enums | |
---|---|
ORDER_TYPE_UNSPECIFIED | نوع سفارش نامشخص به عنوان مرتب سازی بر اساس مقدار تلقی می شود. |
VALUE | ترتیب مرتب سازی بر اساس مقدار ستون انتخاب شده است. فقط به اولین محدوده تاریخ نگاه می کند. |
DELTA | ترتیب مرتب سازی بر اساس تفاوت مقادیر ستون انتخابی بین دو محدوده تاریخ اول است. فقط در صورتی قابل استفاده است که دقیقاً دو محدوده تاریخ وجود داشته باشد. |
SMART | ترتیب مرتب سازی بر اساس مقدار وزنی ستون انتخابی است. اگر ستون دارای قالب n/d باشد، مقدار وزنی این نسبت (n + totals.n)/(d + totals.d) خواهد بود. فقط برای معیارهایی که نشان دهنده نسبت هستند قابل استفاده است. |
HISTOGRAM_BUCKET | نوع ترتیب هیستوگرام فقط برای ستون های ابعادی با سطل های هیستوگرام خالی قابل استفاده است. |
DIMENSION_AS_INTEGER | اگر ابعاد اعداد طول ثابت باشند، مرتب سازی معمولی به خوبی کار می کند. DIMENSION_AS_INTEGER می تواند استفاده شود اگر ابعاد اعداد طول متغیر باشند. |
مرتب سازی
ترتیب مرتب سازی مرتب سازی.
Enums | |
---|---|
SORT_ORDER_UNSPECIFIED | اگر ترتیب مرتب سازی مشخص نشده باشد، پیش فرض صعودی است. |
ASCENDING | مرتب سازی صعودی فیلد به صورت صعودی مرتب می شود. |
DESCENDING | مرتب سازی نزولی فیلد به صورت نزولی مرتب خواهد شد. |
بخش
تعریف بخش، اگر گزارش نیاز به تقسیم بندی داشته باشد. Segment زیرمجموعه ای از داده های Analytics است. برای مثال، از کل مجموعه کاربران، یک بخش ممکن است کاربران یک کشور یا شهر خاص باشد.
نمایندگی JSON | |
---|---|
{ // Union field |
زمینه های | ||
---|---|---|
فیلد اتحادیه dynamicOrById . بخش را می توان به صورت پویا با استفاده از DynamicSegment یا با استفاده از شناسه یک بخش داخلی یا سفارشی تعریف کرد. dynamicOrById می تواند تنها یکی از موارد زیر باشد: | ||
dynamicSegment | تعریف بخش پویا در درخواست. | |
segmentId | شناسه بخش یک بخش داخلی یا سفارشی، به عنوان مثال |
DynamicSegment
تعریف بخش پویا برای تعریف بخش در درخواست. یک بخش می تواند کاربران، جلسات یا هر دو را انتخاب کند.
نمایندگی JSON | |
---|---|
{ "name": string, "userSegment": { object( |
زمینه های | |
---|---|
name | نام بخش پویا. |
userSegment | بخش کاربر برای انتخاب کاربران برای درج در بخش. |
sessionSegment | Session Segment برای انتخاب جلسات برای درج در بخش. |
تعریف بخش
SegmentDefinition بخش را به عنوان مجموعه ای از SegmentFilters تعریف می کند که با یک عملیات AND
منطقی ترکیب می شوند.
نمایندگی JSON | |
---|---|
{
"segmentFilters": [
{
object( |
زمینه های | |
---|---|
segmentFilters[] | یک بخش با مجموعه ای از فیلترهای قطعه تعریف می شود که با یک عملیات |
بخش فیلتر
SegmentFilter بخش را به صورت ساده یا یک قطعه دنباله ای تعریف می کند. یک شرط بخش ساده شامل شرایط ابعاد و متریک برای انتخاب جلسات یا کاربران است. یک شرط قطعه توالی می تواند برای انتخاب کاربران یا جلسات بر اساس شرایط متوالی استفاده شود.
نمایندگی JSON | |
---|---|
{ "not": boolean, // Union field |
زمینه های | ||
---|---|---|
not | اگر درست است، مکمل بخش ساده یا دنباله را مطابقت دهید. به عنوان مثال، برای مطابقت با تمام بازدیدهایی که از "نیویورک" نیستند، می توانیم بخش را به صورت زیر تعریف کنیم:
| |
فیلد اتحادیه simpleOrSequence . آیا این یک قطعه ساده است یا یک تعریف قطعه دنباله ای. simpleOrSequence تنها می تواند یکی از موارد زیر باشد: | ||
simpleSegment | شرایط بخش ساده شامل یک یا چند شرط بعد/متریک است که میتوانند با هم ترکیب شوند | |
sequenceSegment | شرایط توالی شامل یک یا چند مرحله است که هر مرحله با یک یا چند بعد/شرایط متریک تعریف می شود. چند مرحله را می توان با عملگرهای توالی خاص ترکیب کرد. |
SimpleSegment
شرایط بخش ساده شامل یک یا چند شرط بعد/متریک است که میتوانند با هم ترکیب شوند.
نمایندگی JSON | |
---|---|
{
"orFiltersForSegment": [
{
object( |
زمینه های | |
---|---|
orFiltersForSegment[] | لیستی از گروه های فیلتر بخش که با عملگر |
OrFiltersForSegment
لیستی از فیلترهای بخش در گروه OR
با عملگر منطقی OR ترکیب می شوند.
نمایندگی JSON | |
---|---|
{
"segmentFilterClauses": [
{
object( |
زمینه های | |
---|---|
segmentFilterClauses[] | لیست فیلترهای بخش که باید با یک عملگر |
SegmentFilterClause
بند فیلتر که در تعریف بخش استفاده می شود، می تواند یک فیلتر متریک یا یک فیلتر ابعادی باشد.
نمایندگی JSON | |
---|---|
{ "not": boolean, // Union field |
زمینه های | ||
---|---|---|
not | با مکمل ( | |
dimensionOrMetricFilter فیلد اتحادیهOrMetricFilter. ابعاد یا فیلتر متریک. dimensionOrMetricFilter تنها می تواند یکی از موارد زیر باشد: | ||
dimensionFilter | فیلتر ابعاد برای تعریف بخش. | |
metricFilter | فیلتر متریک برای تعریف بخش. |
SegmentDimensionFilter
Dimension filter گزینه های فیلتر را روی یک بعد مشخص می کند.
نمایندگی JSON | |
---|---|
{
"dimensionName": string,
"operator": enum( |
زمینه های | |
---|---|
dimensionName | نام ابعادی که فیلتر برای آن اعمال می شود. |
operator | عملگر مورد استفاده برای تطبیق بعد با عبارات. |
caseSensitive | اگر مطابقت به حروف کوچک و بزرگ حساس باشد، برای اپراتور |
expressions[] | لیست عبارات، تنها عنصر اول برای همه عملگرها استفاده می شود |
minComparisonValue | حداقل مقادیر مقایسه برای نوع مطابقت |
maxComparisonValue | حداکثر مقادیر مقایسه برای نوع مطابقت |
اپراتور
انواع بازی های مختلف پشتیبانی می شود.
Enums | |
---|---|
OPERATOR_UNSPECIFIED | اگر نوع مطابقت نامشخص باشد، به عنوان یک REGEXP در نظر گرفته می شود. |
REGEXP | عبارت مطابقت به عنوان یک عبارت منظم در نظر گرفته می شود. همه انواع تطابق دیگر به عنوان عبارات منظم تلقی نمی شوند. |
BEGINS_WITH | مقادیری را که با عبارت تطبیق ارائه شده شروع می شوند مطابقت می دهد. |
ENDS_WITH | مقادیری را که با عبارت تطبیق ارائه شده به پایان می رسد مطابقت می دهد. |
PARTIAL | مطابقت رشته فرعی |
EXACT | مقدار باید کاملاً با عبارت مطابقت مطابقت داشته باشد. |
IN_LIST | این گزینه برای تعیین فیلتر ابعادی استفاده می شود که عبارت آن می تواند هر مقداری را از لیست انتخاب شده از مقادیر بگیرد. این کمک می کند تا از ارزیابی چندین فیلتر ابعاد تطابق دقیق که برای هر سطر پاسخ OR'd شده اند جلوگیری شود. مثلا:
هر ردیف پاسخی که بعد آن دارای مقدار A، B یا C باشد، با این DimensionFilter مطابقت دارد. |
NUMERIC_LESS_THAN | فیلترهای مقایسه اعداد صحیح حساسیت حروف کوچک برای این موارد نادیده گرفته می شود و عبارت به عنوان رشته ای است که یک عدد صحیح را نشان می دهد. شرایط شکست:
بررسی می کند که آیا بعد از نظر عددی کمتر از عبارت مطابقت است یا خیر. |
NUMERIC_GREATER_THAN | بررسی می کند که آیا بعد از نظر عددی بزرگتر از عبارت مطابقت است یا خیر. |
NUMERIC_BETWEEN | بررسی میکند که آیا بعد از نظر عددی بین حداقل و حداکثر عبارت تطبیق است، مرزها حذف میشوند. |
SegmentMetricFilter
فیلتر متریک برای استفاده در بند فیلتر بخش.
نمایندگی JSON | |
---|---|
{ "scope": enum( |
زمینه های | |
---|---|
scope | محدوده برای یک متریک سطحی را که آن متریک در آن تعریف می شود، مشخص می کند. محدوده متریک مشخص شده باید برابر یا بزرگتر از محدوده اصلی آن باشد که در مدل داده تعریف شده است. محدوده اولیه با این تعریف می شود که آیا بخش در حال انتخاب کاربران یا جلسات باشد. |
metricName | معیاری که روی آن فیلتر خواهد شد. |
operator | Specifyes عملیاتی است که برای مقایسه متریک باید انجام شود. پیش فرض |
comparisonValue | ارزشی که باید با آن مقایسه کرد. اگر عملگر |
maxComparisonValue | حداکثر مقدار مقایسه فقط برای عملگر |
محدوده
یک محدوده برای یک متریک سطحی را که آن معیار در آن تعریف شده است - PRODUCT
، HIT
، SESSION
، یا USER
را مشخص می کند. مقادیر متریک را میتوان در محدودههای بزرگتر از محدوده اصلی آن نیز گزارش کرد. به عنوان مثال، ga:pageviews
و ga:transactions
می توان در سطح SESSION
و USER
فقط با جمع کردن آنها برای هر بازدیدی که در آن جلسات یا برای آن کاربران رخ می دهد، گزارش کرد.
Enums | |
---|---|
UNSPECIFIED_SCOPE | اگر scope مشخص نشده باشد، بسته به اینکه آیا بخش سعی میکند کاربران یا جلسات را انتخاب کند، بهطور پیشفرض روی محدوده شرط، USER یا SESSION تنظیم میشود. |
PRODUCT | محدوده محصول. |
HIT | دامنه ضربه. |
SESSION | محدوده جلسه |
USER | محدوده کاربری |
اپراتور
گزینه های مختلف نوع مقایسه
Enums | |
---|---|
UNSPECIFIED_OPERATOR | عملگر نامشخص به عنوان عملگر LESS_THAN در نظر گرفته می شود. |
LESS_THAN | بررسی می کند که آیا مقدار متریک کمتر از مقدار مقایسه است. |
GREATER_THAN | بررسی می کند که آیا مقدار متریک بیشتر از مقدار مقایسه است. |
EQUAL | برابر با اپراتور |
BETWEEN | برای بین اپراتور، هر دو حداقل و حداکثر منحصر به فرد هستند. برای مقایسه LT و GT استفاده خواهیم کرد. |
SequenceSegment
شرایط توالی شامل یک یا چند مرحله است که هر مرحله با یک یا چند بعد/شرایط متریک تعریف می شود. چند مرحله را می توان با عملگرهای توالی خاص ترکیب کرد.
نمایندگی JSON | |
---|---|
{
"segmentSequenceSteps": [
{
object( |
زمینه های | |
---|---|
segmentSequenceSteps[] | لیست مراحل در دنباله. |
firstStepShouldMatchFirstHit | در صورت تنظیم، شرط مرحله اول باید با اولین ضربه بازدیدکننده (در محدوده تاریخ) مطابقت داشته باشد. |
SegmentSequenceStep
تعریف دنباله قطعه
نمایندگی JSON | |
---|---|
{ "orFiltersForSegment": [ { object( |
زمینه های | |
---|---|
orFiltersForSegment[] | یک دنباله با لیستی از فیلترهای گروه بندی شده یا ترکیب شده با عملگر |
matchType | مشخص می کند که آیا مرحله بلافاصله قبل از مرحله بعدی است یا می تواند هر زمانی قبل از مرحله بعدی باشد. |
MatchType
نوع تطبیق برای دنباله.
Enums | |
---|---|
UNSPECIFIED_MATCH_TYPE | نوع تطابق نامشخص به عنوان موارد قبلی در نظر گرفته می شود. |
PRECEDES | عملگر نشان می دهد که مرحله قبل قبل از مرحله بعدی است. |
IMMEDIATELY_PRECEDES | اپراتور نشان می دهد که مرحله قبل بلافاصله قبل از مرحله بعدی است. |
محوری
Pivot بخش محوری در درخواست را توصیف می کند. Pivot به تنظیم مجدد اطلاعات در جدول برای گزارش های خاص با چرخش داده های شما در بعد دوم کمک می کند.
نمایندگی JSON | |
---|---|
{ "dimensions": [ { object( |
زمینه های | |
---|---|
dimensions[] | فهرستی از ابعاد برای نمایش به عنوان ستون محوری. یک Pivot می تواند حداکثر 4 بعد داشته باشد. ابعاد محوری بخشی از محدودیت در تعداد کل ابعاد مجاز در درخواست است. |
dimensionFilterClauses[] | DimensionFilterClauses به طور منطقی با یک عملگر |
metrics[] | معیارهای محوری معیارهای محوری بخشی از محدودیت تعداد کل معیارهای مجاز در درخواست هستند. |
startGroup | اگر k معیار درخواست شده باشد، آنگاه پاسخ حاوی چند ضرب وابسته به داده از k ستون در گزارش خواهد بود. به عنوان مثال، اگر شما بر روی بعد موارد زیر به شما امکان می دهد انتخاب کنید کدام یک از گروه های k ستون در پاسخ گنجانده شود. |
maxGroupCount | حداکثر تعداد گروه ها را برای بازگشت مشخص می کند. مقدار پیش فرض 10 است، همچنین مقدار حداکثر 1000 است. |
گروه کوهورت
یک گروه کوهورت را تعریف می کند. مثلا:
"cohortGroup": {
"cohorts": [{
"name": "cohort 1",
"type": "FIRST_VISIT_DATE",
"dateRange": { "startDate": "2015-08-01", "endDate": "2015-08-01" }
},{
"name": "cohort 2"
"type": "FIRST_VISIT_DATE"
"dateRange": { "startDate": "2015-07-01", "endDate": "2015-07-01" }
}]
}
نمایندگی JSON | |
---|---|
{
"cohorts": [
{
object( |
زمینه های | |
---|---|
cohorts[] | تعریف برای گروه |
lifetimeValue | مقدار عمر زمان (LTV) را فعال کنید. LTV ارزش طول عمر کاربرانی را که از طریق کانال های مختلف به دست می آورند اندازه گیری می کند. لطفاً نگاه کنید به: تجزیه و تحلیل کوهورت و ارزش طول عمر اگر مقدار lifetimeValue نادرست است:
وقتی lifetimeValue درست است:
|
گروه
یک گروه را تعریف می کند. همگروهی گروهی از کاربران است که یک ویژگی مشترک دارند. به عنوان مثال، همه کاربران با تاریخ جذب یکسان به یک گروه تعلق دارند.
نمایندگی JSON | |
---|---|
{ "name": string, "type": enum( |
زمینه های | |
---|---|
name | یک نام منحصر به فرد برای گروه اگر نام تعریف نشده باشد به صورت خودکار با مقادیر cohort_[1234...] تولید می شود. |
type | نوع گروه تنها نوع پشتیبانی شده در حال حاضر |
dateRange | این برای گروه |
تایپ کنید
نوع کوهورت.
Enums | |
---|---|
UNSPECIFIED_COHORT_TYPE | اگر مشخص نشده باشد به عنوان FIRST_VISIT_DATE در نظر گرفته می شود. |
FIRST_VISIT_DATE | گروه هایی که بر اساس تاریخ اولین بازدید انتخاب می شوند. |
گزارش
پاسخ داده مربوط به درخواست.
نمایندگی JSON | |
---|---|
{ "columnHeader": { object( |
زمینه های | |
---|---|
columnHeader | سرصفحه های ستون. |
data | داده های پاسخ |
nextPageToken | نشانه صفحه برای بازیابی صفحه بعدی نتایج در لیست. |
ColumnHeader
سرصفحه های ستون.
نمایندگی JSON | |
---|---|
{
"dimensions": [
string
],
"metricHeader": {
object( |
زمینه های | |
---|---|
dimensions[] | نام ابعاد در پاسخ. |
metricHeader | سرصفحه های متریک برای معیارهای موجود در پاسخ. |
MetricHeader
سرصفحه های معیارها.
نمایندگی JSON | |
---|---|
{ "metricHeaderEntries": [ { object( |
زمینه های | |
---|---|
metricHeaderEntries[] | سرصفحه های معیارهای موجود در پاسخ. |
pivotHeaders[] | سرصفحه های محوری در پاسخ. |
MetricHeaderEntry
سربرگ برای معیارها.
نمایندگی JSON | |
---|---|
{
"name": string,
"type": enum( |
زمینه های | |
---|---|
name | نام سربرگ. |
type | نوع متریک، برای مثال |
PivotHeader
سرصفحه های هر یک از بخش های محوری تعریف شده در درخواست.
نمایندگی JSON | |
---|---|
{
"pivotHeaderEntries": [
{
object( |
زمینه های | |
---|---|
pivotHeaderEntries[] | سرصفحه بخش محوری واحد. |
totalPivotGroupsCount | تعداد کل گروهها برای این محور. |
PivotHeaderEntry
سرصفحه های هر یک از ستون های متریک مربوط به معیارهای درخواست شده در بخش محوری پاسخ.
نمایندگی JSON | |
---|---|
{
"dimensionNames": [
string
],
"dimensionValues": [
string
],
"metric": {
object( |
زمینه های | |
---|---|
dimensionNames[] | نام ابعاد در پاسخ محوری. |
dimensionValues[] | مقادیر برای ابعاد در محور. |
metric | هدر متریک برای متریک در محور. |
گزارش داده
بخش داده گزارش
نمایندگی JSON | |
---|---|
{ "rows": [ { object( |
زمینه های | |
---|---|
rows[] | برای هر ترکیب منحصر به فرد ابعاد، یک ReportRow وجود دارد. |
totals[] | برای هر محدوده تاریخ درخواستی، برای مجموعه تمام ردیف هایی که با پرس و جو مطابقت دارند، هر قالب مقدار درخواستی یک مجموع دریافت می کند. مجموع برای یک قالب ارزش ابتدا با مجموع معیارهای ذکر شده در قالب ارزش و سپس ارزیابی قالب ارزش به عنوان یک عبارت اسکالر محاسبه می شود. به عنوان مثال، "مجموع" برای |
rowCount | تعداد کل ردیف های منطبق برای این پرس و جو. |
minimums[] | حداقل و حداکثر مقادیر در تمام ردیفهای منطبق مشاهده میشود. وقتی |
maximums[] | حداقل و حداکثر مقادیر در تمام ردیفهای منطبق مشاهده میشود. وقتی |
samplesReadCounts[] | اگر از نتایج نمونه برداری شود، تعداد کل نمونه های خوانده شده، یک ورودی در هر محدوده تاریخ را برمی گرداند. اگر از نتایج نمونه برداری نشود، این فیلد تعریف نمی شود. برای جزئیات بیشتر به راهنمای توسعه دهنده مراجعه کنید. |
samplingSpaceSizes[] | اگر از نتایج نمونه برداری شود، تعداد کل نمونه های موجود، یک ورودی در هر محدوده تاریخ را برمی گرداند. اگر از نتایج نمونه برداری نشود، این فیلد تعریف نمی شود. برای جزئیات بیشتر به راهنمای توسعه دهنده مراجعه کنید. |
isDataGolden | نشان می دهد که آیا پاسخ به این درخواست طلایی است یا خیر. دادهها زمانی طلایی میشوند که دقیقاً همان درخواست، در صورت درخواست در زمان بعدی، هیچ نتیجه جدیدی ایجاد نمیکند. |
dataLastRefreshed | آخرین باری که داده های گزارش به روز شد. تمام بازدیدهای دریافت شده قبل از این مهر زمانی در محاسبه گزارش لحاظ می شود. یک مهر زمانی در قالب RFC3339 UTC "Zulu"، با دقت نانوثانیه. مثال: |
ReportRow
یک ردیف در گزارش
نمایندگی JSON | |
---|---|
{
"dimensions": [
string
],
"metrics": [
{
object( |
زمینه های | |
---|---|
dimensions[] | لیست ابعاد درخواستی |
metrics[] | فهرست سنجهها برای هر محدوده تاریخ درخواستی. |
DateRangeValues
برای برگرداندن فهرستی از معیارها برای یک ترکیب DateRange / بعد استفاده می شود
نمایندگی JSON | |
---|---|
{
"values": [
string
],
"pivotValueRegions": [
{
object( |
زمینه های | |
---|---|
values[] | هر مقدار مربوط به هر متریک در درخواست است. |
pivotValueRegions[] | مقادیر هر ناحیه محوری |
PivotValueRegion
مقادیر متریک در ناحیه محوری.
نمایندگی JSON | |
---|---|
{ "values": [ string ] } |
زمینه های | |
---|---|
values[] | مقادیر معیارها در هر یک از مناطق محوری. |
ResourceQuotasRemaining
توکن های سهمیه منابع باقی مانده برای ملک پس از تکمیل درخواست.
نمایندگی JSON | |
---|---|
{ "dailyQuotaTokensRemaining": number, "hourlyQuotaTokensRemaining": number } |
زمینه های | |
---|---|
dailyQuotaTokensRemaining | سهمیه منابع روزانه باقی مانده است. |
hourlyQuotaTokensRemaining | نمادهای سهمیه منابع ساعتی باقی مانده است. |