Method: properties.runFunnelReport

گزارش قیف سفارشی داده‌های رویداد Google Analytics شما را برمی‌گرداند. داده های برگردانده شده از API به صورت جدولی با ستون هایی برای ابعاد و معیارهای درخواستی است.

کاوش قیف به شما این امکان را می‌دهد تا مراحلی را که کاربران برای تکمیل یک کار برمی‌دارند تجسم کنید و به سرعت ببینید که در هر مرحله چقدر موفق یا شکست می‌خورند. به عنوان مثال، چگونه مشتریان بالقوه خریدار و سپس خریدار می شوند؟ چگونه خریداران یکباره تبدیل به خریداران تکراری می شوند؟ با این اطلاعات، می توانید سفرهای ناکارآمد یا رها شده مشتریان را بهبود ببخشید. برای کسب اطلاعات بیشتر، به کاوش‌های قیف GA4 مراجعه کنید.

این روش در ثبات آلفا با هدف جمع‌آوری بازخورد در نحو و قابلیت‌ها قبل از ورود به بتا معرفی شده است. برای ارائه بازخورد خود در مورد این API، بازخورد گزارش قیف Google Analytics Data API را تکمیل کنید.

درخواست HTTP

POST https://analyticsdata.googleapis.com/v1alpha/{property=properties/*}:runFunnelReport

URL از دستور GRPC Transcoding استفاده می کند.

پارامترهای مسیر

مولفه های
property

string

اختیاری. شناسه دارایی Google Analytics GA4 که رویدادهای آن ردیابی می شوند. در مسیر URL و نه بدنه مشخص شده است. برای کسب اطلاعات بیشتر، ببینید شناسه ملک خود را از کجا پیدا کنید . در یک درخواست دسته ای، این ویژگی یا باید نامشخص باشد یا با ویژگی سطح دسته ای سازگار باشد.

مثال: خواص/1234

درخواست بدن

بدنه درخواست حاوی داده هایی با ساختار زیر است:

نمایندگی JSON
{
  "dateRanges": [
    {
      object (DateRange)
    }
  ],
  "funnel": {
    object (Funnel)
  },
  "funnelBreakdown": {
    object (FunnelBreakdown)
  },
  "funnelNextAction": {
    object (FunnelNextAction)
  },
  "funnelVisualizationType": enum (FunnelVisualizationType),
  "segments": [
    {
      object (Segment)
    }
  ],
  "limit": string,
  "dimensionFilter": {
    object (FilterExpression)
  },
  "returnPropertyQuota": boolean
}
زمینه های
dateRanges[]

object ( DateRange )

اختیاری. محدوده تاریخ داده برای خواندن. اگر چندین محدوده تاریخ درخواست شود، هر ردیف پاسخ حاوی یک شاخص محدوده تاریخ مبتنی بر صفر خواهد بود. اگر دو محدوده تاریخ همپوشانی داشته باشند، داده‌های رویداد برای روزهای همپوشانی در ردیف‌های پاسخ برای هر دو محدوده تاریخ گنجانده می‌شود.

funnel

object ( Funnel )

اختیاری. پیکربندی قیف این درخواست. این پیکربندی قیف مورد نیاز است.

funnelBreakdown

object ( FunnelBreakdown )

اختیاری. اگر مشخص شده باشد، این تفکیک بعد به پاسخ گزارش فرعی جدول قیف اضافه می کند. این بعد تجزیه هر مرحله قیف را به مقادیر منحصر به فرد بعد شکست گسترش می دهد. برای مثال، تفکیک بر اساس بعد deviceCategory ردیف‌هایی را برای mobile ، tablet ، desktop و کل ایجاد می‌کند.

funnelNextAction

object ( FunnelNextAction )

اختیاری. در صورت مشخص شدن، اقدام بعدی یک بعد به پاسخ گزارش فرعی تجسم قیف اضافه می کند. این بعد اقدام بعدی هر مرحله قیف را به مقادیر منحصر به فرد اقدام بعدی گسترش می دهد. به عنوان مثال، اقدام بعدی بعد eventName ، ردیف‌هایی را برای چندین رویداد (مثلا session_start و click ) و کل ایجاد می‌کند.

اقدام بعدی فقط eventName و بیشتر ابعاد صفحه/صفحه مانند pageTitle و pagePath را پشتیبانی می‌کند.

funnelVisualizationType

enum ( FunnelVisualizationType )

اختیاری. نوع تجسم قیف ابعاد موجود در پاسخ گزارش فرعی تجسم قیف را کنترل می کند. اگر مشخص نشده باشد، STANDARD_FUNNEL استفاده می شود.

segments[]

object ( Segment )

اختیاری. تنظیمات بخش ها بخش‌ها زیرمجموعه‌ای از داده‌های یک ویژگی هستند. در یک گزارش قیف با بخش ها، قیف در هر بخش ارزیابی می شود.

هر بخش مشخص شده در این درخواست یک ردیف جداگانه در پاسخ ایجاد می کند. در پاسخ، هر بخش با نام خود مشخص شد.

پارامتر segments اختیاری است. درخواست ها به 4 بخش محدود می شود.

limit

string ( int64 format)

اختیاری. تعداد ردیف هایی که باید برگردانده شوند. اگر مشخص نشده باشد، 10000 ردیف برگردانده می شود. API حداکثر 250000 سطر را در هر درخواست برمی گرداند، مهم نیست که چقدر درخواست کنید. limit باید مثبت باشد

API همچنین می‌تواند ردیف‌های کمتری را نسبت به limit درخواستی برگرداند، اگر مقادیر ابعاد به اندازه limit وجود نداشته باشد.

dimensionFilter

object ( FilterExpression )

اختیاری. فیلترهای ابعاد به شما امکان می دهند فقط مقادیر ابعاد خاصی را در گزارش بخواهید. برای کسب اطلاعات بیشتر، برای مثال به ایجاد گزارش: فیلترهای ابعاد مراجعه کنید. معیارها را نمی توان در این فیلتر استفاده کرد.

returnPropertyQuota

boolean

اختیاری. وضعیت فعلی سهمیه این Analytics Property را تغییر می‌دهد یا خیر. سهمیه در PropertyQuota برگردانده می شود.

بدن پاسخگو

پاسخ گزارش قیف شامل دو گزارش فرعی است. دو گزارش فرعی ترکیبی متفاوت از ابعاد و معیارها هستند.

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:

نمایندگی JSON
{
  "funnelTable": {
    object (FunnelSubReport)
  },
  "funnelVisualization": {
    object (FunnelSubReport)
  },
  "propertyQuota": {
    object (PropertyQuota)
  },
  "kind": string
}
زمینه های
funnelTable

object ( FunnelSubReport )

جدول قیف گزارشی با مرحله قیف، بخش، بعد شکست، کاربران فعال، نرخ تکمیل، رها شدن و نرخ رهاسازی است.

بعد بخش فقط در صورت درخواست بخش در این پاسخ وجود دارد. بعد شکست فقط در صورت درخواست در این پاسخ وجود دارد.

funnelVisualization

object ( FunnelSubReport )

تجسم قیف یک گزارش با مرحله قیف، بخش، تاریخ، بعد اقدام بعدی و کاربران فعال است.

بعد بخش فقط در صورت درخواست بخش در این پاسخ وجود دارد. بعد تاریخ فقط در صورتی در این پاسخ وجود دارد که از طریق نوع قیف TRENDED_FUNNEL درخواست شده باشد. بعد اقدام بعدی فقط در صورت درخواست در پاسخ وجود دارد.

propertyQuota

object ( PropertyQuota )

وضعیت سهمیه این Analytics Property شامل این درخواست است.

kind

string

مشخص می کند که این پیام چه نوع منبعی است. این kind همیشه رشته ثابت "analyticsData#runFunnelReport" است. برای تمایز بین انواع پاسخ در JSON مفید است.

محدوده مجوز

به یکی از حوزه های OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/analytics.readonly
  • https://www.googleapis.com/auth/analytics

محدوده زمانی

مجموعه ای از روزهای پیوسته: startDate ، startDate + 1 ، ...، endDate . درخواست تا 4 محدوده تاریخ مجاز است.

نمایندگی JSON
{
  "startDate": string,
  "endDate": string,
  "name": string
}
زمینه های
startDate

string

تاریخ شروع شامل درخواست در قالب YYYY-MM-DD . نمی تواند بعد از endDate باشد. قالب NdaysAgo ، yesterday یا today نیز پذیرفته شده است و در این صورت، تاریخ بر اساس منطقه زمانی گزارش ملک استنباط می شود.

endDate

string

تاریخ پایان شامل درخواست در قالب YYYY-MM-DD . نمی تواند قبل از startDate باشد. قالب NdaysAgo ، yesterday یا today نیز پذیرفته شده است و در این صورت، تاریخ بر اساس منطقه زمانی گزارش ملک استنباط می شود.

name

string

نامی را به این محدوده تاریخ اختصاص می دهد. بعد dateRange با این نام در یک پاسخ گزارش ارزش گذاری می شود. در صورت تنظیم، نمی توان با date_range_ یا RESERVED_ شروع کرد. اگر تنظیم نشود، محدوده‌های تاریخ با شاخص صفر آنها در درخواست نام‌گذاری می‌شوند: date_range_0 ، date_range_1 و غیره.

قیف

قیف را در یک درخواست گزارش قیف پیکربندی می کند. یک قیف در حین گذر از مراحل متوالی از کاربران گزارش می دهد.

کاوش قیف به شما این امکان را می‌دهد تا مراحلی را که کاربران برای تکمیل یک کار برمی‌دارند تجسم کنید و به سرعت ببینید که در هر مرحله چقدر موفق یا شکست می‌خورند. به عنوان مثال، چگونه مشتریان بالقوه خریدار و سپس خریدار می شوند؟ چگونه خریداران یکباره تبدیل به خریداران تکراری می شوند؟ با این اطلاعات، می توانید سفرهای ناکارآمد یا رها شده مشتریان را بهبود ببخشید.

