- درخواست HTTP
- پارامترهای مسیر
- درخواست بدن
- بدن پاسخگو
- محدوده مجوز
- محدوده زمانی
- قیف
- FunnelStep
- FunnelFilterExpression
- FunnelFilterExpressionList
- FunnelFieldFilter
- StringFilter
- MatchType
- InListFilter
- فیلتر عددی
- عمل
- مقدار عددی
- بین فیلتر
- FunnelEventFilter
- FunnelParameterFilterExpression
- FunnelParameterFilterExpressionList
- FunnelParameterFilter
- Funnel Breakdown
- بعد، ابعاد، اندازه
- DimensionExpression
- Case Expression
- ConcatenateExpression
- 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
- FilterExpression
- FilterExpressionList
- فیلتر کنید
- FunnelSubReport
- DimensionHeader
- MetricHeader
- نوع متریک
- ردیف
- DimensionValue
- MetricValue
- 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
محدوده زمانی
مجموعه ای از روزهای پیوسته: startDate
، startDate + 1
، ...، endDate
. درخواست تا 4 محدوده تاریخ مجاز است.
نمایندگی JSON |
---|
{ "startDate": string, "endDate": string, "name": string } |
زمینه های | |
---|---|
startDate | تاریخ شروع شامل درخواست در قالب |
endDate | تاریخ پایان شامل درخواست در قالب |
name | نامی را به این محدوده تاریخ اختصاص می دهد. بعد |
قیف
قیف را در یک درخواست گزارش قیف پیکربندی می کند. یک قیف در حین گذر از مراحل متوالی از کاربران گزارش می دهد.
کاوش قیف به شما این امکان را میدهد تا مراحلی را که کاربران برای تکمیل یک کار برمیدارند تجسم کنید و به سرعت ببینید که در هر مرحله چقدر موفق یا شکست میخورند. به عنوان مثال، چگونه مشتریان بالقوه خریدار و سپس خریدار می شوند؟ چگونه خریداران یکباره تبدیل به خریداران تکراری می شوند؟ با این اطلاعات، می توانید سفرهای ناکارآمد یا رها شده مشتریان را بهبود ببخشید.
نمایندگی 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 | یک فیلتر برای بین دو مقدار. |
StringFilter
فیلتر رشته
نمایندگی JSON |
---|
{
"matchType": enum ( |
زمینه های | |
---|---|
matchType | نوع مطابقت برای این فیلتر. |
value | مقدار رشته ای که برای تطبیق استفاده می شود. |
caseSensitive | اگر درست باشد، مقدار رشته به حروف بزرگ و کوچک حساس است. |
MatchType
نوع مطابقت یک فیلتر رشته ای
Enums | |
---|---|
MATCH_TYPE_UNSPECIFIED | نامشخص |
EXACT | مطابقت دقیق مقدار رشته |
BEGINS_WITH | با مقدار رشته شروع می شود. |
ENDS_WITH | با مقدار رشته به پایان می رسد. |
CONTAINS | حاوی مقدار رشته است. |
FULL_REGEXP | مطابقت کامل برای عبارت منظم با مقدار رشته. |
PARTIAL_REGEXP | مطابقت جزئی برای عبارت منظم با مقدار رشته. |
InListFilter
نتیجه باید در لیستی از مقادیر رشته باشد.
نمایندگی JSON |
---|
{ "values": [ string ], "caseSensitive": boolean } |
زمینه های | |
---|---|
values[] | لیست مقادیر رشته باید خالی نباشد |
caseSensitive | اگر درست باشد، مقدار رشته به حروف بزرگ و کوچک حساس است. |
فیلتر عددی
فیلترهایی برای مقادیر عددی یا تاریخ.
نمایندگی JSON |
---|
{ "operation": enum ( |
زمینه های | |
---|---|
operation | نوع عملکرد این فیلتر |
value | یک مقدار عددی یا یک مقدار تاریخ. |
عمل
عملیات بر روی یک فیلتر عددی اعمال می شود
Enums | |
---|---|
OPERATION_UNSPECIFIED | نامشخص |
EQUAL | برابر |
LESS_THAN | کمتر از |
LESS_THAN_OR_EQUAL | کمتر یا مساوی |
GREATER_THAN | بزرگتر از |
GREATER_THAN_OR_EQUAL | بزرگتر یا مساوی |
مقدار عددی
برای نشان دادن یک عدد
نمایندگی JSON |
---|
{ // Union field |
زمینه های | |
---|---|
فیلد اتحادیه one_value . یکی از مقادیر عددی one_value می تواند تنها یکی از موارد زیر باشد: | |
int64Value | مقدار صحیح |
doubleValue | ارزش دو برابر |
بین فیلتر
برای بیان اینکه نتیجه باید بین دو عدد (شامل) باشد.
نمایندگی JSON |
---|
{ "fromValue": { object ( |
زمینه های | |
---|---|
fromValue | با این عدد شروع می شود. |
toValue | با این عدد به پایان می رسد. |
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 | حداکثر تعداد مقادیر متمایز بعد شکست که در پاسخ بازگردانده می شود. اگر محدودیت مشخص نشده باشد از |
بعد، ابعاد، اندازه
ابعاد ویژگی های داده های شما هستند. به عنوان مثال، شهر بعد شهری را نشان می دهد که یک رویداد از آن سرچشمه می گیرد. مقادیر ابعاد در پاسخ های گزارش رشته ای هستند. به عنوان مثال، شهر می تواند "پاریس" یا "نیویورک" باشد.
نمایندگی JSON |
---|
{
"name": string,
"dimensionExpression": {
object ( |
زمینه های | |
---|---|
name | نام ابعاد. برای لیستی از نام ابعاد پشتیبانی شده توسط روش های گزارش اصلی مانند اگر ابعاد با |
dimensionExpression | یک بعد می تواند نتیجه بیان چند بعد باشد. به عنوان مثال، بعد "کشور، شهر": concatenate(کشور، "، "، شهر). |
DimensionExpression
برای بیان یک بعد که حاصل فرمول چند بعد است استفاده می شود. کاربردهای مثال: 1) حروف کوچک (بعد) 2) الحاق (بعد 1، نماد، بعد 2).
نمایندگی JSON |
---|
{ // Union field |
زمینه های | |
---|---|
فیلد اتحادیه one_expression . یک نوع عبارت بعد را برای DimensionExpression مشخص کنید. one_expression می تواند تنها یکی از موارد زیر باشد: | |
lowerCase | برای تبدیل مقدار ابعاد به حروف کوچک استفاده می شود. |
upperCase | برای تبدیل مقدار ابعاد به حروف بزرگ استفاده می شود. |
concatenate | برای ترکیب مقادیر ابعاد به یک بعد واحد استفاده می شود. به عنوان مثال، بعد "کشور، شهر": concatenate(کشور، "، "، شهر). |
Case Expression
برای تبدیل مقدار ابعاد به یک مورد استفاده می شود.
نمایندگی JSON |
---|
{ "dimensionName": string } |
زمینه های | |
---|---|
dimensionName | نام یک بعد نام باید به یک نام در قسمت ابعاد درخواست اشاره کند. |
ConcatenateExpression
برای ترکیب مقادیر ابعاد به یک بعد واحد استفاده می شود.
نمایندگی JSON |
---|
{ "dimensionNames": [ string ], "delimiter": string } |
زمینه های | |
---|---|
dimensionNames[] | نام ابعاد نام ها باید به نام هایی در قسمت ابعاد درخواست مراجعه کنند. |
delimiter | جداکننده بین نام ابعاد قرار می گیرد. جداکننده ها اغلب کاراکترهای منفرد هستند مانند "|" یا ""، اما می تواند رشته های طولانی تر باشد. اگر یک مقدار بعد حاوی جداکننده باشد، هر دو بدون هیچ تمایزی در پاسخ وجود خواهند داشت. به عنوان مثال، اگر مقدار بعد 1 = "US,FR"، مقدار بعد 2 = "JP" و جداکننده = "،"، پاسخ شامل "US,FR,JP" خواهد بود. |
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 مطابقت داشته باشد، رویدادها را برای همیشه از بخش حذف کنید. |
FilterExpression
برای بیان فیلترهای ابعاد یا متریک. فیلدهای موجود در همان FilterExpression باید همه ابعاد یا همه معیارها باشند.
نمایندگی JSON |
---|
{ // Union field |
زمینه های | |
---|---|
expr فیلد اتحادیه یک نوع بیان فیلتر را برای FilterExpression مشخص کنید. expr فقط می تواند یکی از موارد زیر باشد: | |
andGroup | FilterExpressions در Andgroup دارای یک رابطه و رابطه است. |
orGroup | FilterExpressions در orgroup دارای یک رابطه یا رابطه است. |
notExpression | Filterexpression از بیان نیست. |
filter | یک فیلتر ابتدایی در همان FilterExpression ، تمام نام های فیلتر فیلتر باید همه ابعاد یا تمام معیارها باشد. |
فیلتر اکسپرسیون
لیستی از عبارات فیلتر.
نمایندگی JSON |
---|
{
"expressions": [
{
object ( |
زمینه های | |
---|---|
expressions[] | لیستی از عبارات فیلتر. |
فیلتر کنید
عبارتی برای فیلتر کردن ابعاد یا مقادیر متریک.
نمایندگی JSON |
---|
{ "fieldName": string, // Union field |
زمینه های | |
---|---|
fieldName | نام ابعاد یا نام متریک. باید نامی باشد که در ابعاد یا معیارها تعریف شده است. |
Union Field one_filter . یک نوع فیلتر را برای Filter مشخص کنید. one_filter فقط می تواند یکی از موارد زیر باشد: | |
stringFilter | فیلتر مربوط به رشته ها. |
inListFilter | یک فیلتر برای مقادیر لیست. |
numericFilter | فیلتر برای مقادیر عددی یا تاریخ. |
betweenFilter | یک فیلتر برای دو مقدار. |
قله
گزارش های زیر قیف حاوی ابعاد و مقادیر داده متریک است. به عنوان مثال ، 12 کاربر به مرحله دوم قیف رسیدند.
نمایندگی JSON |
---|
{ "dimensionHeaders": [ { object ( |
زمینه های | |
---|---|
dimensionHeaders[] | ستون های ابعاد را توصیف می کند. گزارش های قیف همیشه شامل ابعاد قدم قیف در پاسخ های گزارش زیر است. ابعاد اضافی مانند خرابی ، تاریخ و اقدامات بعدی ممکن است در صورت درخواست در پاسخ وجود داشته باشد. |
metricHeaders[] | ستون های متریک را توصیف می کند. گزارش های قیف همیشه شامل کاربران فعال در پاسخ های گزارش زیر است. جدول قیف شامل معیارهای اضافی مانند نرخ تکمیل ، رها کردن و نرخ ترک است. |
rows[] | ردیف های ترکیب ارزش ابعاد و مقادیر متریک در گزارش. |
metadata | ابرداده برای گزارش قیف. |
پیشرونده ابعاد
یک ستون ابعاد در گزارش را توصیف می کند. ابعاد درخواست شده در یک گزارش ، ورودی های ستون در ردیف ها و ابعاد را تولید می کند. با این حال ، ابعاد مورد استفاده منحصراً در فیلترها یا عبارات در یک گزارش ستون تولید نمی کند. به همین ترتیب ، این ابعاد هدر تولید نمی کند.
نمایندگی JSON |
---|
{ "name": string } |
زمینه های | |
---|---|
name | نام ابعاد |
متراشی
یک ستون متریک در گزارش را توصیف می کند. معیارهای قابل مشاهده که در یک گزارش درخواست شده است ، ورودی های ستون در ردیف ها و metricheaders را تولید می کند. با این حال ، معیارهایی که منحصراً در فیلترها یا عبارات مورد استفاده قرار می گیرند ، در یک گزارش ستون تولید نمی کنند. به همین ترتیب ، این معیارها هدر تولید نمی کنند.
نمایندگی JSON |
---|
{
"name": string,
"type": enum ( |
زمینه های | |
---|---|
name | نام متریک |
type | نوع داده متریک. |
از نوع
یک نوع ارزش متریک.
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 ( |
زمینه های | |
---|---|
dimensionValues[] | لیست مقادیر ابعاد درخواستی. در یک PivotReport ، DimensionValues فقط برای ابعاد موجود در یک محوری ذکر شده است. |
metricValues[] | لیست مقادیر متریک قابل مشاهده. |
ابعاد ابعادی
مقدار یک بعد.
نمایندگی JSON |
---|
{ // Union field |
زمینه های | |
---|---|
Union Field one_value . یک نوع مقدار ابعاد one_value فقط می تواند یکی از موارد زیر باشد: | |
value | مقدار به عنوان یک رشته اگر نوع ابعاد یک رشته است. |
مقادیر متراکم
ارزش یک متریک.
نمایندگی JSON |
---|
{ // Union field |
زمینه های | |
---|---|
Union Field one_value . یکی از ارزش های متریک one_value فقط می تواند یکی از موارد زیر باشد: | |
value | ارزش اندازه گیری برای نوع به Metricheader مراجعه کنید. |
FunnelResponseMetadata
پاسخ گزارش قیف ، ابرداده اطلاعات اضافی در مورد گزارش قیف دارد.
نمایندگی JSON |
---|
{
"samplingMetadatas": [
{
object ( |
زمینه های | |
---|---|
samplingMetadatas[] | اگر نتایج گزارش قیف نمونه برداری شود ، این توصیف می کند که درصد از وقایع در این گزارش قیف استفاده شده است. یک اما اگر نتایج نمونه برداری نشود ، این قسمت تعریف نمی شود. |
نمونه گیری
اگر نتایج گزارش قیف نمونه برداری شود ، این ابرداده توصیف می کند که درصد از وقایع در این گزارش قیف برای محدوده تاریخ استفاده شده است. نمونه برداری عمل تجزیه و تحلیل زیر مجموعه ای از داده ها به منظور کشف اطلاعات معنی دار در مجموعه داده های بزرگتر است.
نمایندگی JSON |
---|
{ "samplesReadCount": string, "samplingSpaceSize": string } |
زمینه های | |
---|---|
samplesReadCount | تعداد کل وقایع خوانده شده در این گزارش نمونه برداری برای محدوده تاریخ. این اندازه زیر مجموعه داده های این ویژگی است که در این گزارش قیف مورد تجزیه و تحلیل قرار گرفته است. |
samplingSpaceSize | تعداد کل رویدادهای موجود در داده های این ویژگی که می توان در این گزارش قیف برای محدوده تاریخ مورد تجزیه و تحلیل قرار گرفت. نمونه برداری اطلاعات معنی دار در مورد مجموعه داده های بزرگتر را کشف می کند ، و این اندازه مجموعه داده های بزرگتر است. برای محاسبه درصد داده های موجود که در این گزارش قیف استفاده شده است ، |
دارایی
وضعیت فعلی همه سهمیه ها برای این خاصیت تحلیلی. اگر سهمیه ای برای یک ملک خسته شود ، تمام درخواست های مربوط به آن ملک خطاهای خسته شده منابع را برمی گرداند.
نمایندگی JSON |
---|
{ "tokensPerDay": { object ( |
زمینه های | |
---|---|
tokensPerDay | خواص استاندارد تجزیه و تحلیل می تواند تا 200000 نشانه در روز استفاده کند. Analytics 360 ویژگی می تواند از 2000،000 نشانه در روز استفاده کند. بیشتر درخواست ها کمتر از 10 نشانه مصرف می کنند. |
tokensPerHour | خواص استاندارد تجزیه و تحلیل می تواند تا 40،000 نشانه در ساعت استفاده کند. Analytics 360 ویژگی می تواند از 400000 نشانه در ساعت استفاده کند. یک درخواست API تعداد زیادی از نشانه ها را مصرف می کند و این تعداد از همه سهمیه های ساعتی ، روزانه و هر پروژه کسر می شود. |
concurrentRequests | ویژگی های استاندارد تجزیه و تحلیل می توانند حداکثر 10 درخواست همزمان ارسال کنند. ویژگی های Analytics 360 می توانند از 50 درخواست همزمان استفاده کنند. |
serverErrorsPerProjectPerHour | ویژگی های استاندارد تجزیه و تحلیل و جفت پروژه های ابری می توانند حداکثر 10 خطای سرور در ساعت داشته باشند. ویژگی های Analytics 360 و جفت پروژه Cloud می توانند حداکثر 50 خطای سرور در ساعت داشته باشند. |
potentiallyThresholdedRequestsPerHour | ویژگی های تحلیلی می توانند حداکثر 120 درخواست با ابعاد آستانه بالقوه در ساعت ارسال کنند. در درخواست دسته ای ، در صورت درخواست درخواست حاوی ابعاد آستانه بالقوه ، هر درخواست گزارش به صورت جداگانه برای این سهمیه حساب می شود. |
tokensPerProjectPerHour | خواص تجزیه و تحلیل می تواند تا 35 ٪ از نشانه های خود را در هر پروژه در ساعت استفاده کند. این به خصوصیات استاندارد تجزیه و تحلیل می تواند تا 14000 نشانه در هر پروژه در ساعت استفاده کند و 360 ویژگی Analytics می تواند از 140،000 نشانه در هر پروژه در ساعت استفاده کند. یک درخواست API تعداد واحد توکن را مصرف می کند و این تعداد از همه سهمیه های ساعتی ، روزانه و در هر پروژه کسر می شود. |
نقل قول
وضعیت فعلی برای یک گروه سهمیه خاص.
نمایندگی JSON |
---|
{ "consumed": integer, "remaining": integer } |
زمینه های | |
---|---|
consumed | سهمیه مصرف شده توسط این درخواست. |
remaining | سهمیه باقی مانده پس از این درخواست. |