- درخواست HTTP
- پارامترهای مسیر
- درخواست بدن
- بدن پاسخگو
- محدوده مجوز
- قیف
- FunnelStep
- FunnelFilterExpression
- FunnelFilterExpressionList
- FunnelFieldFilter
- FunnelEventFilter
- FunnelParameterFilterExpression
- FunnelParameterFilterExpressionList
- FunnelParameterFilter
- Funnel Breakdown
- FunnelNextAction
- FunnelVisualizationType
- بخش
- بخش کاربر
- UserSegmentCriteria
- UserSegmentConditionGroup
- UserCriteriaScoping
- SegmentFilterExpression
- SegmentFilterExpressionList
- بخش فیلتر
- SegmentFilterScoping
- SegmentEventFilter
- SegmentParameterFilterExpression
- SegmentParameterFilterExpressionList
- SegmentParameterFilter
- SegmentParameterFilterScoping
- UserSegmentSequenceGroup
- UserSequenceStep
- UserSegmentExclusion
- UserExclusionDuration
- SessionSegment
- معیارهای SessionSegment
- SessionSegmentConditionGroup
- Scoping معیارهای جلسه
- SessionSegmentExclusion
- SessionExclusionDuration
- بخش رویداد
- معیارهای بخش رویداد
- EventSegmentConditionGroup
- EventCriteriaScoping
- EventSegmentExclusion
- EventExclusionDuration
- FunnelSubReport
- FunnelResponseMetadata
- Sampling Metadata
- سهمیه ملک
- وضعیت سهمیه
- آن را امتحان کنید!
گزارش قیف سفارشی دادههای رویداد Google Analytics شما را برمیگرداند. داده های برگردانده شده از API به صورت جدولی با ستون هایی برای ابعاد و معیارهای درخواستی است.
کاوش قیف به شما این امکان را میدهد تا مراحلی را که کاربران برای تکمیل یک کار برمیدارند تجسم کنید و به سرعت ببینید که در هر مرحله چقدر موفق یا شکست میخورند. به عنوان مثال، چگونه مشتریان بالقوه خریدار و سپس خریدار می شوند؟ چگونه خریداران یکباره تبدیل به خریداران تکراری می شوند؟ با این اطلاعات، می توانید سفرهای ناکارآمد یا رها شده مشتریان را بهبود ببخشید. برای کسب اطلاعات بیشتر، به کاوشهای قیف GA4 مراجعه کنید.
این روش در ثبات آلفا با هدف جمعآوری بازخورد در نحو و قابلیتها قبل از ورود به بتا معرفی شده است. برای ارائه بازخورد خود در مورد این API، بازخورد گزارش قیف Google Analytics Data API را تکمیل کنید.
درخواست HTTP
POST https://analyticsdata.googleapis.com/v1alpha/{property=properties/*}:runFunnelReport
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
پارامترها | |
---|---|
property | اختیاری. شناسه دارایی Google Analytics GA4 که رویدادهای آن ردیابی می شوند. در مسیر URL و نه بدنه مشخص شده است. برای کسب اطلاعات بیشتر، ببینید شناسه ملک خود را از کجا پیدا کنید . در یک درخواست دسته ای، این ویژگی یا باید نامشخص باشد یا با ویژگی سطح دسته ای سازگار باشد. مثال: خواص/1234 |
درخواست بدن
بدنه درخواست حاوی داده هایی با ساختار زیر است:
نمایندگی JSON |
---|
{ "dateRanges": [ { object ( |
فیلدها | |
---|---|
dateRanges[] | اختیاری. محدوده تاریخ داده برای خواندن. اگر چندین محدوده تاریخ درخواست شود، هر ردیف پاسخ حاوی یک شاخص محدوده تاریخ مبتنی بر صفر خواهد بود. اگر دو محدوده تاریخ همپوشانی داشته باشند، دادههای رویداد برای روزهای همپوشانی در ردیفهای پاسخ برای هر دو محدوده تاریخ گنجانده میشود. |
funnel | اختیاری. پیکربندی قیف این درخواست. این پیکربندی قیف مورد نیاز است. |
funnelBreakdown | اختیاری. اگر مشخص شده باشد، این تفکیک بعد به پاسخ گزارش فرعی جدول قیف اضافه می کند. این بعد تجزیه هر مرحله قیف را به مقادیر منحصر به فرد بعد شکست گسترش می دهد. برای مثال، تفکیک بر اساس بعد |
funnelNextAction | اختیاری. در صورت مشخص شدن، اقدام بعدی یک بعد به پاسخ گزارش فرعی تجسم قیف اضافه می کند. این بعد اقدام بعدی هر مرحله قیف را به مقادیر منحصر به فرد اقدام بعدی گسترش می دهد. به عنوان مثال، اقدام بعدی بعد اقدام بعدی فقط |
funnelVisualizationType | اختیاری. نوع تجسم قیف ابعاد موجود در پاسخ گزارش فرعی تجسم قیف را کنترل می کند. اگر مشخص نشده باشد، |
segments[] | اختیاری. تنظیمات بخش ها بخشها زیرمجموعهای از دادههای یک ویژگی هستند. در یک گزارش قیف با بخش ها، قیف در هر بخش ارزیابی می شود. هر بخش مشخص شده در این درخواست یک ردیف جداگانه در پاسخ ایجاد می کند. در پاسخ، هر بخش با نام خود مشخص شد. پارامتر segments اختیاری است. درخواست ها به 4 بخش محدود می شود. |
limit | اختیاری. تعداد ردیف هایی که باید برگردانده شوند. اگر مشخص نشده باشد، 10000 ردیف برگردانده می شود. API حداکثر 250000 سطر را در هر درخواست برمی گرداند، مهم نیست که چقدر درخواست کنید. API همچنین میتواند ردیفهای کمتری را نسبت به |
dimensionFilter | اختیاری. فیلترهای ابعاد به شما امکان می دهند فقط مقادیر ابعاد خاصی را در گزارش بخواهید. برای کسب اطلاعات بیشتر، برای مثال به ایجاد گزارش: فیلترهای ابعاد مراجعه کنید. معیارها را نمی توان در این فیلتر استفاده کرد. |
returnPropertyQuota | اختیاری. وضعیت فعلی سهمیه این Analytics Property را تغییر میدهد یا خیر. سهمیه در PropertyQuota برگردانده می شود. |
بدن پاسخگو
پاسخ گزارش قیف شامل دو گزارش فرعی است. دو گزارش فرعی ترکیبی متفاوت از ابعاد و معیارها هستند.
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:
نمایندگی JSON |
---|
{ "funnelTable": { object ( |
فیلدها | |
---|---|
funnelTable | جدول قیف گزارشی با مرحله قیف، بخش، بعد شکست، کاربران فعال، نرخ تکمیل، رها شدن و نرخ رهاسازی است. بعد بخش فقط در صورت درخواست بخش در این پاسخ وجود دارد. بعد شکست فقط در صورت درخواست در این پاسخ وجود دارد. |
funnelVisualization | تجسم قیف یک گزارش با مرحله قیف، بخش، تاریخ، بعد اقدام بعدی و کاربران فعال است. بعد بخش فقط در صورت درخواست بخش در این پاسخ وجود دارد. بعد تاریخ فقط در صورتی در این پاسخ وجود دارد که از طریق نوع قیف |
propertyQuota | وضعیت سهمیه این Analytics Property شامل این درخواست است. |
kind | مشخص می کند که این پیام چه نوع منبعی است. این |
محدوده مجوز
به یکی از حوزه های OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/analytics.readonly
-
https://www.googleapis.com/auth/analytics
قیف
قیف را در یک درخواست گزارش قیف پیکربندی می کند. یک قیف در حین گذر از مراحل متوالی از کاربران گزارش می دهد.
کاوش قیف به شما این امکان را میدهد تا مراحلی را که کاربران برای تکمیل یک کار برمیدارند تجسم کنید و به سرعت ببینید که در هر مرحله چقدر موفق یا شکست میخورند. به عنوان مثال، چگونه مشتریان بالقوه خریدار و سپس خریدار می شوند؟ چگونه خریداران یکباره تبدیل به خریداران تکراری می شوند؟ با این اطلاعات، می توانید سفرهای ناکارآمد یا رها شده مشتریان را بهبود ببخشید.
نمایندگی JSON |
---|
{
"isOpenFunnel": boolean,
"steps": [
{
object ( |
فیلدها | |
---|---|
isOpenFunnel | در قیف باز کاربران در هر مرحله می توانند وارد قیف شوند و در قیف بسته کاربران باید در مرحله اول وارد قیف شوند. اختیاری. اگر مشخص نباشد، از یک قیف بسته استفاده می شود. |
steps[] | مراحل متوالی این قیف. |
FunnelStep
مراحل سفر کاربر را که می خواهید اندازه گیری کنید، مشخص می کند. مراحل شامل یک یا چند شرط است که کاربران شما باید آنها را داشته باشند تا در آن مرحله از سفر قیف قرار گیرند.
نمایندگی JSON |
---|
{
"name": string,
"isDirectlyFollowedBy": boolean,
"filterExpression": {
object ( |
فیلدها | |
---|---|
name | نام متمایز این مرحله. اگر نامشخص باشد، مراحل با یک نام نمایه شده بر اساس 1 نامگذاری می شوند (به عنوان مثال "0."، "1."، و غیره). این نام مقدار رشته ای را که توسط بعد |
isDirectlyFollowedBy | اگر درست باشد، این مرحله باید مستقیماً از مرحله قبل پیروی کند. اگر نادرست باشد، ممکن است رویدادهایی بین مرحله قبل و این مرحله وجود داشته باشد. اگر مشخص نشده باشد، |
filterExpression | شرطی که کاربران شما باید داشته باشند تا در این مرحله از سفر قیف قرار گیرند. |
withinDurationFromPriorStep | اگر مشخص شده باشد، این مرحله باید در این مدت از اتمام مرحله قبلی کامل شود. مدت زمان در ثانیه با حداکثر نه رقم کسری که با ' |
FunnelFilterExpression
ترکیبی از فیلترهای قیف را بیان می کند.
نمایندگی JSON |
---|
{ // Union field |
فیلدها | |
---|---|
expr فیلد اتحادیه یک نوع فیلتر را برای FunnelFilterExpression مشخص کنید. expr می تواند تنها یکی از موارد زیر باشد: | |
andGroup | FunnelFilterExpression در |
orGroup | FunnelFilterExpression در |
notExpression | FunnelFilterExpression از |
funnelFieldFilter | یک فیلتر قیف برای یک بعد یا متریک. |
funnelEventFilter | فیلتری ایجاد می کند که رویدادهای یک نام رویداد را مطابقت دهد. اگر یک عبارت فیلتر پارامتر مشخص شده باشد، فقط زیرمجموعه رویدادهایی که با نام رویداد واحد و عبارات فیلتر پارامتر مطابقت دارند با این فیلتر رویداد مطابقت دارند. |
FunnelFilterExpressionList
لیستی از عبارات فیلتر قیف.
نمایندگی JSON |
---|
{
"expressions": [
{
object ( |
فیلدها | |
---|---|
expressions[] | لیست عبارات فیلتر قیف. |
FunnelFieldFilter
عبارتی برای فیلتر ابعاد یا مقادیر متریک.
نمایندگی JSON |
---|
{ "fieldName": string, // Union field |
فیلدها | |
---|---|
fieldName | نام ابعاد یا نام متریک. |
فیلد اتحادیه one_filter . یک نوع فیلتر را مشخص کنید. one_filter تنها می تواند یکی از موارد زیر باشد: | |
stringFilter | فیلتر مربوط به رشته ها |
inListFilter | فیلتری برای مقادیر در لیست. |
numericFilter | فیلتری برای مقادیر عددی یا تاریخ. |
betweenFilter | یک فیلتر برای بین دو مقدار. |
FunnelEventFilter
فیلتری ایجاد می کند که رویدادهای یک نام رویداد را مطابقت دهد. اگر یک عبارت فیلتر پارامتر مشخص شده باشد، فقط زیرمجموعه رویدادهایی که با نام رویداد واحد و عبارات فیلتر پارامتر مطابقت دارند با این فیلتر رویداد مطابقت دارند.
نمایندگی JSON |
---|
{
"eventName": string,
"funnelParameterFilterExpression": {
object ( |
فیلدها | |
---|---|
eventName | این فیلتر رویدادهای این نام رویداد را منطبق میکند. نام رویداد الزامی است. |
funnelParameterFilterExpression | اگر مشخص شده باشد، این فیلتر با رویدادهایی مطابقت دارد که با نام رویداد واحد و عبارات فیلتر پارامتر مطابقت دارند. در داخل عبارت فیلتر پارامتر، فقط فیلترهای پارامتر موجود است. |
FunnelParameterFilterExpression
ترکیبی از فیلترهای قیف را بر روی پارامترها بیان می کند.
نمایندگی JSON |
---|
{ // Union field |
فیلدها | |
---|---|
expr فیلد اتحادیه یک نوع فیلتر را برای FunnelParameterFilterExpression مشخص کنید. expr می تواند تنها یکی از موارد زیر باشد: | |
andGroup | FunnelParameterFilterExpression در |
orGroup | FunnelParameterFilterExpression در |
notExpression | FunnelParameterFilterExpression از |
funnelParameterFilter | یک فیلتر پارامتر قیف اولیه. |
FunnelParameterFilterExpressionList
فهرستی از عبارات فیلتر پارامتر قیف.
نمایندگی JSON |
---|
{
"expressions": [
{
object ( |
فیلدها | |
---|---|
expressions[] | فهرست عبارات فیلتر پارامتر قیف. |
FunnelParameterFilter
عبارتی برای فیلتر کردن مقادیر پارامتر در یک قیف.
نمایندگی JSON |
---|
{ // Union field |
فیلدها | |
---|---|
فیلد اتحادیه one_parameter . فیلدی که در حال فیلتر شدن است. one_parameter می تواند تنها یکی از موارد زیر باشد: | |
eventParameterName | این فیلتر بر روی پارامتر رویداد مشخص شده ارزیابی می شود. پارامترهای رویداد به عنوان پارامترهای رویداد ثبت می شوند. پارامترهای رویداد شامل فیلدهایی مانند "firebase_screen" و "currency" است. پارامترهای رویداد فقط در بخشها و قیفها قابل استفاده هستند و فقط میتوانند در فیلتر نزولی از یک EventFilter استفاده شوند. در یک فیلتر نزولی از یک EventFilter باید از پارامترهای رویداد یا آیتم استفاده شود. |
itemParameterName | این فیلتر بر اساس پارامتر مورد مشخص شده ارزیابی می شود. پارامترهای آیتم به عنوان پارامتر در آرایه آیتم ثبت می شوند. پارامترهای مورد شامل فیلدهایی مانند "item_name" و "item_category" هستند. پارامترهای مورد فقط در بخشها و قیفها قابل استفاده هستند و فقط میتوانند در فیلتر نزولی از EventFilter استفاده شوند. در یک فیلتر نزولی از یک EventFilter باید از پارامترهای رویداد یا آیتم استفاده شود. پارامترهای مورد فقط در رویدادهای تجارت الکترونیک در دسترس هستند. برای کسب اطلاعات بیشتر در مورد رویدادهای تجارت الکترونیک، راهنمای اندازه گیری تجارت الکترونیک را ببینید. |
فیلد اتحادیه one_filter . یک نوع فیلتر را مشخص کنید. one_filter تنها می تواند یکی از موارد زیر باشد: | |
stringFilter | فیلتر مربوط به رشته ها |
inListFilter | فیلتری برای مقادیر در لیست. |
numericFilter | فیلتری برای مقادیر عددی یا تاریخ. |
betweenFilter | یک فیلتر برای بین دو مقدار. |
Funnel Breakdown
خرابی ها به پاسخ گزارش فرعی جدول قیف بعد می افزایند.
نمایندگی JSON |
---|
{
"breakdownDimension": {
object ( |
فیلدها | |
---|---|
breakdownDimension | ستون ابعاد به پاسخ گزارش فرعی جدول قیف اضافه شد. بعد شکست هر مرحله قیف را تجزیه می کند. اگر |
limit | حداکثر تعداد مقادیر متمایز بعد شکست که در پاسخ بازگردانده می شود. اگر محدودیت مشخص نشده باشد از |
FunnelNextAction
اقدامات بعدی مقدار یک بعد را بعد از رسیدن کاربر به یک مرحله اما قبل از رسیدن همان کاربر به مرحله بعدی نشان می دهد. به عنوان مثال، اگر nextActionDimension
eventName
باشد، nextActionDimension
در ردیف مرحله قیف i
اولین رویداد را پس از رویدادی که کاربر را به مرحله قیف i
م واجد شرایط میکند، اما قبل از رسیدن کاربر به مرحله i+1
قیف برمیگرداند.
نمایندگی JSON |
---|
{
"nextActionDimension": {
object ( |
فیلدها | |
---|---|
nextActionDimension | ستون بعد به پاسخ گزارش فرعی تجسم قیف اضافه شد. بعد اقدام بعدی بعد از اینکه کاربر به مرحله |
limit | حداکثر تعداد مقادیر متمایز بعد شکست که در پاسخ بازگردانده می شود. اگر محدودیت مشخص نشده باشد از |
FunnelVisualizationType
ابعاد موجود در پاسخ گزارش فرعی تجسم قیف را کنترل می کند.
Enums | |
---|---|
FUNNEL_VISUALIZATION_TYPE_UNSPECIFIED | نوع نامشخص |
STANDARD_FUNNEL | یک قیف استاندارد (پله ای). گزارش فرعی تجسم قیف در پاسخ حاوی تاریخ نخواهد بود. |
TRENDED_FUNNEL | یک قیف ترند (نمودار خطی). گزارش فرعی تجسم قیف در پاسخ حاوی بعد تاریخ خواهد بود. |
بخش
یک بخش زیرمجموعه ای از داده های Analytics شما است. برای مثال، از کل مجموعه کاربران شما، یک بخش ممکن است کاربران یک کشور یا شهر خاص باشد. بخش دیگر ممکن است کاربرانی باشند که خط خاصی از محصولات را خریداری می کنند یا از بخش خاصی از سایت شما بازدید می کنند یا رویدادهای خاصی را در برنامه شما راه اندازی می کنند.
برای کسب اطلاعات بیشتر، بخش ساز GA4 را ببینید.
نمایندگی JSON |
---|
{ "name": string, // Union field |
فیلدها | |
---|---|
name | نام این بخش اگر نامشخص باشد، بخشها «بخش» نامیده میشوند. این نام مقدار رشته ای را که توسط بعد |
فیلد اتحادیه one_segment_scope . یک بخش در یک محدوده مشخص شده است. one_segment_scope تنها می تواند یکی از موارد زیر باشد: | |
userSegment | بخشهای کاربر زیرمجموعهای از کاربرانی هستند که با سایت یا برنامه شما درگیر هستند. |
sessionSegment | بخشهای جلسه زیرمجموعههایی از جلساتی هستند که در سایت یا برنامه شما رخ دادهاند. |
eventSegment | بخشهای رویداد زیرمجموعهای از رویدادهایی هستند که در سایت یا برنامه شما راهاندازی شدهاند. |
بخش کاربر
بخشهای کاربر زیرمجموعهای از کاربرانی هستند که با سایت یا برنامه شما درگیر هستند. به عنوان مثال، کاربرانی که قبلا خرید کرده اند؛ کاربرانی که مواردی را به سبد خرید خود اضافه کردهاند، اما خریدی را تکمیل نکردهاند.
نمایندگی JSON |
---|
{ "userInclusionCriteria": { object ( |
فیلدها | |
---|---|
userInclusionCriteria | مشخص می کند که چه کاربرانی در این بخش قرار می گیرند. اختیاری. |
exclusion | مشخص می کند کدام کاربران در این بخش مستثنی هستند. اختیاری. |
UserSegmentCriteria
اگر رویدادهای کاربر شرایط موجود در معیارها را داشته باشند، یک کاربر با یک معیار مطابقت دارد.
نمایندگی JSON |
---|
{ "andConditionGroups": [ { object ( |
فیلدها | |
---|---|
andConditionGroups[] | اگر کاربر با هر یک از این |
andSequenceGroups[] | اگر کاربر با هر یک از این |
UserSegmentConditionGroup
شرایط به Analytics میگوید چه دادههایی را در بخش گنجانده یا از آن حذف کند.
نمایندگی JSON |
---|
{ "conditionScoping": enum ( |
فیلدها | |
---|---|
conditionScoping | داده ها بر اساس اینکه با گروه شرایط مطابقت دارند شامل یا از بخش حذف می شوند. این محدوده تعیین می کند که قبل از اینکه گروه شرط مطابقت داشته باشد یا خیر، اختیاری. اگر مشخص نشده باشد، |
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 فیلد اتحادیه یک نوع فیلتر را برای SegmentFilterExpression مشخص کنید. expr می تواند تنها یکی از موارد زیر باشد: | |
andGroup | SegmentFilterExpression در |
orGroup | SegmentFilterExpression در |
notExpression | SegmentFilterExpression مربوط به |
segmentFilter | یک فیلتر بخش اولیه |
segmentEventFilter | فیلتری ایجاد می کند که رویدادهای یک نام رویداد را مطابقت دهد. اگر یک عبارت فیلتر پارامتر مشخص شده باشد، فقط زیرمجموعه رویدادهایی که با نام رویداد واحد و عبارات فیلتر پارامتر مطابقت دارند با این فیلتر رویداد مطابقت دارند. |
SegmentFilterExpressionList
لیستی از عبارات فیلتر بخش.
نمایندگی JSON |
---|
{
"expressions": [
{
object ( |
فیلدها | |
---|---|
expressions[] | لیست عبارات فیلتر بخش |
بخش فیلتر
عبارتی برای فیلتر ابعاد یا مقادیر متریک.
نمایندگی JSON |
---|
{ "fieldName": string, "filterScoping": { object ( |
فیلدها | |
---|---|
fieldName | نام ابعاد یا نام متریک. |
filterScoping | محدوده فیلتر را مشخص می کند. |
فیلد اتحادیه one_filter . یک نوع فیلتر را برای Filter مشخص کنید. one_filter تنها می تواند یکی از موارد زیر باشد: | |
stringFilter | فیلتر مربوط به رشته ها |
inListFilter | فیلتری برای مقادیر در لیست. |
numericFilter | فیلتری برای مقادیر عددی یا تاریخ. |
betweenFilter | یک فیلتر برای بین دو مقدار. |
SegmentFilterScoping
محدودهها مشخص میکنند که چگونه ابعاد و معیارهای رویدادهای متعدد هنگام ارزیابی یک فیلتر بخش در نظر گرفته شود.
نمایندگی JSON |
---|
{ "atAnyPointInTime": boolean } |
فیلدها | |
---|---|
atAnyPointInTime | اگر این پارامتر این اگر محدوده معیار |
SegmentEventFilter
فیلتری ایجاد می کند که رویدادهای یک نام رویداد را مطابقت دهد. اگر یک عبارت فیلتر پارامتر مشخص شده باشد، فقط زیرمجموعه رویدادهایی که با نام رویداد واحد و عبارات فیلتر پارامتر مطابقت دارند با این فیلتر رویداد مطابقت دارند.
نمایندگی JSON |
---|
{
"eventName": string,
"segmentParameterFilterExpression": {
object ( |
فیلدها | |
---|---|
eventName | این فیلتر رویدادهای این نام رویداد را منطبق میکند. نام رویداد الزامی است. |
segmentParameterFilterExpression | اگر مشخص شده باشد، این فیلتر با رویدادهایی مطابقت دارد که با نام رویداد واحد و عبارات فیلتر پارامتر مطابقت دارند. در داخل عبارت فیلتر پارامتر، فقط فیلترهای پارامتر موجود است. |
SegmentParameterFilterExpression
ترکیبی از فیلتر بخش را بر روی پارامترها بیان می کند.
نمایندگی JSON |
---|
{ // Union field |
فیلدها | |
---|---|
expr فیلد اتحادیه یک نوع فیلتر را برای SegmentParameterFilterExpression مشخص کنید. expr می تواند تنها یکی از موارد زیر باشد: | |
andGroup | SegmentParameterFilterExpression در |
orGroup | SegmentParameterFilterExpression در |
notExpression | SegmentParameterFilterExpression از |
segmentParameterFilter | یک فیلتر پارامتر بخش اولیه |
SegmentParameterFilterExpressionList
لیستی از عبارات فیلتر پارامتر بخش.
نمایندگی JSON |
---|
{
"expressions": [
{
object ( |
فیلدها | |
---|---|
expressions[] | لیست عبارات فیلتر پارامتر بخش. |
SegmentParameterFilter
عبارتی برای فیلتر کردن مقادیر پارامتر در یک بخش.
نمایندگی JSON |
---|
{ "filterScoping": { object ( |
فیلدها | |
---|---|
filterScoping | محدوده فیلتر را مشخص می کند. |
فیلد اتحادیه one_parameter . فیلدی که در حال فیلتر شدن است. one_parameter می تواند تنها یکی از موارد زیر باشد: | |
eventParameterName | این فیلتر بر روی پارامتر رویداد مشخص شده ارزیابی می شود. پارامترهای رویداد به عنوان پارامترهای رویداد ثبت می شوند. پارامترهای رویداد شامل فیلدهایی مانند "firebase_screen" و "currency" است. پارامترهای رویداد فقط در بخشها و قیفها قابل استفاده هستند و فقط میتوانند در فیلتر نزولی از یک EventFilter استفاده شوند. در یک فیلتر نزولی از یک EventFilter باید از پارامترهای رویداد یا آیتم استفاده شود. |
itemParameterName | این فیلتر بر اساس پارامتر مورد مشخص شده ارزیابی می شود. پارامترهای آیتم به عنوان پارامتر در آرایه آیتم ثبت می شوند. پارامترهای مورد شامل فیلدهایی مانند "item_name" و "item_category" هستند. پارامترهای مورد فقط در بخشها و قیفها قابل استفاده هستند و فقط میتوانند در فیلتر نزولی از EventFilter استفاده شوند. در یک فیلتر نزولی از یک EventFilter باید از پارامترهای رویداد یا آیتم استفاده شود. پارامترهای مورد فقط در رویدادهای تجارت الکترونیک در دسترس هستند. برای کسب اطلاعات بیشتر در مورد رویدادهای تجارت الکترونیک، راهنمای اندازه گیری تجارت الکترونیک را ببینید. |
فیلد اتحادیه one_filter . یک نوع فیلتر را مشخص کنید. one_filter تنها می تواند یکی از موارد زیر باشد: | |
stringFilter | فیلتر مربوط به رشته ها |
inListFilter | فیلتری برای مقادیر در لیست. |
numericFilter | فیلتری برای مقادیر عددی یا تاریخ. |
betweenFilter | یک فیلتر برای بین دو مقدار. |
SegmentParameterFilterScoping
محدوده ها مشخص می کنند که چگونه چندین رویداد باید در هنگام ارزیابی فیلتر پارامتر بخش در نظر گرفته شود.
نمایندگی JSON |
---|
{ "inAnyNDayPeriod": string } |
فیلدها | |
---|---|
inAnyNDayPeriod | پارامتر را در بازه زمانی مشخص شده از روزهای قبل از اعمال فیلتر جمع می کند. فقط در صورتی پشتیبانی می شود که محدوده معیارها برای مثال، اگر محدوده تاریخ به منظور داشتن یک پنجره کامل N روز نزدیک به شروع محدوده تاریخ تمدید نمی شود. به عنوان مثال اگر گزارشی برای 01-11-2021 تا 2021-11-10 و |
UserSegmentSequenceGroup
شرایطی را تعریف کنید که باید در یک نظم خاص رخ دهد تا کاربر عضوی از بخش باشد.
نمایندگی JSON |
---|
{ "sequenceScoping": enum ( |
فیلدها | |
---|---|
sequenceScoping | تمام مراحل توالی باید در محدوده مورد نظر رعایت شود تا کاربر با توالی مطابقت داشته باشد. به عنوان مثال، اگر اختیاری. اگر مشخص نشده باشد، |
sequenceMaximumDuration | دوره زمانی را که کل دنباله باید در آن اتفاق بیفتد را مشخص می کند. مثلا 30 دقیقه مدت زمان در ثانیه با حداکثر نه رقم کسری که با ' |
userSequenceSteps[] | دنباله ای مرتب از مراحل شرط. رویدادهای کاربر باید هر مرحله را کامل کنند تا کاربر با |
UserSequenceStep
شرایطی که باید در ترتیب مراحل مشخص شده رخ دهد تا این کاربر با توالی مطابقت داشته باشد.
نمایندگی JSON |
---|
{ "isDirectlyFollowedBy": boolean, "stepScoping": enum ( |
فیلدها | |
---|---|
isDirectlyFollowedBy | اگر درست باشد، رویدادی که این مرحله را برآورده میکند باید رویداد بعدی بعد از رویدادی باشد که آخرین مرحله را برآورده میکند. اگر نادرست باشد، این مرحله به طور غیرمستقیم از مرحله قبل پیروی می کند. برای مثال، ممکن است رویدادهایی بین مرحله قبل و این مرحله وجود داشته باشد. |
stepScoping | برای تطبیق کاربر با توالی، این مرحله توالی باید در محدوده مورد نظر رعایت شود. به عنوان مثال اگر اختیاری. اگر مشخص نشده باشد، |
segmentFilterExpression | اگر رویدادهای کاربر با این عبارت مطابقت داشته باشند، این مرحله دنباله را مطابقت می دهد. عبارات معیارهای ابعاد، معیارها و/یا پارامترها را بیان می کنند. |
UserSegmentExclusion
مشخص می کند کدام کاربران در این بخش مستثنی شده اند.
نمایندگی JSON |
---|
{ "userExclusionDuration": enum ( |
فیلدها | |
---|---|
userExclusionDuration | مشخص می کند که اگر کاربر با اختیاری. اگر مشخص نشده باشد، |
userExclusionCriteria | اگر کاربری این شرایط را داشته باشد، کاربر از عضویت در بخش |
UserExclusionDuration
در صورتی که کاربر با userExclusionCriteria
مطابقت داشته باشد، گزینههایی را برای مدت زمان ماندگاری یک حذف برمیشمارد.
Enums | |
---|---|
USER_EXCLUSION_DURATION_UNSPECIFIED | مدت زمان حذف نامشخص مشخص نکنید. |
USER_EXCLUSION_TEMPORARY | در دورههایی که کاربر شرایط userExclusionCriteria را دارد، به طور موقت کاربران را از بخش حذف کنید. |
USER_EXCLUSION_PERMANENT | اگر کاربر شرایط userExclusionCriteria را برآورده کند، برای همیشه کاربران را از بخش حذف کنید. |
SessionSegment
بخشهای جلسه زیرمجموعههایی از جلساتی هستند که در سایت یا برنامه شما رخ دادهاند: به عنوان مثال، تمام جلساتی که از یک کمپین تبلیغاتی خاص منشا گرفتهاند.
نمایندگی JSON |
---|
{ "sessionInclusionCriteria": { object ( |
فیلدها | |
---|---|
sessionInclusionCriteria | تعریف می کند که کدام جلسات در این بخش گنجانده شده است. اختیاری. |
exclusion | تعیین می کند کدام جلسات در این بخش حذف می شوند. اختیاری. |
معیارهای SessionSegment
در صورتی که رویدادهای جلسه با شرایط موجود در معیارها مطابقت داشته باشند، یک جلسه با یک معیار مطابقت دارد.
نمایندگی JSON |
---|
{
"andConditionGroups": [
{
object ( |
فیلدها | |
---|---|
andConditionGroups[] | یک جلسه با این معیار مطابقت دارد اگر جلسه با هر یک از این |
SessionSegmentConditionGroup
شرایط به Analytics میگوید چه دادههایی را در بخش گنجانده یا از آن حذف کند.
نمایندگی JSON |
---|
{ "conditionScoping": enum ( |
فیلدها | |
---|---|
conditionScoping | داده ها بر اساس اینکه با گروه شرایط مطابقت دارند شامل یا از بخش حذف می شوند. این محدوده تعیین می کند که قبل از اینکه گروه شرط مطابقت داشته باشد یا خیر، اختیاری. اگر مشخص نشده باشد، از یک |
segmentFilterExpression | داده ها بر اساس مطابقت با این عبارت شامل یا از بخش حذف می شوند. عبارات معیارهای ابعاد، معیارها و/یا پارامترها را بیان می کنند. |
Scoping معیارهای جلسه
Scoping مشخص می کند که در صورت رعایت یک جلسه، کدام رویدادها هنگام ارزیابی در نظر گرفته می شوند.
Enums | |
---|---|
SESSION_CRITERIA_SCOPING_UNSPECIFIED | محدوده معیارهای نامشخص مشخص نکنید. |
SESSION_CRITERIA_WITHIN_SAME_EVENT | اگر معیارها در یک رویداد برآورده شوند، جلسه با معیارها مطابقت دارد. |
SESSION_CRITERIA_WITHIN_SAME_SESSION | اگر معیارها در یک جلسه برآورده شود، جلسه با معیارها مطابقت دارد. |
SessionSegmentExclusion
مشخص می کند کدام جلسات در این بخش حذف می شوند.
نمایندگی JSON |
---|
{ "sessionExclusionDuration": enum ( |
فیلدها | |
---|---|
sessionExclusionDuration | مشخص میکند که اگر یک جلسه با اختیاری. اگر مشخص نشده باشد، از |
sessionExclusionCriteria | اگر جلسه ای این شرط را داشته باشد، جلسه از عضویت در بخش مربوط به |
SessionExclusionDuration
اگر جلسه با sessionExclusionCriteria
مطابقت داشته باشد، گزینههایی را برای مدت زمان ماندگاری یک حذف برمیشمارد.
Enums | |
---|---|
SESSION_EXCLUSION_DURATION_UNSPECIFIED | مدت زمان حذف نامشخص مشخص نکنید. |
SESSION_EXCLUSION_TEMPORARY | در طول دوره هایی که جلسه با شرط sessionExclusionCriteria مطابقت دارد، به طور موقت جلسات را از بخش حذف کنید. |
SESSION_EXCLUSION_PERMANENT | اگر جلسه با شرط sessionExclusionCriteria مطابقت داشته باشد، بهطور دائم جلسات را از بخش حذف کنید. |
بخش رویداد
بخشهای رویداد زیرمجموعهای از رویدادهایی هستند که در سایت یا برنامه شما راهاندازی شدهاند. به عنوان مثال، تمام رویدادهای خرید انجام شده در یک مکان خاص؛ رویدادهای app_exception که در یک سیستم عامل خاص رخ داده است.
نمایندگی JSON |
---|
{ "eventInclusionCriteria": { object ( |
فیلدها | |
---|---|
eventInclusionCriteria | تعریف می کند که کدام رویدادها در این بخش گنجانده شده اند. اختیاری. |
exclusion | تعریف می کند که کدام رویدادها در این بخش حذف می شوند. اختیاری. |
معیارهای بخش رویداد
یک رویداد با یک معیار مطابقت دارد اگر رویداد شرایط موجود در معیارها را داشته باشد.
نمایندگی JSON |
---|
{
"andConditionGroups": [
{
object ( |
فیلدها | |
---|---|
andConditionGroups[] | یک رویداد با این معیار مطابقت دارد اگر رویداد با هر یک از این |
EventSegmentConditionGroup
شرایط به Analytics میگوید چه دادههایی را در بخش گنجانده یا از آن حذف کند.
نمایندگی JSON |
---|
{ "conditionScoping": enum ( |
فیلدها | |
---|---|
conditionScoping | اختیاری. اگر مشخص نشده باشد، از یک |
segmentFilterExpression | داده ها بر اساس مطابقت با این عبارت شامل یا از بخش حذف می شوند. عبارات معیارهای ابعاد، معیارها و/یا پارامترها را بیان می کنند. |
EventCriteriaScoping
Scoping مشخص می کند که اگر رویدادی معیاری را داشته باشد، چه رویدادهایی در هنگام ارزیابی در نظر گرفته می شوند.
Enums | |
---|---|
EVENT_CRITERIA_SCOPING_UNSPECIFIED | محدوده معیارهای نامشخص مشخص نکنید. |
EVENT_CRITERIA_WITHIN_SAME_EVENT | اگر معیارها در یک رویداد برآورده شوند، رویداد با معیارها مطابقت دارد. |
EventSegmentExclusion
مشخص میکند کدام رویدادها در این بخش حذف میشوند.
نمایندگی JSON |
---|
{ "eventExclusionDuration": enum ( |
فیلدها | |
---|---|
eventExclusionDuration | اختیاری. اگر مشخص نشده باشد، یک |
eventExclusionCriteria | اگر رویدادی دارای این شرط باشد، رویداد از عضویت در بخش |
EventExclusionDuration
اگر رویدادی با eventExclusionCriteria
مطابقت داشته باشد، گزینههایی را برای مدت زمان ماندگاری یک استثنا برمیشمارد.
Enums | |
---|---|
EVENT_EXCLUSION_DURATION_UNSPECIFIED | مدت زمان حذف نامشخص مشخص نکنید. |
EVENT_EXCLUSION_PERMANENT | اگر رویداد با شرط eventExclusionCriteria مطابقت داشته باشد، رویدادها را برای همیشه از بخش حذف کنید. |
FunnelSubReport
گزارشهای فرعی قیف حاوی مقادیر دادههای ابعاد و متریک است. به عنوان مثال، 12 کاربر به مرحله دوم قیف رسیدند.
نمایندگی JSON |
---|
{ "dimensionHeaders": [ { object ( |
فیلدها | |
---|---|
dimensionHeaders[] | ستون های ابعاد را توصیف می کند. گزارش های قیف همیشه شامل بعد مرحله قیف در پاسخ های گزارش فرعی است. در صورت درخواست، ابعاد اضافی مانند خرابیها، تاریخها و اقدامات بعدی ممکن است در پاسخ وجود داشته باشد. |
metricHeaders[] | ستون های متریک را توصیف می کند. گزارش های قیف همیشه شامل کاربران فعال در پاسخ های گزارش فرعی می شود. جدول قیف شامل معیارهای اضافی مانند نرخ تکمیل، رها شدن، و نرخ رها شدن است. |
rows[] | ردیف هایی از ترکیبات ارزش ابعاد و مقادیر متریک در گزارش. |
metadata | فراداده برای گزارش قیف. |
FunnelResponseMetadata
فراداده پاسخ گزارش قیف حاوی اطلاعات اضافی درباره گزارش قیف است.
نمایندگی JSON |
---|
{
"samplingMetadatas": [
{
object ( |
فیلدها | |
---|---|
samplingMetadatas[] | اگر از نتایج گزارش قیف نمونه برداری شود، این نشان می دهد که چند درصد از رویدادها در این گزارش قیف استفاده شده است. برای هر محدوده تاریخ، یک اما اگر از نتایج نمونه برداری نشود، این فیلد تعریف نمی شود. |
Sampling Metadata
اگر از نتایج گزارش قیف نمونه برداری شود، این فراداده توضیح می دهد که چند درصد از رویدادها در این گزارش قیف برای محدوده تاریخ استفاده شده است. نمونه گیری عملی است برای تجزیه و تحلیل زیرمجموعه ای از همه داده ها به منظور کشف اطلاعات معنی دار در مجموعه داده های بزرگتر.
نمایندگی JSON |
---|
{ "samplesReadCount": string, "samplingSpaceSize": string } |
فیلدها | |
---|---|
samplesReadCount | تعداد کل رویدادهای خوانده شده در این گزارش نمونه برای محدوده تاریخ. این اندازه زیرمجموعه داده های این ویژگی است که در این گزارش قیف تحلیل شده است. |
samplingSpaceSize | تعداد کل رویدادهای موجود در دادههای این ویژگی که میتوانستند در این گزارش قیف برای محدوده تاریخ تجزیه و تحلیل شوند. نمونه برداری اطلاعات معنی داری را در مورد مجموعه داده های بزرگتر آشکار می کند و این اندازه مجموعه داده های بزرگتر است. برای محاسبه درصد دادههای موجود که در این گزارش قیف استفاده شده است، |
سهمیه ملک
وضعیت فعلی همه سهمیهها برای این ویژگی Analytics. اگر هر سهمیه ای برای یک دارایی تمام شود، همه درخواست ها به آن ویژگی خطاهای Resource Exhausted را برمی گرداند.
نمایندگی JSON |
---|
{ "tokensPerDay": { object ( |
فیلدها | |
---|---|
tokensPerDay | ویژگی های استاندارد آنالیتیکس می تواند تا 200000 توکن در روز استفاده کند. Analytics 360 Properties می تواند از 2,000,000 توکن در روز استفاده کند. اکثر درخواست ها کمتر از 10 توکن مصرف می کنند. |
tokensPerHour | ویژگی های استاندارد آنالیتیکس می تواند تا 40000 توکن در ساعت استفاده کند. Analytics 360 Properties می تواند از 400000 توکن در ساعت استفاده کند. یک درخواست API یک تعداد توکن مصرف می کند و این تعداد از تمام سهمیه های ساعتی، روزانه و هر پروژه کسر می شود. |
concurrentRequests | ویژگی های استاندارد آنالیتیکس می تواند حداکثر 10 درخواست همزمان ارسال کند. Analytics 360 Properties می تواند از 50 درخواست همزمان استفاده کند. |
serverErrorsPerProjectPerHour | ویژگی های استاندارد تجزیه و تحلیل و جفت پروژه ابری می توانند تا 10 خطای سرور در ساعت داشته باشند. Analytics 360 Properties و جفت پروژه ابری می توانند تا 50 خطای سرور در ساعت داشته باشند. |
potentiallyThresholdedRequestsPerHour | Analytics Properties می تواند تا 120 درخواست با ابعاد احتمالی آستانه در هر ساعت ارسال کند. در یک درخواست دستهای، اگر درخواست دارای ابعاد بالقوه آستانهای باشد، هر درخواست گزارش بهصورت جداگانه برای این سهمیه شمارش میشود. |
tokensPerProjectPerHour | Analytics Properties می تواند تا 35٪ از توکن های خود را در هر پروژه در ساعت استفاده کند. این به این معناست که ویژگی های استاندارد آنالیتیکس می تواند تا 14000 توکن در هر پروژه در ساعت استفاده کند و Analytics 360 Properties می تواند از 140000 توکن در هر پروژه در ساعت استفاده کند. یک درخواست API یک تعداد توکن مصرف می کند و این تعداد از تمام سهمیه های ساعتی، روزانه و هر پروژه کسر می شود. |
وضعیت سهمیه
وضعیت فعلی برای یک گروه سهمیه خاص.
نمایندگی JSON |
---|
{ "consumed": integer, "remaining": integer } |
فیلدها | |
---|---|
consumed | سهمیه مصرف شده توسط این درخواست. |
remaining | سهمیه پس از این درخواست باقی مانده است. |