نمایندگی JSON
{
  "isOpenFunnel": boolean,
  "steps": [
    {
      object (FunnelStep)
    }
  ]
}
زمینه های
isOpenFunnel

boolean

در قیف باز کاربران در هر مرحله می توانند وارد قیف شوند و در قیف بسته کاربران باید در مرحله اول وارد قیف شوند. اختیاری. اگر مشخص نباشد، از یک قیف بسته استفاده می شود.

steps[]

object ( FunnelStep )

مراحل متوالی این قیف.

FunnelStep

مراحل سفر کاربر را که می خواهید اندازه گیری کنید، مشخص می کند. مراحل شامل یک یا چند شرط است که کاربران شما باید آن‌ها را داشته باشند تا در آن مرحله از سفر قیف قرار گیرند.

نمایندگی JSON
{
  "name": string,
  "isDirectlyFollowedBy": boolean,
  "filterExpression": {
    object (FunnelFilterExpression)
  },
  "withinDurationFromPriorStep": string
}
زمینه های
name

string

نام متمایز این مرحله. اگر نامشخص باشد، مراحل با یک نام نمایه شده بر اساس 1 نامگذاری می شوند (به عنوان مثال "0."، "1."، و غیره). این نام مقدار رشته ای را که توسط بعد funnelStepName برگردانده شده است، تعریف می کند. به عنوان مثال، مشخص کردن name = Purchase در مرحله سوم قیف درخواست 3. Purchase در پاسخ گزارش قیف.

isDirectlyFollowedBy

boolean

اگر درست باشد، این مرحله باید مستقیماً از مرحله قبل پیروی کند. اگر نادرست باشد، ممکن است رویدادهایی بین مرحله قبل و این مرحله وجود داشته باشد. اگر مشخص نشده باشد، isDirectlyFollowedBy به عنوان نادرست در نظر گرفته می شود.

filterExpression

object ( FunnelFilterExpression )

شرطی که کاربران شما باید داشته باشند تا در این مرحله از سفر قیف قرار گیرند.

withinDurationFromPriorStep

string ( Duration format)

اگر مشخص شده باشد، این مرحله باید در این مدت از اتمام مرحله قبلی کامل شود. withinDurationFromPriorStep شامل نقطه پایانی در دانه بندی میکروثانیه است. به عنوان مثال، مدت زمان 5 ثانیه را می توان در 4.9 یا 5.0 ثانیه تکمیل کرد، اما نه 5 ثانیه و 1 میکروثانیه.

withinDurationFromPriorStep اختیاری است و اگر مشخص نباشد، مراحل ممکن است با هر مدت زمانی از هم جدا شوند.

مدت زمان در ثانیه با حداکثر نه رقم کسری که با ' s ' ختم می شود. مثال: "3.5s" .

FunnelFilterExpression

ترکیبی از فیلترهای قیفی را بیان می کند.

نمایندگی JSON
{

  // Union field expr can be only one of the following:
  "andGroup": {
    object (FunnelFilterExpressionList)
  },
  "orGroup": {
    object (FunnelFilterExpressionList)
  },
  "notExpression": {
    object (FunnelFilterExpression)
  },
  "funnelFieldFilter": {
    object (FunnelFieldFilter)
  },
  "funnelEventFilter": {
    object (FunnelEventFilter)
  }
  // End of list of possible types for union field expr.
}
زمینه های
expr فیلد اتحادیه یک نوع فیلتر را برای FunnelFilterExpression مشخص کنید. expr می تواند تنها یکی از موارد زیر باشد:
andGroup

object ( FunnelFilterExpressionList )

FunnelFilterExpression در andGroup یک رابطه AND دارد.

orGroup

object ( FunnelFilterExpressionList )

FunnelFilterExpression در orGroup یک رابطه OR دارد.

notExpression

object ( FunnelFilterExpression )

FunnelFilterExpression از notExpression نیست.

funnelFieldFilter

object ( FunnelFieldFilter )

یک فیلتر قیف برای یک بعد یا متریک.

funnelEventFilter

object ( FunnelEventFilter )

فیلتری ایجاد می کند که رویدادهای یک نام رویداد را مطابقت دهد. اگر یک عبارت فیلتر پارامتر مشخص شده باشد، فقط زیرمجموعه رویدادهایی که با نام رویداد واحد و عبارات فیلتر پارامتر مطابقت دارند با این فیلتر رویداد مطابقت دارند.

FunnelFilterExpressionList

لیستی از عبارات فیلتر قیف.

نمایندگی JSON
{
  "expressions": [
    {
      object (FunnelFilterExpression)
    }
  ]
}
زمینه های
expressions[]

object ( FunnelFilterExpression )

لیست عبارات فیلتر قیف.

FunnelFieldFilter

عبارتی برای فیلتر ابعاد یا مقادیر متریک.

نمایندگی JSON
{
  "fieldName": string,

  // Union field one_filter can be only one of the following:
  "stringFilter": {
    object (StringFilter)
  },
  "inListFilter": {
    object (InListFilter)
  },
  "numericFilter": {
    object (NumericFilter)
  },
  "betweenFilter": {
    object (BetweenFilter)
  }
  // End of list of possible types for union field one_filter.
}
زمینه های
fieldName

string

نام ابعاد یا نام متریک.

فیلد اتحادیه one_filter . یک نوع فیلتر را مشخص کنید. one_filter تنها می تواند یکی از موارد زیر باشد:
stringFilter

object ( StringFilter )

فیلتر مربوط به رشته ها

inListFilter

object ( InListFilter )

فیلتری برای مقادیر در لیست.

numericFilter

object ( NumericFilter )

فیلتری برای مقادیر عددی یا تاریخ.

betweenFilter

object ( BetweenFilter )

یک فیلتر برای بین دو مقدار.

StringFilter

فیلتر رشته

نمایندگی JSON
{
  "matchType": enum (MatchType),
  "value": string,
  "caseSensitive": boolean
}
زمینه های
matchType

enum ( MatchType )

نوع مطابقت برای این فیلتر.

value

string

مقدار رشته ای که برای تطبیق استفاده می شود.

caseSensitive

boolean

اگر درست باشد، مقدار رشته به حروف بزرگ و کوچک حساس است.

MatchType

نوع مطابقت یک فیلتر رشته ای

Enums
MATCH_TYPE_UNSPECIFIED نامشخص
EXACT مطابقت دقیق مقدار رشته
BEGINS_WITH با مقدار رشته شروع می شود.
ENDS_WITH با مقدار رشته به پایان می رسد.
CONTAINS حاوی مقدار رشته است.
FULL_REGEXP مطابقت کامل برای عبارت منظم با مقدار رشته.
PARTIAL_REGEXP مطابقت جزئی برای عبارت منظم با مقدار رشته.

InListFilter

نتیجه باید در لیستی از مقادیر رشته باشد.

نمایندگی JSON
{
  "values": [
    string
  ],
  "caseSensitive": boolean
}
زمینه های
values[]

string

لیست مقادیر رشته باید خالی نباشد

caseSensitive

boolean

اگر درست باشد، مقدار رشته به حروف بزرگ و کوچک حساس است.

فیلتر عددی

فیلترهایی برای مقادیر عددی یا تاریخ.

نمایندگی JSON
{
  "operation": enum (Operation),
  "value": {
    object (NumericValue)
  }
}
زمینه های
operation

enum ( Operation )

نوع عملکرد این فیلتر

value

object ( NumericValue )

یک مقدار عددی یا یک مقدار تاریخ.

عمل

عملیات بر روی یک فیلتر عددی اعمال می شود

Enums
OPERATION_UNSPECIFIED نامشخص
EQUAL برابر
LESS_THAN کمتر از
LESS_THAN_OR_EQUAL کمتر یا مساوی
GREATER_THAN بزرگتر از
GREATER_THAN_OR_EQUAL بزرگتر یا مساوی

مقدار عددی

برای نشان دادن یک عدد

نمایندگی JSON
{

  // Union field one_value can be only one of the following:
  "int64Value": string,
  "doubleValue": number
  // End of list of possible types for union field one_value.
}
زمینه های
فیلد اتحادیه one_value . یکی از مقادیر عددی one_value می تواند تنها یکی از موارد زیر باشد:
int64Value

string ( int64 format)

مقدار صحیح

doubleValue

number

ارزش دو برابر

بین فیلتر

برای بیان اینکه نتیجه باید بین دو عدد (شامل) باشد.

نمایندگی JSON
{
  "fromValue": {
    object (NumericValue)
  },
  "toValue": {
    object (NumericValue)
  }
}
زمینه های
fromValue

object ( NumericValue )

با این عدد شروع می شود.

toValue

object ( NumericValue )

با این عدد به پایان می رسد.

FunnelEventFilter

فیلتری ایجاد می کند که رویدادهای یک نام رویداد را مطابقت دهد. اگر یک عبارت فیلتر پارامتر مشخص شده باشد، فقط زیرمجموعه رویدادهایی که با نام رویداد واحد و عبارات فیلتر پارامتر مطابقت دارند با این فیلتر رویداد مطابقت دارند.

نمایندگی JSON
{
  "eventName": string,
  "funnelParameterFilterExpression": {
    object (FunnelParameterFilterExpression)
  }
}
زمینه های
eventName

string

این فیلتر رویدادهای این نام رویداد را منطبق می‌کند. نام رویداد الزامی است.

funnelParameterFilterExpression

object ( FunnelParameterFilterExpression )

اگر مشخص شده باشد، این فیلتر با رویدادهایی مطابقت دارد که با نام رویداد واحد و عبارات فیلتر پارامتر مطابقت دارند.

