Method: properties.runFunnelReport

הפונקציה מחזירה דוח משפך מותאם אישית שכולל את נתוני האירוע שלכם ב-Google Analytics. הנתונים שמוחזרים מה-API הם כטבלה עם עמודות עבור המאפיינים והמדדים המבוקשים.

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

נכון לעכשיו השיטה מבוססת על יציבות אלפא במטרה לקבל משוב על תחביר ויכולות לפני המעבר לבטא. כדי לשלוח משוב על ה-API הזה, אתם יכולים למלא את המשוב על דיווח משפך לגבי Google Analytics Data API.

בקשת HTTP

POST https://analyticsdata.googleapis.com/v1alpha/{property=properties/*}:runFunnelReport

בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.

פרמטרים של נתיב

פרמטרים
property

string

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

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

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

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

פילוח

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

מידע נוסף זמין במאמר בונה הפלחים של GA4.

ייצוג JSON 
{
  "name": string,

  // Union field one_segment_scope can be only one of the following:
  "userSegment": {
    object (UserSegment)
  },
  "sessionSegment": {
    object (SessionSegment)
  },
  "eventSegment": {
    object (EventSegment)
  }
  // End of list of possible types for union field one_segment_scope.
}
שדות
name

string

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

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

טיפוסים בני מנייה (enums)
USER_CRITERIA_SCOPING_UNSPECIFIED בחירת היקף לקריטריונים שלא צוינו. אין לציין.
USER_CRITERIA_WITHIN_SAME_EVENT אם הקריטריונים מתקיימים באירוע אחד, המשתמש מתאים לקריטריונים.
USER_CRITERIA_WITHIN_SAME_SESSION אם הקריטריונים מתקיימים במהלך סשן אחד, המשתמש מתאים לקריטריונים.
USER_CRITERIA_ACROSS_ALL_SESSIONS אם הקריטריונים מתקיימים עבור המשתמש בעקבות אירועים כלשהם, המשתמש מתאים לקריטריונים.

SegmentFilterExpression

מבטאים שילובים של מסנני פלחים.

ייצוג JSON 
{

  // Union field expr can be only one of the following:
  "andGroup": {
    object (SegmentFilterExpressionList)
  },
  "orGroup": {
    object (SegmentFilterExpressionList)
  },
  "notExpression": {
    object (SegmentFilterExpression)
  },
  "segmentFilter": {
    object (SegmentFilter)
  },
  "segmentEventFilter": {
    object (SegmentEventFilter)
  }
  // End of list of possible types for union field expr.
}
שדות
שדה איחוד expr. ציון סוג מסנן אחד עבור SegmentFilterExpression. expr יכול להיות רק אחד מהבאים:
andGroup

object (SegmentFilterExpressionList)

ל-segmentFilterExpression ב-andGroup יש קשר AND.
orGroup

object (SegmentFilterExpressionList)

ל-segmentFilterExpression ב-orGroup יש קשר OR.
notExpression

object (SegmentFilterExpression)

הערך segmentFilterExpression לא הוא notExpression.
segmentFilter

object (SegmentFilter)

מסנן פלחים פרימיטיביים.
segmentEventFilter

object (SegmentEventFilter)

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

SegmentFilterExpressionList

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

ייצוג JSON 
{
  "expressions": [
    {
      object (SegmentFilterExpression)
    }
  ]
}
שדות
expressions[]

object (SegmentFilterExpression)

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

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, הערך של eventName הוא 'purchase', פרמטר האירוע הוא 'event_count' והקריטריונים של המסנן גדולים מ-5, המסנן הזה יצבור את מספר אירועי הרכישה בכל תקופה של 3 ימים רצופים בטווח התאריכים של הדוח. משתמש יעביר את הקריטריונים של המסנן הזה כדי שייכללו בפלח הזה אם מספר אירועי הרכישה שלו יחרוג מ-5 בכל תקופה של 3 ימים רצופים. לדוגמה, המערכת תביא בחשבון את התקופות 2021-11-01 עד 3/11-2021 עד 4/11/2021, 3/11/2021 עד 5/11/2021 וכן הלאה.

טווח התאריכים לא מורחב כדי ליצור חלון מלא של N ימים קרוב לתחילת טווח התאריכים. לדוגמה, אם הדוח מתייחס ל-1 בנובמבר 2021 עד 10 בנובמבר 2021, inAnyNDayPeriod = 3, התקופה של היומיים הראשונים תקוצר כי לא ייקראו נתוני אירועים שנמצאים מחוץ לטווח התאריכים של הדוח. לדוגמה, ארבע התקופות הראשונות יהיו בפועל: 1.11.2021 עד 1.11.2021 עד 1.11.2021 עד 2.11.2021 עד 3.11.2021 ו-1.11.2021 עד 2.11.2021.

