Method: properties.runFunnelReport

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

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

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

בקשת HTTP

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

כתובת ה-URL משתמשת בתחביר של Transcoding של gRPC.

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

פרמטרים
property

string

זה שינוי אופציונלי. מזהה של נכס 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

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

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

object (UserSegmentSequenceGroup)

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

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, הערך של eventName הוא 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 ימים מלא בתחילת טווח התאריכים. לדוגמה, אם הדוח הוא עבור 1 בנובמבר 2021 עד 10 בנובמבר 2021 ו-inAnyNDayPeriod = 3, תקופת היומיים הראשונים תתקצר בפועל כי לא יקראו נתוני אירועים מחוץ לטווח התאריכים של הדוח. לדוגמה, ארבעת התקופות הראשונות יהיו בפועל: 1 בנובמבר 2021 עד 1 בנובמבר 2021, 1 בנובמבר 2021 עד 2 בנובמבר 2021, 1 בנובמבר 2021 עד 3 בנובמבר 2021 ו-2 בנובמבר 2021 עד 4 בנובמבר 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 שניות ו-1 מיקרו-שנייה.

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

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