در داخل عبارت فیلتر پارامتر، فقط فیلترهای پارامتر موجود است.

FunnelParameterFilterExpression

ترکیبی از فیلترهای قیف را بر روی پارامترها بیان می کند.

نمایندگی JSON
{

  // Union field expr can be only one of the following:
  "andGroup": {
    object (FunnelParameterFilterExpressionList)
  },
  "orGroup": {
    object (FunnelParameterFilterExpressionList)
  },
  "notExpression": {
    object (FunnelParameterFilterExpression)
  },
  "funnelParameterFilter": {
    object (FunnelParameterFilter)
  }
  // End of list of possible types for union field expr.
}
زمینه های
expr فیلد اتحادیه یک نوع فیلتر را برای FunnelParameterFilterExpression مشخص کنید. expr می تواند تنها یکی از موارد زیر باشد:
andGroup

object ( FunnelParameterFilterExpressionList )

FunnelParameterFilterExpression در andGroup یک رابطه AND دارد.

orGroup

object ( FunnelParameterFilterExpressionList )

FunnelParameterFilterExpression در orGroup یک رابطه OR دارد.

notExpression

object ( FunnelParameterFilterExpression )

FunnelParameterFilterExpression از notExpression نیست.

funnelParameterFilter

object ( FunnelParameterFilter )

یک فیلتر پارامتر قیف اولیه.

FunnelParameterFilterExpressionList

فهرستی از عبارات فیلتر پارامتر قیف.

نمایندگی JSON
{
  "expressions": [
    {
      object (FunnelParameterFilterExpression)
    }
  ]
}
زمینه های
expressions[]

object ( FunnelParameterFilterExpression )

لیست عبارات فیلتر پارامتر قیف.

FunnelParameterFilter

عبارتی برای فیلتر کردن مقادیر پارامتر در یک قیف.

نمایندگی JSON
{

  // Union field one_parameter can be only one of the following:
  "eventParameterName": string,
  "itemParameterName": string
  // End of list of possible types for union field one_parameter.

  // Union field one_filter can be only one of the following:
  "stringFilter": {
    object (StringFilter)
  },
  "inListFilter": {
    object (InListFilter)
  },
  "numericFilter": {
    object (NumericFilter)
  },
  "betweenFilter": {
    object (BetweenFilter)
  }
  // End of list of possible types for union field one_filter.
}
زمینه های
فیلد اتحادیه one_parameter . فیلدی که در حال فیلتر شدن است. one_parameter می تواند تنها یکی از موارد زیر باشد:
eventParameterName

string

این فیلتر بر روی پارامتر رویداد مشخص شده ارزیابی می شود. پارامترهای رویداد به عنوان پارامترهای رویداد ثبت می شوند. پارامترهای رویداد شامل فیلدهایی مانند "firebase_screen" و "currency" است.

پارامترهای رویداد فقط در بخش‌ها و قیف‌ها قابل استفاده هستند و فقط می‌توانند در فیلتر نزولی از یک EventFilter استفاده شوند. در یک فیلتر نزولی از یک EventFilter باید از پارامترهای رویداد یا آیتم استفاده شود.

itemParameterName

string

این فیلتر بر اساس پارامتر مورد مشخص شده ارزیابی می شود. پارامترهای آیتم به عنوان پارامتر در آرایه آیتم ثبت می شوند. پارامترهای مورد شامل فیلدهایی مانند "item_name" و "item_category" هستند.

پارامترهای مورد فقط در بخش‌ها و قیف‌ها قابل استفاده هستند و فقط می‌توانند در فیلتر نزولی از EventFilter استفاده شوند. در یک فیلتر نزولی از یک EventFilter باید از پارامترهای رویداد یا آیتم استفاده شود.

پارامترهای مورد فقط در رویدادهای تجارت الکترونیک در دسترس هستند. برای کسب اطلاعات بیشتر در مورد رویدادهای تجارت الکترونیک، راهنمای اندازه گیری تجارت الکترونیک را ببینید.

فیلد اتحادیه one_filter . یک نوع فیلتر را مشخص کنید. one_filter تنها می تواند یکی از موارد زیر باشد:
stringFilter

object ( StringFilter )

فیلتر مربوط به رشته ها

inListFilter

object ( InListFilter )

فیلتری برای مقادیر در لیست.

numericFilter

object ( NumericFilter )

فیلتری برای مقادیر عددی یا تاریخ.

betweenFilter

object ( BetweenFilter )

یک فیلتر برای بین دو مقدار.

Funnel Breakdown

خرابی ها به پاسخ گزارش فرعی جدول قیف بعد می افزایند.

نمایندگی JSON
{
  "breakdownDimension": {
    object (Dimension)
  },
  "limit": string
}
زمینه های
breakdownDimension

object ( Dimension )

ستون ابعاد به پاسخ گزارش فرعی جدول قیف اضافه شد. بعد شکست هر مرحله قیف را تجزیه می کند. اگر funnelBreakdown مشخص شده باشد، یک breakdownDimension معتبر لازم است.

limit

string ( int64 format)

حداکثر تعداد مقادیر متمایز بعد شکست که در پاسخ بازگردانده می شود. اگر محدودیت مشخص نشده باشد از limit 5 استفاده می شود. حد مجاز باید از صفر تجاوز کند و نباید از 15 تجاوز کند.

بعد، ابعاد، اندازه

ابعاد ویژگی های داده های شما هستند. به عنوان مثال، شهر بعد شهری را نشان می دهد که یک رویداد از آن سرچشمه می گیرد. مقادیر ابعاد در پاسخ های گزارش رشته ای هستند. به عنوان مثال، شهر می تواند "پاریس" یا "نیویورک" باشد.

نمایندگی JSON
{
  "name": string,
  "dimensionExpression": {
    object (DimensionExpression)
  }
}
زمینه های
name

string

نام ابعاد. برای لیستی از نام ابعاد پشتیبانی شده توسط روش های گزارش اصلی مانند runReport و batchRunReports ، به ابعاد API مراجعه کنید. برای لیستی از نام ابعاد پشتیبانی شده توسط روش runRealtimeReport Realtime Dimensions را ببینید. برای لیستی از نام ابعاد پشتیبانی شده توسط روش runFunnelReport به ابعاد قیف مراجعه کنید.

اگر dimensionExpression مشخص شده باشد، name می تواند هر رشته ای باشد که می خواهید در مجموعه کاراکترهای مجاز. به عنوان مثال اگر یک dimensionExpression country و city را به هم متصل می کند، می توانید آن بعد را countryAndCity بنامید. نام ابعادی که انتخاب می‌کنید باید با عبارت منظم ^[a-zA-Z0-9_]$ مطابقت داشته باشد.

ابعاد با name در dimensionFilter , orderBys , dimensionExpression و pivots ارجاع می شوند.

dimensionExpression

object ( DimensionExpression )

یک بعد می تواند نتیجه بیان چند بعد باشد. به عنوان مثال، بعد "کشور، شهر": concatenate(کشور، "، "، شهر).

DimensionExpression

برای بیان یک بعد که حاصل فرمول چند بعد است استفاده می شود. کاربردهای مثال: 1) حروف کوچک (بعد) 2) الحاق (بعد 1، نماد، بعد 2).

نمایندگی JSON
{

  // Union field one_expression can be only one of the following:
  "lowerCase": {
    object (CaseExpression)
  },
  "upperCase": {
    object (CaseExpression)
  },
  "concatenate": {
    object (ConcatenateExpression)
  }
  // End of list of possible types for union field one_expression.
}
زمینه های
فیلد اتحادیه one_expression . یک نوع عبارت بعد را برای DimensionExpression مشخص کنید. one_expression می تواند تنها یکی از موارد زیر باشد:
lowerCase

object ( CaseExpression )

برای تبدیل مقدار ابعاد به حروف کوچک استفاده می شود.

upperCase

object ( CaseExpression )

برای تبدیل مقدار ابعاد به حروف بزرگ استفاده می شود.

concatenate

object ( ConcatenateExpression )

برای ترکیب مقادیر ابعاد به یک بعد واحد استفاده می شود. به عنوان مثال، بعد "کشور، شهر": concatenate(کشور، "، "، شهر).

Case Expression

برای تبدیل مقدار ابعاد به یک مورد استفاده می شود.

نمایندگی JSON
{
  "dimensionName": string
}
زمینه های
dimensionName

string

نام یک بعد نام باید به یک نام در قسمت ابعاد درخواست اشاره کند.

ConcatenateExpression

برای ترکیب مقادیر ابعاد به یک بعد واحد استفاده می شود.

نمایندگی JSON
{
  "dimensionNames": [
    string
  ],
  "delimiter": string
}
زمینه های
dimensionNames[]

string

نام ابعاد نام ها باید به نام هایی در قسمت ابعاد درخواست مراجعه کنند.

delimiter

string

جداکننده بین نام ابعاد قرار می گیرد.

جداکننده ها اغلب کاراکترهای منفرد هستند مانند "|" یا ""، اما می تواند رشته های طولانی تر باشد. اگر یک مقدار بعد حاوی جداکننده باشد، هر دو بدون هیچ تمایزی در پاسخ وجود خواهند داشت. به عنوان مثال، اگر مقدار بعد 1 = "US,FR"، مقدار بعد 2 = "JP" و جداکننده = "،"، پاسخ شامل "US,FR,JP" خواهد بود.

FunnelNextAction

اقدامات بعدی مقدار یک بعد را بعد از رسیدن کاربر به یک مرحله اما قبل از رسیدن همان کاربر به مرحله بعدی نشان می دهد. به عنوان مثال، اگر nextActionDimension eventName باشد، nextActionDimension در ردیف مرحله قیف i اولین رویداد را پس از رویدادی که کاربر را به مرحله قیف i م واجد شرایط می‌کند، اما قبل از رسیدن کاربر به مرحله i+1 قیف برمی‌گرداند.

