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 שהאירועים שלו נמדדים. הפרמטר מצוין בנתיב כתובת ה-URL ולא בגוף הבקשה. איפה אפשר למצוא את מזהה הנכס? בבקשת Batch, המאפיין הזה צריך להיות לא מוגדר או עקבי עם המאפיין ברמת ה-Batch.

דוגמה: properties/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)

אופציונלי. מספר השורות שיש להחזיר. אם לא מציינים ערך, מוחזרות 10,000 שורות. ה-API מחזיר עד 250,000 שורות לכל בקשה, לא משנה כמה שורות מבקשים. הערך של limit חייב להיות חיובי.

יכול להיות ש-API יחזיר פחות שורות מהערך המבוקש של limit, אם אין מספיק ערכים של מאפיינים כמו הערך של limit.
dimensionFilter

object (FilterExpression)

אופציונלי. מסנני מאפיינים מאפשרים לכם לבקש בדוח רק ערכים ספציפיים של מאפיינים. לדוגמאות, אפשר לעיין במאמר יצירת דוח: מסנני מאפיינים. אי אפשר להשתמש במדדים במסנן הזה.
returnPropertyQuota

boolean

אופציונלי. הפונקציה מחזירה את המצב הנוכחי של המכסה של נכס Analytics הזה. המכסה מוחזר ב-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 הזה, כולל הבקשה הזו.
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

אם הערך הוא true, השלב הזה חייב להופיע מיד אחרי השלב הקודם. אם הערך הוא False, יכולים להיות אירועים בין השלב הקודם לשלב הזה. אם לא מציינים ערך, isDirectlyFollowedBy מקבל את הערך false.
filterExpression

object (FunnelFilterExpression)

התנאי שהמשתמשים צריכים לעמוד בו כדי להיכלל בשלב הזה במשפך.
withinDurationFromPriorStep

string (Duration format)

אם מצוין, השלב הזה צריך להסתיים בתוך משך הזמן הזה מסיום השלב הקודם. ‫withinDurationFromPriorStep כולל את נקודת הקצה ברמת דיוק של מיקרו-שנייה. לדוגמה, משך של 5 שניות יכול להסתיים ב-4.9 או ב-5.0 שניות, אבל לא ב-5 שניות ומיקרו-שנייה אחת.

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)

מסנן לערכים שבין שני ערכים.

FunnelBreakdown

הפילוחים מוסיפים מאפיין לתגובת דוח המשנה של טבלת המשפך.

ייצוג 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

המאפיינים שמוצגים בתגובה של דוח המשנה של הדמיית המשפך.

טיפוסים בני מנייה (enum)
FUNNEL_VISUALIZATION_TYPE_UNSPECIFIED סוג לא מוגדר.
STANDARD_FUNNEL משפך רגיל (עם שלבים). דוח המשנה 'הצגת נתוני משפך' בתגובה לא יכלול תאריך.
TRENDED_FUNNEL משפך מגמות (תרשים קו). דוח המשנה של ההדמיה של המשפך בתשובה יכיל את מאפיין התאריך.

Segment

פלח הוא קבוצת משנה של נתונים ב-Analytics. לדוגמה, מתוך קבוצה כוללת של משתמשים, אפשר ליצור פלח של משתמשים מעיר או ממדינה מסוימות. אתם יכולים ליצור פלח נוסף של משתמשים שקנו סדרת מוצרים מסוימת, נכנסו לחלק מסוים של האתר או הפעילו אירועים מסוימים באפליקציה שלכם.

מידע נוסף על בונה הפלחים

ייצוג 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. פלח", ‏"2. Segment", etc.).
שדה איחוד one_segment_scope. פלח מצוין בהיקף אחד. הערך one_segment_scope יכול להיות רק אחד מהבאים:
userSegment

object (UserSegment)

פלחים של משתמשים הם קבוצות משנה של משתמשים שיצרו אינטראקציה עם האתר או האפליקציה שלכם.
sessionSegment

object (SessionSegment)

פלחי סשנים הם קבוצות משנה של סשנים שהתרחשו באתר או באפליקציה שלכם.
eventSegment

object (EventSegment)

פלחי אירועים הם קבוצות משנה של אירועים שהופעלו באתר או באפליקציה שלכם.

UserSegment

פלחי משתמשים הם קבוצות משנה של משתמשים שהביעו עניין באתר או באפליקציה שלכם: לדוגמה, משתמשים שביצעו רכישה בעבר או משתמשים שהוסיפו פריטים לעגלת הקניות אך לא השלימו את הרכישה.

ייצוג 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. אם מציינים את andConditionGroups, אפשר להשאיר את andSequenceGroups ריק.

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

היקף ההגדרה מציין אילו אירועים נלקחים בחשבון כשבודקים אם משתמש עומד בקריטריונים.

טיפוסים בני מנייה (enum)
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)

רשימת ביטויי הסינון של הפלחים

SegmentFilter

ביטוי לסינון ערכי מאפיינים או מדדים.

ייצוג 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 הוא true, המסנן הזה מחזיר true לכל האירועים אם הוא מחזיר true לאירוע כלשהו בטווח התאריכים של הבקשה.