הערך 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.

טיפוסים בני מנייה (enums)
USER_EXCLUSION_DURATION_UNSPECIFIED משך הזמן להחרגה לא צוין. אין לציין.
USER_EXCLUSION_TEMPORARY מחריגים משתמשים מהפלח באופן זמני בתקופות שבהן המשתמשים עומדים בתנאי userExclusionCriteria.
USER_EXCLUSION_PERMANENT מחריגים משתמשים מהפלח באופן קבוע אם הם עומדים בתנאי userExclusionCriteria.

SessionSegment

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

ייצוג JSON 
{
  "sessionInclusionCriteria": {
    object (SessionSegmentCriteria)
  },
  "exclusion": {
    object (SessionSegmentExclusion)
  }
}
שדות
sessionInclusionCriteria

object (SessionSegmentCriteria)

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

object (SessionSegmentExclusion)

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

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

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

טיפוסים בני מנייה (enums)
SESSION_CRITERIA_SCOPING_UNSPECIFIED בחירת היקף לקריטריונים שלא צוינו. אין לציין.
SESSION_CRITERIA_WITHIN_SAME_EVENT אם הקריטריונים מתקיימים באירוע אחד, הסשן תואם לקריטריונים.
SESSION_CRITERIA_WITHIN_SAME_SESSION אם הקריטריונים מתקיימים במהלך סשן אחד, הסשן תואם לקריטריונים.

SessionSegmentExclusion

מציין אילו ביקורים מוחרגים בפלח הזה.

ייצוג JSON 
{
  "sessionExclusionDuration": enum (SessionExclusionDuration),
  "sessionExclusionCriteria": {
    object (SessionSegmentCriteria)
  }
}
שדות
sessionExclusionDuration

enum (SessionExclusionDuration)

מציין כמה זמן ההחרגה תישאר בתוקף אם סשן תואם ל-sessionExclusionCriteria.

זה שינוי אופציונלי. אם לא צוין אחרת, נעשה שימוש ב-sessionExclusionDuration של SESSION_EXCLUSION_TEMPORARY.
sessionExclusionCriteria

object (SessionSegmentCriteria)

אם סשן עומד בתנאי הזה, הסשן לא ייכלל בפלח של sessionExclusionDuration.

SessionExclusionDuration

מציין את האפשרויות למשך הזמן שבו ההחרגה תהיה בתוקף אם סשן תואם ל-sessionExclusionCriteria.

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

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

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

טיפוסים בני מנייה (enums)
EVENT_CRITERIA_SCOPING_UNSPECIFIED בחירת היקף לקריטריונים שלא צוינו. אין לציין.
EVENT_CRITERIA_WITHIN_SAME_EVENT אם הקריטריונים מתקיימים באירוע אחד, האירוע תואם לקריטריונים.

EventSegmentExclusion

מציין אילו אירועים מוחרגים מהפלח הזה.

ייצוג JSON 
{
  "eventExclusionDuration": enum (EventExclusionDuration),
  "eventExclusionCriteria": {
    object (EventSegmentCriteria)
  }
}
שדות
eventExclusionDuration

enum (EventExclusionDuration)

הערך eventExclusionDuration צריך תמיד להיות PERMANENTLY_EXCLUDE.

זה שינוי אופציונלי. אם לא צוין ערך, נעשה שימוש ב-eventExclusionDuration של EVENT_EXCLUSION_PERMANENT.
eventExclusionCriteria

object (EventSegmentCriteria)

אם אירוע עומד בתנאי הזה, האירוע לא ייכלל בפלח של eventExclusionDuration.

EventExclusionDuration

מציין את האפשרויות למשך הזמן שבו ההחרגה תישאר אם אירוע מסוים תואם ל-eventExclusionCriteria.

טיפוסים בני מנייה (enums)
EVENT_EXCLUSION_DURATION_UNSPECIFIED משך הזמן להחרגה לא צוין. אין לציין.
EVENT_EXCLUSION_PERMANENT מחריגים אירועים מהפלח באופן סופי אם האירוע עומד אי פעם בתנאי eventExclusionCriteria.

FunnelSubReport

דוחות המשנה של המשפך מכילים את ערכי הנתונים של המאפיינים והמדדים. לדוגמה, 12 משתמשים הגיעו לשלב השני במשפך.