نمایندگی JSON
{
  "nextActionDimension": {
    object (Dimension)
  },
  "limit": string
}
زمینه های
nextActionDimension

object ( Dimension )

ستون بعد به پاسخ گزارش فرعی تجسم قیف اضافه شد. بعد اقدام بعدی بعد از اینکه کاربر به مرحله i قیف رسید مقدار بعد بعدی این بعد را برمی گرداند.

nextActionDimension در حال حاضر فقط eventName و بیشتر ابعاد صفحه/صفحه مانند pageTitle و pagePath را پشتیبانی می کند. nextActionDimension نمی تواند یک عبارت بعد باشد.

limit

string ( int64 format)

حداکثر تعداد مقادیر متمایز بعد شکست که در پاسخ بازگردانده می شود. اگر محدودیت مشخص نشده باشد از limit 5 استفاده می شود. حد مجاز باید از صفر تجاوز کند و نباید از 5 تجاوز کند.

FunnelVisualizationType

ابعاد موجود در پاسخ گزارش فرعی تجسم قیف را کنترل می کند.

Enums
FUNNEL_VISUALIZATION_TYPE_UNSPECIFIED نوع نامشخص
STANDARD_FUNNEL یک قیف استاندارد (پله ای). گزارش فرعی تجسم قیف در پاسخ حاوی تاریخ نخواهد بود.
TRENDED_FUNNEL یک قیف ترند (نمودار خطی). گزارش فرعی تجسم قیف در پاسخ حاوی بعد تاریخ خواهد بود.

بخش

یک بخش زیرمجموعه ای از داده های Analytics شما است. برای مثال، از کل مجموعه کاربران شما، یک بخش ممکن است کاربران یک کشور یا شهر خاص باشد. بخش دیگر ممکن است کاربرانی باشند که خط خاصی از محصولات را خریداری می کنند یا از بخش خاصی از سایت شما بازدید می کنند یا رویدادهای خاصی را در برنامه شما راه اندازی می کنند.

برای کسب اطلاعات بیشتر، بخش ساز GA4 را ببینید.

نمایندگی JSON
{
  "name": string,

  // Union field one_segment_scope can be only one of the following:
  "userSegment": {
    object (UserSegment)
  },
  "sessionSegment": {
    object (SessionSegment)
  },
  "eventSegment": {
    object (EventSegment)
  }
  // End of list of possible types for union field one_segment_scope.
}
زمینه های
name

string

نام این بخش اگر نامشخص باشد، بخش‌ها «بخش» نامیده می‌شوند. این نام مقدار رشته ای را که توسط بعد segment برگردانده شده است، تعریف می کند. بعد segment ، نام بخش ها را با شماره شاخص 1 بخش در درخواست پیشوند می دهد (به عنوان مثال "1. Segment"، "2. Segment"، و غیره).

فیلد اتحادیه one_segment_scope . یک بخش در یک محدوده مشخص شده است. one_segment_scope تنها می تواند یکی از موارد زیر باشد:
userSegment

object ( UserSegment )

بخش‌های کاربر زیرمجموعه‌ای از کاربرانی هستند که با سایت یا برنامه شما درگیر هستند.

sessionSegment

object ( SessionSegment )

بخش‌های جلسه زیرمجموعه‌هایی از جلساتی هستند که در سایت یا برنامه شما رخ داده‌اند.

eventSegment

object ( EventSegment )

بخش‌های رویداد زیرمجموعه‌ای از رویدادهایی هستند که در سایت یا برنامه شما راه‌اندازی شده‌اند.

بخش کاربر

بخش‌های کاربر زیرمجموعه‌ای از کاربرانی هستند که با سایت یا برنامه شما درگیر هستند. به عنوان مثال، کاربرانی که قبلا خرید کرده اند؛ کاربرانی که مواردی را به سبد خرید خود اضافه کرده‌اند، اما خریدی را تکمیل نکرده‌اند.

نمایندگی JSON
{
  "userInclusionCriteria": {
    object (UserSegmentCriteria)
  },
  "exclusion": {
    object (UserSegmentExclusion)
  }
}
زمینه های
userInclusionCriteria

object ( UserSegmentCriteria )

مشخص می کند که چه کاربرانی در این بخش قرار می گیرند. اختیاری.

exclusion

object ( UserSegmentExclusion )

مشخص می کند کدام کاربران در این بخش مستثنی هستند. اختیاری.

UserSegmentCriteria

اگر رویدادهای کاربر شرایط موجود در معیارها را داشته باشند، یک کاربر با یک معیار مطابقت دارد.

نمایندگی JSON
{
  "andConditionGroups": [
    {
      object (UserSegmentConditionGroup)
    }
  ],
  "andSequenceGroups": [
    {
      object (UserSegmentSequenceGroup)
    }
  ]
}
زمینه های
andConditionGroups[]

object ( UserSegmentConditionGroup )

اگر کاربر با هر یک از این andConditionGroups و هر یک از andSequenceGroups مطابقت داشته باشد، یک کاربر با این معیار مطابقت دارد. اگر andSequenceGroups مشخص شده باشد، andConditionGroups ممکن است خالی باشد.

andSequenceGroups[]

object ( UserSegmentSequenceGroup )

اگر کاربر با هر یک از این andSequenceGroups و هر یک از andConditionGroups مطابقت داشته باشد، یک کاربر با این معیار مطابقت دارد. andSequenceGroups ممکن است خالی باشد اگر andConditionGroups مشخص شده باشد.

UserSegmentConditionGroup

شرایط به Analytics می‌گوید چه داده‌هایی را در بخش گنجانده یا از آن حذف کند.

نمایندگی JSON
{
  "conditionScoping": enum (UserCriteriaScoping),
  "segmentFilterExpression": {
    object (SegmentFilterExpression)
  }
}
زمینه های
conditionScoping

enum ( UserCriteriaScoping )

داده ها بر اساس اینکه با گروه شرایط مطابقت دارند شامل یا از بخش حذف می شوند. این محدوده تعیین می کند که قبل از اینکه گروه شرط مطابقت داشته باشد یا خیر، segmentFilterExpression بر روی چند رویداد ارزیابی می شود. به عنوان مثال، اگر conditionScoping = USER_CRITERIA_WITHIN_SAME_SESSION ، عبارت در تمام رویدادهای یک جلسه ارزیابی می‌شود، و سپس، تعیین می‌شود که گروه شرط برای این کاربر مطابقت داشته باشد یا خیر. برای مثال، اگر conditionScoping = USER_CRITERIA_WITHIN_SAME_EVENT ، عبارت بر روی یک رویداد ارزیابی می‌شود، و سپس تعیین می‌شود که گروه شرط برای این کاربر مطابقت داشته باشد یا خیر.

اختیاری. اگر مشخص نشده باشد، conditionScoping = ACROSS_ALL_SESSIONS استفاده می شود.

segmentFilterExpression

object ( SegmentFilterExpression )

داده ها بر اساس مطابقت با این عبارت شامل یا از بخش حذف می شوند. عبارات معیارهای ابعاد، معیارها و/یا پارامترها را بیان می کنند.

UserCriteriaScoping

محدوده مشخص می کند که در صورت رعایت یک معیار، کدام رویدادها هنگام ارزیابی در نظر گرفته می شوند.

Enums
USER_CRITERIA_SCOPING_UNSPECIFIED محدوده معیارهای نامشخص مشخص نکنید.
USER_CRITERIA_WITHIN_SAME_EVENT اگر معیارها در یک رویداد برآورده شوند، کاربر با معیارها مطابقت دارد.
USER_CRITERIA_WITHIN_SAME_SESSION اگر معیارها در یک جلسه برآورده شود، کاربر با معیارها مطابقت دارد.
USER_CRITERIA_ACROSS_ALL_SESSIONS اگر معیارها توسط هر رویدادی برای کاربر برآورده شود، کاربر با معیارها مطابقت دارد.

SegmentFilterExpression

ترکیبی از فیلترهای بخش را بیان می کند.

نمایندگی JSON
{

  // Union field expr can be only one of the following:
  "andGroup": {
    object (SegmentFilterExpressionList)
  },
  "orGroup": {
    object (SegmentFilterExpressionList)
  },
  "notExpression": {
    object (SegmentFilterExpression)
  },
  "segmentFilter": {
    object (SegmentFilter)
  },
  "segmentEventFilter": {
    object (SegmentEventFilter)
  }
  // End of list of possible types for union field expr.
}
زمینه های
expr فیلد اتحادیه یک نوع فیلتر را برای SegmentFilterExpression مشخص کنید. expr می تواند تنها یکی از موارد زیر باشد:
andGroup

object ( SegmentFilterExpressionList )

SegmentFilterExpression در andGroup یک رابطه AND دارد.

orGroup

object ( SegmentFilterExpressionList )

SegmentFilterExpression در orGroup یک رابطه OR دارد.

notExpression

object ( SegmentFilterExpression )

SegmentFilterExpression مربوط به notExpression نیست.

segmentFilter

object ( SegmentFilter )

یک فیلتر بخش اولیه

segmentEventFilter

object ( SegmentEventFilter )

فیلتری ایجاد می کند که رویدادهای یک نام رویداد را مطابقت دهد. اگر یک عبارت فیلتر پارامتر مشخص شده باشد، فقط زیرمجموعه رویدادهایی که با نام رویداد واحد و عبارات فیلتر پارامتر مطابقت دارند با این فیلتر رویداد مطابقت دارند.

SegmentFilterExpressionList

لیستی از عبارات فیلتر بخش.

نمایندگی JSON
{
  "expressions": [
    {
      object (SegmentFilterExpression)
    }
  ]
}
زمینه های
expressions[]