הפרמטר atAnyPointInTime לא מרחיב את טווח התאריכים של האירועים בדוח. אם הערך של atAnyPointInTime הוא true, רק אירועים בטווח התאריכים של הדוח נלקחים בחשבון כשמעריכים את המסנן הזה.

אפשר לציין את 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, שם האירוע הוא purchase, פרמטר של אירוע הוא event_count והקריטריונים של המסנן הם גדול מ-5, המסנן הזה יצבור את מספר אירועי הרכישה בכל תקופה של 3 ימים רצופים בטווח התאריכים של הדוח. משתמש יעמוד בקריטריונים של המסנן הזה וייכלל בפלח הזה אם מספר אירועי הרכישה שלו גדול מ-5 בכל תקופה של 3 ימים רצופים. לדוגמה, המערכת תתייחס לתקופות 01.11.2021 עד 03.11.2021, 02.11.2021 עד 04.11.2021, 03.11.2021 עד 05.11.2021 וכו'.

טווח התאריכים לא מורחב כדי שיהיה חלון של N ימים מלאים קרוב לתחילת טווח התאריכים. לדוגמה, אם הדוח הוא לתאריכים 2021-11-01 עד 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 שניות ומיקרו-שנייה אחת.

‫sequenceMaximumDuration הוא אופציונלי, ואם לא מציינים אותו, אפשר להשלים את הרצפים בכל משך זמן.

משך זמן בשניות עם עד תשע ספרות אחרי הנקודה העשרונית, שמסתיים ב-'s'. דוגמה: "3.5s".
userSequenceSteps[]

object (UserSequenceStep)

רצף מסודר של שלבי תנאים. כדי שמשתמש יתאים לקהל UserSegmentSequenceGroup, האירועים שלו צריכים להשלים כל שלב.

UserSequenceStep

תנאי שצריך להתקיים בסדר השלבים שצוין כדי שהמשתמש יתאים לרצף.

ייצוג JSON 
{
  "isDirectlyFollowedBy": boolean,
  "stepScoping": enum (UserCriteriaScoping),
  "segmentFilterExpression": {
    object (SegmentFilterExpression)
  }
}
שדות
isDirectlyFollowedBy

boolean

אם הערך הוא True, האירוע שמקיים את התנאי של השלב הזה חייב להיות האירוע הבא אחרי האירוע שמקיים את התנאי של השלב הקודם. אם הערך הוא False, השלב הזה מופיע בעקיפין אחרי השלב הקודם. לדוגמה, יכולים להיות אירועים בין השלב הקודם לבין השלב הזה. הערך של isDirectlyFollowedBy חייב להיות false בשלב הראשון.
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.

טיפוסים בני מנייה (enum)
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)

הגדרה של הסשנים שמוחרגים בפלח הזה. אופציונלי.

SessionSegmentCriteria

סשן תואם לקריטריון אם האירועים בסשן עומדים בתנאים של הקריטריון.

ייצוג 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)

הנתונים נכללים בפלח או לא נכללים בו בהתאם להתאמה שלהם לביטוי הזה. ביטויים מבטאים קריטריונים לגבי מאפיינים, מדדים או פרמטרים.

SessionCriteriaScoping

ההיקף מציין אילו אירועים נלקחים בחשבון כשבודקים אם סשן עומד בקריטריון מסוים.

טיפוסים בני מנייה (enum)
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.

טיפוסים בני מנייה (enum)
SESSION_EXCLUSION_DURATION_UNSPECIFIED לא צוין משך ההחרגה. לא צריך לציין.
SESSION_EXCLUSION_TEMPORARY החרגה זמנית של ביקורים מהפלח בתקופות שבהן הביקור עומד בתנאי sessionExclusionCriteria.
SESSION_EXCLUSION_PERMANENT החרגה קבועה של סשנים מהפלח אם הסשן עומד בתנאי sessionExclusionCriteria.

EventSegment

פלחי אירועים הם קבוצות משנה של אירועים שהופעלו באתר או באפליקציה שלכם: לדוגמה, כל אירועי הרכישה שהתרחשו במיקום מסוים או אירועי app_exception שהתרחשו במערכת הפעלה ספציפית.

ייצוג JSON 
{
  "eventInclusionCriteria": {
    object (EventSegmentCriteria)
  },
  "exclusion": {
    object (EventSegmentExclusion)
  }
}
שדות
eventInclusionCriteria

object (EventSegmentCriteria)

המאפיין מגדיר אילו אירועים נכללים בפלח הזה. אופציונלי.
exclusion

object (EventSegmentExclusion)

הגדרה של האירועים שלא נכללים בפלח הזה. אופציונלי.

EventSegmentCriteria

אירוע תואם לקריטריון אם הוא עומד בתנאים של הקריטריון.

ייצוג 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

ההיקף מציין אילו אירועים נלקחים בחשבון כשבודקים אם אירוע עומד בקריטריון מסוים.

טיפוסים בני מנייה (enum)
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.

טיפוסים בני מנייה (enum)
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 מתאים לטווח תאריכים לפי הסדר שבו צוינו טווחי התאריכים בבקשה.

אבל אם התוצאות לא נדגמו, השדה הזה לא יוגדר.