ייצוג JSON 
{
  "dimensionHeaders": [
    {
      object (DimensionHeader)
    }
  ],
  "metricHeaders": [
    {
      object (MetricHeader)
    }
  ],
  "rows": [
    {
      object (Row)
    }
  ],
  "metadata": {
    object (FunnelResponseMetadata)
  }
}
שדות
dimensionHeaders[]

object (DimensionHeader)

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

object (MetricHeader)

מתאר עמודות מטריות. דוחות המשפך כוללים תמיד משתמשים פעילים בתגובות לדוח המשנה. טבלת המשפך כוללת מדדים נוספים כמו שיעור ההשלמה, נטישות ושיעור הנטישה.
rows[]

object (Row)

שורות של שילובי ערכי מאפיינים וערכי מדדים בדוח.
metadata

object (FunnelResponseMetadata)

מטא-נתונים של דוח המשפך.

FunnelResponseMetadata

המטא-נתונים של התשובות בדוח המשפך כוללים מידע נוסף לגבי דוח המשפך.

ייצוג JSON 
{
  "samplingMetadatas": [
    {
      object (SamplingMetadata)
    }
  ]
}
שדות
samplingMetadatas[]

object (SamplingMetadata)

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

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

SamplingMetadata

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

ייצוג JSON 
{
  "samplesReadCount": string,
  "samplingSpaceSize": string
}
שדות
samplesReadCount

string (int64 format)

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

string (int64 format)

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

כדי לחשב את אחוז הנתונים הזמינים שבהם נעשה שימוש בדוח המשפך הזה, צריך לחשב את הערך samplesReadCount/samplingSpaceSize.

PropertyQuota

המצב הנוכחי של כל המכסות בנכס Analytics הזה. אם תנוצל כל המכסה בנכס, כל הבקשות לנכס הזה יחזירו שגיאות של 'מיצוי המשאבים'.

ייצוג JSON 
{
  "tokensPerDay": {
    object (QuotaStatus)
  },
  "tokensPerHour": {
    object (QuotaStatus)
  },
  "concurrentRequests": {
    object (QuotaStatus)
  },
  "serverErrorsPerProjectPerHour": {
    object (QuotaStatus)
  },
  "potentiallyThresholdedRequestsPerHour": {
    object (QuotaStatus)
  },
  "tokensPerProjectPerHour": {
    object (QuotaStatus)
  }
}
שדות
tokensPerDay

object (QuotaStatus)

נכסים רגילים של Analytics יכולים להשתמש בעד 200,000 אסימונים ביום. נכסי Analytics 360 יכולים להשתמש ב-2,000,000 אסימונים ביום. בשביל רוב הבקשות צריך פחות מ-10 אסימונים.
tokensPerHour

object (QuotaStatus)

נכסים רגילים של Analytics יכולים להשתמש בעד 40,000 אסימונים בשעה. נכסים של Analytics 360 יכולים להשתמש ב-400,000 אסימונים בשעה. בקשת API צורכת מספר יחיד של אסימונים, והמספר מנוכה מכל המכסות השעתיות, היומיות והשעתיות של הפרויקט.
concurrentRequests

object (QuotaStatus)

נכסי Analytics רגילים יכולים לשלוח עד 10 בקשות בו-זמנית. נכסי Analytics 360 יכולים להשתמש ב-50 בקשות בו-זמנית לכל היותר.
serverErrorsPerProjectPerHour

object (QuotaStatus)

בנכסים רגילים של Analytics ובצמדים של פרויקטים בענן יכולות להיות עד 10 שגיאות שרת בשעה. בנכסים של Analytics 360 ובצמדים של פרויקטים בענן יכולות להיות עד 50 שגיאות שרת בשעה.
potentiallyThresholdedRequestsPerHour

object (QuotaStatus)

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

object (QuotaStatus)

נכסים של Analytics יכולים להשתמש ב-35% לכל היותר מהאסימונים שלהם בכל פרויקט בשעה. לעומת זאת, נכסים רגילים של Analytics יכולים להשתמש ב-14,000 אסימונים לכל פרויקט בשעה, ונכסים של Analytics 360 יכולים להשתמש ב-140,000 אסימונים לכל פרויקט בשעה. בקשת API צורכת מספר יחיד של אסימונים, והמספר מנוכה מכל המכסות השעתיות, היומיות והשעתיות של הפרויקט.

QuotaStatus

המצב הנוכחי של קבוצת מכסות מסוימת.

ייצוג JSON 
{
  "consumed": integer,
  "remaining": integer
}
שדות
consumed

integer

המכסה נוצלה בעקבות הבקשה הזו.
remaining

integer

המכסה שנותרה אחרי הבקשה הזו.