object ( SegmentFilterExpression )

لیست عبارات فیلتر بخش

بخش فیلتر

عبارتی برای فیلتر ابعاد یا مقادیر متریک.

نمایندگی JSON
{
  "fieldName": string,
  "filterScoping": {
    object (SegmentFilterScoping)
  },

  // Union field one_filter can be only one of the following:
  "stringFilter": {
    object (StringFilter)
  },
  "inListFilter": {
    object (InListFilter)
  },
  "numericFilter": {
    object (NumericFilter)
  },
  "betweenFilter": {
    object (BetweenFilter)
  }
  // End of list of possible types for union field one_filter.
}
زمینه های
fieldName

string

نام ابعاد یا نام متریک.

filterScoping

object ( SegmentFilterScoping )

محدوده فیلتر را مشخص می کند.

فیلد اتحادیه one_filter . یک نوع فیلتر را برای Filter مشخص کنید. one_filter تنها می تواند یکی از موارد زیر باشد:
stringFilter

object ( StringFilter )

فیلتر مربوط به رشته ها

inListFilter

object ( InListFilter )

فیلتری برای مقادیر در لیست.

numericFilter

object ( NumericFilter )

فیلتری برای مقادیر عددی یا تاریخ.

betweenFilter

object ( BetweenFilter )

یک فیلتر برای بین دو مقدار.

SegmentFilterScoping

محدوده‌ها مشخص می‌کنند که چگونه ابعاد و معیارهای رویدادهای متعدد هنگام ارزیابی یک فیلتر بخش در نظر گرفته شود.

نمایندگی JSON
{
  "atAnyPointInTime": boolean
}
زمینه های
atAnyPointInTime

boolean

اگر atAnyPointInTime درست باشد، اگر این فیلتر برای هر رویدادی در محدوده تاریخ درخواست به درستی ارزیابی شود، برای همه رویدادها درست ارزیابی می‌شود.

این پارامتر atAnyPointInTime محدوده تاریخ رویدادهای گزارش را افزایش نمی دهد. اگر atAnyPointInTime درست باشد، هنگام ارزیابی این فیلتر فقط رویدادهایی در محدوده تاریخ گزارش در نظر گرفته می‌شوند.

این atAnyPointInTime تنها زمانی می‌تواند مشخص شود که محدوده معیار ACROSS_ALL_SESSIONS باشد و نتوان آن را در دنباله‌ها مشخص کرد.

اگر محدوده معیار ACROSS_ALL_SESSIONS باشد، در صورت نامشخص atAnyPointInTime = false استفاده می شود.

SegmentEventFilter

فیلتری ایجاد می کند که رویدادهای یک نام رویداد را مطابقت دهد. اگر یک عبارت فیلتر پارامتر مشخص شده باشد، فقط زیرمجموعه رویدادهایی که با نام رویداد واحد و عبارات فیلتر پارامتر مطابقت دارند با این فیلتر رویداد مطابقت دارند.

نمایندگی JSON
{
  "eventName": string,
  "segmentParameterFilterExpression": {
    object (SegmentParameterFilterExpression)
  }
}
زمینه های
eventName

string

این فیلتر رویدادهای این نام رویداد را منطبق می‌کند. نام رویداد الزامی است.

segmentParameterFilterExpression

object ( SegmentParameterFilterExpression )

اگر مشخص شده باشد، این فیلتر با رویدادهایی مطابقت دارد که با نام رویداد واحد و عبارات فیلتر پارامتر مطابقت دارند.

در داخل عبارت فیلتر پارامتر، فقط فیلترهای پارامتر موجود است.

SegmentParameterFilterExpression

ترکیبی از فیلتر بخش را بر روی پارامترها بیان می کند.

نمایندگی JSON
{

  // Union field expr can be only one of the following:
  "andGroup": {
    object (SegmentParameterFilterExpressionList)
  },
  "orGroup": {
    object (SegmentParameterFilterExpressionList)
  },
  "notExpression": {
    object (SegmentParameterFilterExpression)
  },
  "segmentParameterFilter": {
    object (SegmentParameterFilter)
  }
  // End of list of possible types for union field expr.
}
زمینه های
expr فیلد اتحادیه یک نوع فیلتر را برای SegmentParameterFilterExpression مشخص کنید. expr می تواند تنها یکی از موارد زیر باشد:
andGroup

object ( SegmentParameterFilterExpressionList )

SegmentParameterFilterExpression در andGroup یک رابطه AND دارد.

orGroup

object ( SegmentParameterFilterExpressionList )

SegmentParameterFilterExpression در orGroup یک رابطه OR دارد.

notExpression

object ( SegmentParameterFilterExpression )

SegmentParameterFilterExpression از notExpression نیست.

segmentParameterFilter

object ( SegmentParameterFilter )

یک فیلتر پارامتر بخش اولیه

SegmentParameterFilterExpressionList

لیستی از عبارات فیلتر پارامتر بخش.

نمایندگی JSON
{
  "expressions": [
    {
      object (SegmentParameterFilterExpression)
    }
  ]
}
زمینه های
expressions[]

object ( SegmentParameterFilterExpression )

لیست عبارات فیلتر پارامتر بخش.

SegmentParameterFilter

عبارتی برای فیلتر کردن مقادیر پارامتر در یک بخش.

نمایندگی JSON
{
  "filterScoping": {
    object (SegmentParameterFilterScoping)
  },

  // Union field one_parameter can be only one of the following:
  "eventParameterName": string,
  "itemParameterName": string
  // End of list of possible types for union field one_parameter.

  // Union field one_filter can be only one of the following:
  "stringFilter": {
    object (StringFilter)
  },
  "inListFilter": {
    object (InListFilter)
  },
  "numericFilter": {
    object (NumericFilter)
  },
  "betweenFilter": {
    object (BetweenFilter)
  }
  // End of list of possible types for union field one_filter.
}
زمینه های
filterScoping

object ( SegmentParameterFilterScoping )

محدوده فیلتر را مشخص می کند.

فیلد اتحادیه one_parameter . فیلدی که در حال فیلتر شدن است. one_parameter تنها می تواند یکی از موارد زیر باشد:
eventParameterName

string

این فیلتر بر روی پارامتر رویداد مشخص شده ارزیابی می شود. پارامترهای رویداد به عنوان پارامترهای رویداد ثبت می شوند. پارامترهای رویداد شامل فیلدهایی مانند "firebase_screen" و "currency" است.

پارامترهای رویداد فقط در بخش‌ها و قیف‌ها قابل استفاده هستند و فقط می‌توانند در فیلتر نزولی از یک EventFilter استفاده شوند. در یک فیلتر نزولی از یک EventFilter باید از پارامترهای رویداد یا آیتم استفاده شود.

itemParameterName

string

این فیلتر بر اساس پارامتر مورد مشخص شده ارزیابی می شود. پارامترهای آیتم به عنوان پارامتر در آرایه آیتم ثبت می شوند. پارامترهای مورد شامل فیلدهایی مانند "item_name" و "item_category" هستند.

پارامترهای مورد فقط در بخش‌ها و قیف‌ها قابل استفاده هستند و فقط می‌توانند در فیلتر نزولی از EventFilter استفاده شوند. در یک فیلتر نزولی از یک EventFilter باید از پارامترهای رویداد یا آیتم استفاده شود.

پارامترهای مورد فقط در رویدادهای تجارت الکترونیک در دسترس هستند. برای کسب اطلاعات بیشتر در مورد رویدادهای تجارت الکترونیک، راهنمای اندازه گیری تجارت الکترونیک را ببینید.

فیلد اتحادیه one_filter . یک نوع فیلتر را مشخص کنید. one_filter تنها می تواند یکی از موارد زیر باشد:
stringFilter

object ( StringFilter )

فیلتر مربوط به رشته ها

inListFilter

object ( InListFilter )

فیلتری برای مقادیر در لیست.

numericFilter

object ( NumericFilter )

فیلتری برای مقادیر عددی یا تاریخ.

betweenFilter

object ( BetweenFilter )

یک فیلتر برای بین دو مقدار.

SegmentParameterFilterScoping

محدوده ها مشخص می کنند که چگونه چندین رویداد باید در هنگام ارزیابی فیلتر پارامتر بخش در نظر گرفته شود.

نمایندگی JSON
{
  "inAnyNDayPeriod": string
}
زمینه های
inAnyNDayPeriod

string ( int64 format)

پارامتر را در بازه زمانی مشخص شده از روزهای قبل از اعمال فیلتر جمع می کند. فقط در صورتی پشتیبانی می شود که محدوده معیارها ACROSS_ALL_SESSIONS یا WITHIN_SAME_SESSION باشد. فقط در صورتی پشتیبانی می شود که پارامتر event_count باشد.

برای مثال، اگر inAnyNDayPeriod 3 باشد، eventName "خرید"، پارامتر رویداد "event_count" و معیارهای فیلتر بیشتر از 5 باشد، این فیلتر تعداد رویدادهای خرید را در هر 3 روز متوالی در گزارش جمع می‌کند. محدوده زمانی؛ اگر تعداد رویدادهای خرید او در هر دوره 3 روزه متوالی از 5 بیشتر شود، معیارهای این فیلتر را برای گنجاندن در این بخش پاس می کند. به عنوان مثال، دوره های 2021-11-01 تا 2021-11-03، 2021-11-02 تا 2021-11-04، 2021-11-03 تا 2021-11-05 و غیره در نظر گرفته می شود.

