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

قیف

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

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

نمایندگی 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 )

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

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 تجاوز کند.

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 مطابقت داشته باشد، رویدادها را برای همیشه از بخش حذف کنید.

FunnelSubReport

گزارش‌های فرعی قیف حاوی مقادیر داده‌های ابعاد و متریک است. به عنوان مثال، 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 )

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

FunnelResponseMetadata

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

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

object ( SamplingMetadata )

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

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

Sampling Metadata

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

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

string ( int64 format)

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

samplingSpaceSize

string ( int64 format)

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

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

سهمیه ملک

وضعیت فعلی همه سهمیه‌ها برای این ویژگی Analytics. اگر هر سهمیه ای برای یک دارایی تمام شود، همه درخواست ها به آن ویژگی خطاهای Resource Exhausted را برمی گرداند.

نمایندگی 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 Properties می تواند از 2000000 توکن در روز استفاده کند. اکثر درخواست ها کمتر از 10 توکن مصرف می کنند.

tokensPerHour

object ( QuotaStatus )

ویژگی های استاندارد آنالیتیکس می تواند تا 40000 توکن در ساعت استفاده کند. Analytics 360 Properties می تواند از 400000 توکن در ساعت استفاده کند. یک درخواست API یک تعداد توکن مصرف می کند و این تعداد از تمام سهمیه های ساعتی، روزانه و هر پروژه کسر می شود.

concurrentRequests

object ( QuotaStatus )

ویژگی های استاندارد آنالیتیکس می تواند حداکثر 10 درخواست همزمان ارسال کند. Analytics 360 Properties می تواند از 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

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