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)

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

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

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

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

פילוח

פלח הוא קבוצת משנה של נתונים ב-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

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

טיפוסים בני מנייה (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 ימים רצופים. לדוגמה, הנתונים מהתקופה 2021-11-01 עד 3 בנובמבר 2021, 2021-11-04 עד 4 בנובמבר 2021 עד 5 בנובמבר 2021 וכו'.

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

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

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

SamplingMetadata

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

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

string (int64 format)

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

samplingSpaceSize

string (int64 format)

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

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

PropertyQuota

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

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

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