محدوده تاریخ به منظور داشتن یک پنجره کامل N روز نزدیک به شروع محدوده تاریخ تمدید نمی شود. به عنوان مثال اگر گزارشی برای 01-11-2021 تا 2021-11-10 و inAnyNDayPeriod = 3 باشد، دوره دو روزه اول به طور موثر کوتاه می شود زیرا هیچ داده رویدادی خارج از محدوده تاریخ گزارش خوانده نمی شود. به عنوان مثال، چهار دوره اول به طور موثر خواهد بود: 2021-11-01 تا 2021-11-01، 2021-11-01 تا 2021-11-02، 2021-11-01 تا 2021-11-03، و 2021- 11-02 تا 2021-11-04.

inAnyNDayPeriod اختیاری است. اگر مشخص نشده باشد، segmentParameterFilter برای هر رویداد به صورت جداگانه اعمال می شود.

UserSegmentSequenceGroup

شرایطی را تعریف کنید که باید در یک نظم خاص رخ دهد تا کاربر عضوی از بخش باشد.

نمایندگی JSON
{
  "sequenceScoping": enum (UserCriteriaScoping),
  "sequenceMaximumDuration": string,
  "userSequenceSteps": [
    {
      object (UserSequenceStep)
    }
  ]
}
زمینه های
sequenceScoping

enum ( UserCriteriaScoping )

تمام مراحل توالی باید در محدوده مورد نظر رعایت شود تا کاربر با توالی مطابقت داشته باشد. به عنوان مثال، اگر sequenceScoping = USER_CRITERIA_WITHIN_SAME_SESSION ، تمام مراحل دنباله باید در یک جلسه کامل شوند تا کاربر با توالی مطابقت داشته باشد. sequenceScoping = USER_CRITERIA_WITHIN_SAME_EVENT پشتیبانی نمی شود.

اختیاری. اگر مشخص نشده باشد، conditionScoping = ACROSS_ALL_SESSIONS استفاده می شود.

sequenceMaximumDuration

string ( Duration format)

دوره زمانی را که کل دنباله باید در آن اتفاق بیفتد را مشخص می کند. مثلا 30 دقیقه sequenceMaximumDuration شامل نقطه پایانی در دانه بندی میکروثانیه است. به عنوان مثال یک دنباله با حداکثر مدت زمان 5 ثانیه می تواند در 4.9 یا 5.0 ثانیه کامل شود، اما نه 5 ثانیه و 1 میکروثانیه.

sequenceMaximumDuration اختیاری است و اگر مشخص نشده باشد، توالی ها می توانند در هر مدت زمانی تکمیل شوند.

مدت زمان در ثانیه با حداکثر نه رقم کسری که با ' s ' ختم می شود. مثال: "3.5s" .

userSequenceSteps[]

object ( UserSequenceStep )

دنباله ای مرتب از مراحل شرط. رویدادهای کاربر باید هر مرحله را کامل کنند تا کاربر با UserSegmentSequenceGroup مطابقت داشته باشد.

UserSequenceStep

شرایطی که باید در ترتیب مراحل مشخص شده رخ دهد تا این کاربر با توالی مطابقت داشته باشد.

نمایندگی JSON
{
  "isDirectlyFollowedBy": boolean,
  "stepScoping": enum (UserCriteriaScoping),
  "segmentFilterExpression": {
    object (SegmentFilterExpression)
  }
}
زمینه های
isDirectlyFollowedBy

boolean

اگر درست باشد، رویدادی که این مرحله را برآورده می‌کند باید رویداد بعدی بعد از رویدادی باشد که آخرین مرحله را برآورده می‌کند. اگر نادرست باشد، این مرحله به طور غیرمستقیم از مرحله قبل پیروی می کند. برای مثال، ممکن است رویدادهایی بین مرحله قبل و این مرحله وجود داشته باشد. isDirectlyFollowedBy باید برای مرحله اول نادرست باشد.

stepScoping

enum ( UserCriteriaScoping )

برای تطبیق کاربر با توالی، این مرحله توالی باید در محدوده مورد نظر رعایت شود. به عنوان مثال اگر sequenceScoping = WITHIN_SAME_SESSION ، این مراحل دنباله باید در یک جلسه کامل شود تا کاربر بتواند با توالی مطابقت داشته باشد. stepScoping = ACROSS_ALL_SESSIONS فقط در صورتی مجاز است که sequenceScoping = ACROSS_ALL_SESSIONS .

اختیاری. اگر مشخص نشده باشد، stepScoping از همان UserCriteriaScoping به عنوان sequenceScoping استفاده می کند.

segmentFilterExpression

object ( SegmentFilterExpression )

اگر رویدادهای کاربر با این عبارت مطابقت داشته باشند، این مرحله دنباله را مطابقت می دهد. عبارات معیارهای ابعاد، معیارها و/یا پارامترها را بیان می کنند.

UserSegmentExclusion

مشخص می کند کدام کاربران در این بخش مستثنی شده اند.

نمایندگی JSON
{
  "userExclusionDuration": enum (UserExclusionDuration),
  "userExclusionCriteria": {
    object (UserSegmentCriteria)
  }
}
زمینه های
userExclusionDuration

enum ( UserExclusionDuration )

مشخص می‌کند که اگر کاربر با userExclusionCriteria مطابقت داشته باشد، یک طرد چقدر طول خواهد کشید.

اختیاری. اگر مشخص نشده باشد، userExclusionDuration USER_EXCLUSION_TEMPORARY استفاده می شود.

userExclusionCriteria

object ( UserSegmentCriteria )

اگر کاربری این شرایط را داشته باشد، کاربر از عضویت در بخش userExclusionDuration حذف می‌شود.

UserExclusionDuration

در صورتی که کاربر با userExclusionCriteria مطابقت داشته باشد، گزینه‌هایی را برای مدت زمان ماندگاری یک حذف برمی‌شمارد.

Enums
USER_EXCLUSION_DURATION_UNSPECIFIED مدت زمان حذف نامشخص مشخص نکنید.
USER_EXCLUSION_TEMPORARY در دوره‌هایی که کاربر شرایط userExclusionCriteria را دارد، به طور موقت کاربران را از بخش حذف کنید.
USER_EXCLUSION_PERMANENT اگر کاربر شرایط userExclusionCriteria را برآورده کند، برای همیشه کاربران را از بخش حذف کنید.

SessionSegment

بخش‌های جلسه زیرمجموعه‌هایی از جلساتی هستند که در سایت یا برنامه شما رخ داده‌اند: به عنوان مثال، تمام جلساتی که از یک کمپین تبلیغاتی خاص منشا گرفته‌اند.

نمایندگی JSON
{
  "sessionInclusionCriteria": {
    object (SessionSegmentCriteria)
  },
  "exclusion": {
    object (SessionSegmentExclusion)
  }
}
زمینه های
sessionInclusionCriteria

object ( SessionSegmentCriteria )

تعریف می کند که کدام جلسات در این بخش گنجانده شده است. اختیاری.

exclusion

object ( SessionSegmentExclusion )

تعیین می کند کدام جلسات در این بخش حذف می شوند. اختیاری.

معیارهای SessionSegment

در صورتی که رویدادهای جلسه با شرایط موجود در معیارها مطابقت داشته باشند، یک جلسه با یک معیار مطابقت دارد.

نمایندگی JSON
{
  "andConditionGroups": [
    {
      object (SessionSegmentConditionGroup)
    }
  ]
}
زمینه های
andConditionGroups[]

object ( SessionSegmentConditionGroup )

یک جلسه با این معیار مطابقت دارد اگر جلسه با هر یک از این andConditionGroups مطابقت داشته باشد.

SessionSegmentConditionGroup

شرایط به Analytics می‌گوید چه داده‌هایی را در بخش گنجانده یا از آن حذف کند.

نمایندگی JSON
{
  "conditionScoping": enum (SessionCriteriaScoping),
  "segmentFilterExpression": {
    object (SegmentFilterExpression)
  }
}
زمینه های
conditionScoping

enum ( SessionCriteriaScoping )

داده ها بر اساس اینکه با گروه شرایط مطابقت دارند شامل یا از بخش حذف می شوند. این محدوده تعیین می کند که قبل از اینکه گروه شرط مطابقت داشته باشد یا خیر، segmentFilterExpression بر روی چند رویداد ارزیابی می شود. به عنوان مثال، اگر conditionScoping = SESSION_CRITERIA_WITHIN_SAME_SESSION ، عبارت بر روی تمام رویدادهای یک جلسه ارزیابی می‌شود، و سپس، تعیین می‌شود که گروه شرط برای این جلسه مطابقت داشته باشد یا خیر. به عنوان مثال، اگر conditionScoping = SESSION_CRITERIA_WITHIN_SAME_EVENT ، عبارت بر روی یک رویداد واحد ارزیابی می‌شود، و سپس، تعیین می‌شود که گروه شرط برای این جلسه مطابقت داشته باشد یا خیر.

اختیاری. اگر مشخص نشده باشد، از یک conditionScoping WITHIN_SAME_SESSION استفاده می شود.

segmentFilterExpression

object ( SegmentFilterExpression )

داده ها بر اساس مطابقت با این عبارت شامل یا از بخش حذف می شوند. عبارات معیارهای ابعاد، معیارها و/یا پارامترها را بیان می کنند.

Scoping معیارهای جلسه

Scoping مشخص می کند که در صورت رعایت یک جلسه، کدام رویدادها هنگام ارزیابی در نظر گرفته می شوند.

Enums
SESSION_CRITERIA_SCOPING_UNSPECIFIED محدوده معیارهای نامشخص مشخص نکنید.
SESSION_CRITERIA_WITHIN_SAME_EVENT اگر معیارها در یک رویداد برآورده شوند، جلسه با معیارها مطابقت دارد.
SESSION_CRITERIA_WITHIN_SAME_SESSION اگر معیارها در یک جلسه برآورده شود، جلسه با معیارها مطابقت دارد.

SessionSegmentExclusion

مشخص می کند کدام جلسات در این بخش حذف می شوند.

