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 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "andGroup": {
    object (FunnelFilterExpressionList)
  },
  "orGroup": {
    object (FunnelFilterExpressionList)
  },
  "notExpression": {
    object (FunnelFilterExpression)
  },
  "funnelFieldFilter": {
    object (FunnelFieldFilter)
  },
  "funnelEventFilter": {
    object (FunnelEventFilter)
  }
  // End of mutually exclusive fields.
}
שדות
מציינים סוג אחד של מסנן ל-FunnelFilterExpression. בהמשך מפורטת רשימה של שדות שאי אפשר להשתמש בהם בו-זמנית. רק אחד מהשדות הבאים יוגדר בתשובה:
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,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "stringFilter": {
    object (StringFilter)
  },
  "inListFilter": {
    object (InListFilter)
  },
  "numericFilter": {
    object (NumericFilter)
  },
  "betweenFilter": {
    object (BetweenFilter)
  }
  // End of mutually exclusive fields.
}
שדות
fieldName

string

שם המאפיין או שם המדד.
מציינים סוג אחד של מסנן. בהמשך מפורטת רשימה של שדות שאי אפשר להשתמש בהם בו-זמנית. רק אחד מהשדות הבאים יוגדר בתשובה:
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 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "andGroup": {
    object (FunnelParameterFilterExpressionList)
  },
  "orGroup": {
    object (FunnelParameterFilterExpressionList)
  },
  "notExpression": {
    object (FunnelParameterFilterExpression)
  },
  "funnelParameterFilter": {
    object (FunnelParameterFilter)
  }
  // End of mutually exclusive fields.
}
שדות
מציינים סוג אחד של מסנן ל-FunnelParameterFilterExpression. בהמשך מפורטת רשימה של שדות שאי אפשר להשתמש בהם בו-זמנית. רק אחד מהשדות הבאים יוגדר בתשובה:
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 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "eventParameterName": string,
  "itemParameterName": string
  // End of mutually exclusive fields.

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "stringFilter": {
    object (StringFilter)
  },
  "inListFilter": {
    object (InListFilter)
  },
  "numericFilter": {
    object (NumericFilter)
  },
  "betweenFilter": {
    object (BetweenFilter)
  }
  // End of mutually exclusive fields.
}
שדות
השדה שמסננים. בהמשך מפורטת רשימה של שדות שאי אפשר להשתמש בהם בו-זמנית. רק אחד מהשדות הבאים יוגדר בתשובה:
eventParameterName

string

המסנן הזה יעבור הערכה על פרמטר של אירוע שצוין. פרמטרים של אירועים נרשמים ביומן כפרמטרים של האירוע. פרמטרים של אירועים כוללים שדות כמו firebase_screen ו-currency.

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

string

המסנן הזה יעבור הערכה על פרמטר הפריט שצוין. פרמטרים של פריטים נרשמים ביומן כפרמטרים במערך הפריטים. פרמטרים של פריטים כוללים שדות כמו item_name ו-item_category.

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

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

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "userSegment": {
    object (UserSegment)
  },
  "sessionSegment": {
    object (SessionSegment)
  },
  "eventSegment": {
    object (EventSegment)
  }
  // End of mutually exclusive fields.
}
שדות
name

string

השם של הפלח הזה. אם לא מציינים שם, הפלחים נקראים 'פלח'. השם הזה מגדיר את ערך המחרוזת שמוחזר על ידי מאפיין segment. הקידומות של המאפיין segment מציינות את מספר האינדקס של הפלח בבקשה, החל מ-1 (לדוגמה, ‎1. ‫Segment",‏ "2. Segment", etc.).
פלח מצוין בהיקף אחד. בהמשך מפורטת רשימה של שדות שאי אפשר להשתמש בהם בו-זמנית. רק אחד מהשדות הבאים יוגדר בתשובה:
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 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "andGroup": {
    object (SegmentFilterExpressionList)
  },
  "orGroup": {
    object (SegmentFilterExpressionList)
  },
  "notExpression": {
    object (SegmentFilterExpression)
  },
  "segmentFilter": {
    object (SegmentFilter)
  },
  "segmentEventFilter": {
    object (SegmentEventFilter)
  }
  // End of mutually exclusive fields.
}
שדות
מציינים סוג אחד של מסנן ל-SegmentFilterExpression. בהמשך מפורטת רשימה של שדות שאי אפשר להשתמש בהם בו-זמנית. רק אחד מהשדות הבאים יוגדר בתשובה:
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)
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "stringFilter": {
    object (StringFilter)
  },
  "inListFilter": {
    object (InListFilter)
  },
  "numericFilter": {
    object (NumericFilter)
  },
  "betweenFilter": {
    object (BetweenFilter)
  }
  // End of mutually exclusive fields.
}
שדות
fieldName

string

שם המאפיין או שם המדד.
filterScoping

object (SegmentFilterScoping)

מציינים את ההיקף של המסנן.
מציינים סוג אחד של מסנן ל-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 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "andGroup": {
    object (SegmentParameterFilterExpressionList)
  },
  "orGroup": {
    object (SegmentParameterFilterExpressionList)
  },
  "notExpression": {
    object (SegmentParameterFilterExpression)
  },
  "segmentParameterFilter": {
    object (SegmentParameterFilter)
  }
  // End of mutually exclusive fields.
}
שדות
מציינים סוג אחד של מסנן ל-SegmentParameterFilterExpression. בהמשך מפורטת רשימה של שדות שאי אפשר להשתמש בהם בו-זמנית. רק אחד מהשדות הבאים יוגדר בתשובה:
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)
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "eventParameterName": string,
  "itemParameterName": string
  // End of mutually exclusive fields.

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "stringFilter": {
    object (StringFilter)
  },
  "inListFilter": {
    object (InListFilter)
  },
  "numericFilter": {
    object (NumericFilter)
  },
  "betweenFilter": {
    object (BetweenFilter)
  }
  // End of mutually exclusive fields.
}
שדות
filterScoping

object (SegmentParameterFilterScoping)

מציינים את ההיקף של המסנן.
השדה שמסננים. בהמשך מפורטת רשימה של שדות שאי אפשר להשתמש בהם בו-זמנית. רק אחד מהשדות הבאים יוגדר בתשובה:
eventParameterName

string

המסנן הזה יעבור הערכה על פרמטר של אירוע שצוין. פרמטרים של אירועים נרשמים ביומן כפרמטרים של האירוע. פרמטרים של אירועים כוללים שדות כמו firebase_screen ו-currency.

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

string

המסנן הזה יעבור הערכה על פרמטר הפריט שצוין. פרמטרים של פריטים נרשמים ביומן כפרמטרים במערך הפריטים. פרמטרים של פריטים כוללים שדות כמו item_name ו-item_category.

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

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

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