نمایندگی JSON
{
  "sessionExclusionDuration": enum (SessionExclusionDuration),
  "sessionExclusionCriteria": {
    object (SessionSegmentCriteria)
  }
}
زمینه های
sessionExclusionDuration

enum ( SessionExclusionDuration )

مشخص می‌کند که اگر یک جلسه با sessionExclusionCriteria مطابقت داشته باشد، یک محرومیت چقدر طول خواهد کشید.

اختیاری. اگر مشخص نشده باشد، از sessionExclusionDuration SESSION_EXCLUSION_TEMPORARY استفاده می شود.

sessionExclusionCriteria

object ( SessionSegmentCriteria )

اگر جلسه ای این شرط را داشته باشد، جلسه از عضویت در بخش مربوط به sessionExclusionDuration حذف می شود.

SessionExclusionDuration

اگر یک جلسه با sessionExclusionCriteria مطابقت داشته باشد، گزینه‌هایی را برای مدت زمان ماندگاری یک حذف برمی‌شمارد.

Enums
SESSION_EXCLUSION_DURATION_UNSPECIFIED مدت زمان حذف نامشخص مشخص نکنید.
SESSION_EXCLUSION_TEMPORARY در طول دوره هایی که جلسه با شرط sessionExclusionCriteria مطابقت دارد، به طور موقت جلسات را از بخش حذف کنید.
SESSION_EXCLUSION_PERMANENT اگر جلسه با شرط sessionExclusionCriteria مطابقت داشته باشد، به‌طور دائم جلسات را از بخش حذف کنید.

بخش رویداد

بخش‌های رویداد زیرمجموعه‌ای از رویدادهایی هستند که در سایت یا برنامه شما راه‌اندازی شده‌اند. به عنوان مثال، تمام رویدادهای خرید انجام شده در یک مکان خاص؛ رویدادهای app_exception که در یک سیستم عامل خاص رخ داده است.

نمایندگی JSON
{
  "eventInclusionCriteria": {
    object (EventSegmentCriteria)
  },
  "exclusion": {
    object (EventSegmentExclusion)
  }
}
زمینه های
eventInclusionCriteria

object ( EventSegmentCriteria )

تعریف می کند که کدام رویدادها در این بخش گنجانده شده اند. اختیاری.

exclusion

object ( EventSegmentExclusion )

تعریف می کند که کدام رویدادها در این بخش حذف می شوند. اختیاری.

معیارهای بخش رویداد

یک رویداد با یک معیار مطابقت دارد اگر رویداد شرایط موجود در معیارها را داشته باشد.

نمایندگی JSON
{
  "andConditionGroups": [
    {
      object (EventSegmentConditionGroup)
    }
  ]
}
زمینه های
andConditionGroups[]

object ( EventSegmentConditionGroup )

یک رویداد با این معیار مطابقت دارد اگر رویداد با هر یک از این andConditionGroups مطابقت داشته باشد.

EventSegmentConditionGroup

شرایط به Analytics می‌گوید چه داده‌هایی را در بخش گنجانده یا از آن حذف کند.

نمایندگی JSON
{
  "conditionScoping": enum (EventCriteriaScoping),
  "segmentFilterExpression": {
    object (SegmentFilterExpression)
  }
}
زمینه های
conditionScoping

enum ( EventCriteriaScoping )

conditionScoping باید همیشه EVENT_CRITERIA_WITHIN_SAME_EVENT باشد.

اختیاری. اگر مشخص نشده باشد، از یک conditionScoping EVENT_CRITERIA_WITHIN_SAME_EVENT استفاده می شود.

segmentFilterExpression

object ( SegmentFilterExpression )

داده ها بر اساس مطابقت با این عبارت شامل یا از بخش حذف می شوند. عبارات معیارهای ابعاد، معیارها و/یا پارامترها را بیان می کنند.

EventCriteriaScoping

Scoping مشخص می کند که اگر رویدادی معیاری را داشته باشد، چه رویدادهایی در هنگام ارزیابی در نظر گرفته می شوند.

Enums
EVENT_CRITERIA_SCOPING_UNSPECIFIED محدوده معیارهای نامشخص مشخص نکنید.
EVENT_CRITERIA_WITHIN_SAME_EVENT اگر معیارها در یک رویداد برآورده شوند، رویداد با معیارها مطابقت دارد.

EventSegmentExclusion

مشخص می‌کند کدام رویدادها در این بخش حذف می‌شوند.

نمایندگی JSON
{
  "eventExclusionDuration": enum (EventExclusionDuration),
  "eventExclusionCriteria": {
    object (EventSegmentCriteria)
  }
}
زمینه های
eventExclusionDuration

enum ( EventExclusionDuration )

eventExclusionDuration باید همیشه PERMANENTLY_EXCLUDE باشد.

اختیاری. اگر مشخص نشده باشد، یک eventExclusionDuration EVENT_EXCLUSION_PERMANENT استفاده می‌شود.

eventExclusionCriteria

object ( EventSegmentCriteria )

اگر رویدادی دارای این شرط باشد، رویداد از عضویت در بخش eventExclusionDuration حذف می‌شود.

EventExclusionDuration

اگر رویدادی با eventExclusionCriteria مطابقت داشته باشد، گزینه‌هایی را برای مدت زمان ماندگاری یک استثنا برمی‌شمارد.

Enums
EVENT_EXCLUSION_DURATION_UNSPECIFIED مدت زمان حذف نامشخص مشخص نکنید.
EVENT_EXCLUSION_PERMANENT اگر رویداد با شرط eventExclusionCriteria مطابقت داشته باشد، رویدادها را برای همیشه از بخش حذف کنید.

FilterExpression

برای بیان فیلترهای ابعاد یا متریک. فیلدهای موجود در همان FilterExpression باید همه ابعاد یا همه معیارها باشند.

نمایندگی JSON
{

  // Union field expr can be only one of the following:
  "andGroup": {
    object (FilterExpressionList)
  },
  "orGroup": {
    object (FilterExpressionList)
  },
  "notExpression": {
    object (FilterExpression)
  },
  "filter": {
    object (Filter)
  }
  // End of list of possible types for union field expr.
}
زمینه های
expr فیلد اتحادیه یک نوع بیان فیلتر را برای FilterExpression مشخص کنید. expr فقط می تواند یکی از موارد زیر باشد:
andGroup

object ( FilterExpressionList )

FilterExpressions در Andgroup دارای یک رابطه و رابطه است.

orGroup

object ( FilterExpressionList )

FilterExpressions در orgroup دارای یک رابطه یا رابطه است.

notExpression

object ( FilterExpression )

Filterexpression از بیان نیست.

filter

object ( Filter )

یک فیلتر ابتدایی در همان FilterExpression ، تمام نام های فیلتر فیلتر باید همه ابعاد یا تمام معیارها باشد.

فیلتر اکسپرسیون

لیستی از عبارات فیلتر.

نمایندگی JSON
{
  "expressions": [
    {
      object (FilterExpression)
    }
  ]
}
زمینه های
expressions[]

object ( FilterExpression )

لیستی از عبارات فیلتر.

فیلتر کنید

عبارتی برای فیلتر کردن ابعاد یا مقادیر متریک.

نمایندگی JSON
{
  "fieldName": string,

  // Union field one_filter can be only one of the following:
  "stringFilter": {
    object (StringFilter)
  },
  "inListFilter": {
    object (InListFilter)
  },
  "numericFilter": {
    object (NumericFilter)
  },
  "betweenFilter": {
    object (BetweenFilter)
  }
  // End of list of possible types for union field one_filter.
}
زمینه های
fieldName

string

نام ابعاد یا نام متریک. باید نامی باشد که در ابعاد یا معیارها تعریف شده است.

Union Field one_filter . یک نوع فیلتر را برای Filter مشخص کنید. one_filter فقط می تواند یکی از موارد زیر باشد:
stringFilter

object ( StringFilter )

فیلتر مربوط به رشته ها.

inListFilter

object ( InListFilter )

یک فیلتر برای مقادیر لیست.

numericFilter

object ( NumericFilter )

فیلتر برای مقادیر عددی یا تاریخ.

betweenFilter

object ( BetweenFilter )

یک فیلتر برای دو مقدار.

قله

گزارش های زیر قیف حاوی ابعاد و مقادیر داده متریک است. به عنوان مثال ، 12 کاربر به مرحله دوم قیف رسیدند.

نمایندگی JSON
{
  "dimensionHeaders": [
    {
      object (DimensionHeader)
    }
  ],
  "metricHeaders": [
    {
      object (MetricHeader)
    }
  ],
  "rows": [
    {
      object (Row)
    }
  ],
  "metadata": {
    object (FunnelResponseMetadata)
  }
}
زمینه های
dimensionHeaders[]

object ( DimensionHeader )

ستون های ابعاد را توصیف می کند. گزارش های قیف همیشه شامل ابعاد قدم قیف در پاسخ های گزارش زیر است. ابعاد اضافی مانند خرابی ، تاریخ و اقدامات بعدی ممکن است در صورت درخواست در پاسخ وجود داشته باشد.

metricHeaders[]

object ( MetricHeader )

ستون های متریک را توصیف می کند. گزارش های قیف همیشه شامل کاربران فعال در پاسخ های گزارش زیر است. جدول قیف شامل معیارهای اضافی مانند نرخ تکمیل ، رها کردن و نرخ ترک است.

rows[]

object ( Row )

ردیف های ترکیب ارزش ابعاد و مقادیر متریک در گزارش.

metadata

object ( FunnelResponseMetadata )

ابرداده برای گزارش قیف.

پیشرونده ابعاد

یک ستون ابعاد در گزارش را توصیف می کند. ابعاد درخواست شده در یک گزارش ، ورودی های ستون در ردیف ها و ابعاد را تولید می کند. با این حال ، ابعاد مورد استفاده منحصراً در فیلترها یا عبارات در یک گزارش ستون تولید نمی کند. به همین ترتیب ، این ابعاد هدر تولید نمی کند.

نمایندگی JSON
{
  "name": string
}
زمینه های
name

string

نام ابعاد

متراشی

یک ستون متریک در گزارش را توصیف می کند. معیارهای قابل مشاهده که در یک گزارش درخواست شده است ، ورودی های ستون در ردیف ها و metricheaders را تولید می کند. با این حال ، معیارهایی که منحصراً در فیلترها یا عبارات مورد استفاده قرار می گیرند ، در یک گزارش ستون تولید نمی کنند. به همین ترتیب ، این معیارها هدر تولید نمی کنند.

نمایندگی JSON
{
  "name": string,
  "type": enum (MetricType)
}
زمینه های
name

string

نام متریک

type

enum ( MetricType )

نوع داده متریک.

از نوع

یک نوع ارزش متریک.

Enums
METRIC_TYPE_UNSPECIFIED نوع نامشخص
TYPE_INTEGER نوع عدد صحیح
TYPE_FLOAT نوع نقطه شناور.
TYPE_SECONDS مدت زمان ثانیه ؛ یک نوع نقطه شناور خاص.
TYPE_MILLISECONDS مدت زمان در میلی ثانیه ؛ یک نوع نقطه شناور خاص.
TYPE_MINUTES مدت زمان در دقیقه ؛ یک نوع نقطه شناور خاص.
TYPE_HOURS مدت زمان ساعت ؛ یک نوع نقطه شناور خاص.
TYPE_STANDARD یک متریک سفارشی از نوع استاندارد ؛ یک نوع نقطه شناور خاص.
TYPE_CURRENCY مقدار پول ؛ یک نوع نقطه شناور خاص.
TYPE_FEET طول در پا ؛ یک نوع نقطه شناور خاص.
TYPE_MILES طول در مایل ؛ یک نوع نقطه شناور خاص.
TYPE_METERS طول در متر ؛ یک نوع نقطه شناور خاص.
TYPE_KILOMETERS طول در کیلومتر ؛ یک نوع نقطه شناور خاص.

ردیف

داده ها را برای هر ردیف گزارش دهید. به عنوان مثال اگر Runreportrequest شامل:

"dimensions": [
  {
    "name": "eventName"
  },
  {
    "name": "countryId"
  }
],
"metrics": [
  {
    "name": "eventCount"
  }
]

یک ردیف با "IN_APP_PURCHASE" به عنوان نام EventName ، "JP" به عنوان کشور و 15 به عنوان EventCount خواهد بود:

"dimensionValues": [
  {
    "value": "in_app_purchase"
  },
  {
    "value": "JP"
  }
],
"metricValues": [
  {
    "value": "15"
  }
]
نمایندگی JSON
{
  "dimensionValues": [
    {
      object (DimensionValue)
    }
  ],
  "metricValues": [
    {
      object (MetricValue)
    }
  ]
}
زمینه های
dimensionValues[]

object ( DimensionValue )

لیست مقادیر ابعاد درخواستی. در یک PivotReport ، DimensionValues ​​فقط برای ابعاد موجود در یک محوری ذکر شده است.

metricValues[]

object ( MetricValue )

لیست مقادیر متریک قابل مشاهده.

ابعاد ابعادی

مقدار یک بعد.

نمایندگی JSON
{

  // Union field one_value can be only one of the following:
  "value": string
  // End of list of possible types for union field one_value.
}
زمینه های
Union Field one_value . یک نوع مقدار ابعاد one_value فقط می تواند یکی از موارد زیر باشد:
value

string

مقدار به عنوان یک رشته اگر نوع ابعاد یک رشته است.

مقادیر متراکم

ارزش یک متریک.

نمایندگی JSON
{

  // Union field one_value can be only one of the following:
  "value": string
  // End of list of possible types for union field one_value.
}
زمینه های
Union Field one_value . یکی از ارزش های متریک one_value فقط می تواند یکی از موارد زیر باشد:
value

string

ارزش اندازه گیری برای نوع به Metricheader مراجعه کنید.

FunnelResponseMetadata

پاسخ گزارش قیف ، ابرداده اطلاعات اضافی در مورد گزارش قیف دارد.

نمایندگی JSON
{
  "samplingMetadatas": [
    {
      object (SamplingMetadata)
    }
  ]
}
زمینه های
samplingMetadatas[]

object ( SamplingMetadata )

اگر نتایج گزارش قیف نمونه برداری شود ، این توصیف می کند که درصد از وقایع در این گزارش قیف استفاده شده است. یک samplingMetadatas برای هر محدوده تاریخ جمع شده است. هر samplingMetadatas با یک محدوده تاریخ مطابقت دارد به منظور مشخص شدن محدوده تاریخ در درخواست.

اما اگر نتایج نمونه برداری نشود ، این قسمت تعریف نمی شود.

نمونه گیری

اگر نتایج گزارش قیف نمونه برداری شود ، این ابرداده توصیف می کند که درصد از وقایع در این گزارش قیف برای محدوده تاریخ استفاده شده است. نمونه برداری عمل تجزیه و تحلیل زیر مجموعه ای از داده ها به منظور کشف اطلاعات معنی دار در مجموعه داده های بزرگتر است.

نمایندگی JSON
{
  "samplesReadCount": string,
  "samplingSpaceSize": string
}
زمینه های
samplesReadCount

string ( int64 format)

تعداد کل وقایع خوانده شده در این گزارش نمونه برداری برای محدوده تاریخ. این اندازه زیر مجموعه داده های این ویژگی است که در این گزارش قیف مورد تجزیه و تحلیل قرار گرفته است.

samplingSpaceSize

string ( int64 format)

تعداد کل رویدادهای موجود در داده های این ویژگی که می توان در این گزارش قیف برای محدوده تاریخ مورد تجزیه و تحلیل قرار گرفت. نمونه برداری اطلاعات معنی دار در مورد مجموعه داده های بزرگتر را کشف می کند ، و این اندازه مجموعه داده های بزرگتر است.

برای محاسبه درصد داده های موجود که در این گزارش قیف استفاده شده است ، samplesReadCount/samplingSpaceSize را محاسبه کنید.

دارایی

وضعیت فعلی همه سهمیه ها برای این خاصیت تحلیلی. اگر سهمیه ای برای یک ملک خسته شود ، تمام درخواست های مربوط به آن ملک خطاهای خسته شده منابع را برمی گرداند.

نمایندگی JSON
{
  "tokensPerDay": {
    object (QuotaStatus)
  },
  "tokensPerHour": {
    object (QuotaStatus)
  },
  "concurrentRequests": {
    object (QuotaStatus)
  },
  "serverErrorsPerProjectPerHour": {
    object (QuotaStatus)
  },
  "potentiallyThresholdedRequestsPerHour": {
    object (QuotaStatus)
  },
  "tokensPerProjectPerHour": {
    object (QuotaStatus)
  }
}
زمینه های
tokensPerDay

object ( QuotaStatus )

خواص استاندارد تجزیه و تحلیل می تواند تا 200000 نشانه در روز استفاده کند. Analytics 360 ویژگی می تواند از 2000،000 نشانه در روز استفاده کند. بیشتر درخواست ها کمتر از 10 نشانه مصرف می کنند.

tokensPerHour

object ( QuotaStatus )

خواص استاندارد تجزیه و تحلیل می تواند تا 40،000 نشانه در ساعت استفاده کند. Analytics 360 ویژگی می تواند از 400000 نشانه در ساعت استفاده کند. یک درخواست API تعداد زیادی از نشانه ها را مصرف می کند و این تعداد از همه سهمیه های ساعتی ، روزانه و هر پروژه کسر می شود.

concurrentRequests

object ( QuotaStatus )

ویژگی های استاندارد تجزیه و تحلیل می توانند حداکثر 10 درخواست همزمان ارسال کنند. ویژگی های Analytics 360 می توانند از 50 درخواست همزمان استفاده کنند.

serverErrorsPerProjectPerHour

object ( QuotaStatus )

ویژگی های استاندارد تجزیه و تحلیل و جفت پروژه های ابری می توانند حداکثر 10 خطای سرور در ساعت داشته باشند. ویژگی های Analytics 360 و جفت پروژه Cloud می توانند حداکثر 50 خطای سرور در ساعت داشته باشند.

potentiallyThresholdedRequestsPerHour

object ( QuotaStatus )

ویژگی های تحلیلی می توانند حداکثر 120 درخواست با ابعاد آستانه بالقوه در ساعت ارسال کنند. در درخواست دسته ای ، در صورت درخواست درخواست حاوی ابعاد آستانه بالقوه ، هر درخواست گزارش به صورت جداگانه برای این سهمیه حساب می شود.

tokensPerProjectPerHour

object ( QuotaStatus )

خواص تجزیه و تحلیل می تواند تا 35 ٪ از نشانه های خود را در هر پروژه در ساعت استفاده کند. این به خصوصیات استاندارد تجزیه و تحلیل می تواند تا 14000 نشانه در هر پروژه در ساعت استفاده کند و 360 ویژگی Analytics می تواند از 140،000 نشانه در هر پروژه در ساعت استفاده کند. یک درخواست API تعداد واحد توکن را مصرف می کند و این تعداد از همه سهمیه های ساعتی ، روزانه و در هر پروژه کسر می شود.

نقل قول

وضعیت فعلی برای یک گروه سهمیه خاص.

نمایندگی JSON
{
  "consumed": integer,
  "remaining": integer
}
زمینه های
consumed

integer

سهمیه مصرف شده توسط این درخواست.

remaining

integer

سهمیه باقی مانده پس از این درخواست.