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

DateRange

קבוצת ימים רציפה: startDate, startDate + 1, ..., endDate. אפשר לשלוח בקשות עד 4 טווחי תאריכים.

ייצוג JSON 
{
  "startDate": string,
  "endDate": string,
  "name": string
}
שדות
startDate

string

תאריך ההתחלה הכולל של השאילתה בפורמט YYYY-MM-DD. לא ניתן אחרי endDate. אפשר להשתמש גם בפורמטים NdaysAgo, yesterday או today, ובמקרה הזה המערכת מסיקה את התאריך לפי אזור הזמן לדיווח של הנכס.
endDate

string

תאריך הסיום הכולל של השאילתה בפורמט YYYY-MM-DD. לא יכול להיות לפני startDate. אפשר להשתמש גם בפורמטים NdaysAgo, yesterday או today, ובמקרה הזה המערכת מסיקה את התאריך לפי אזור הזמן לדיווח של הנכס.
name

string

הקצאת שם לטווח התאריכים הזה. הערך של המאפיין dateRange הוא השם הזה בתגובת דוח. אם המדיניות מוגדרת, היא לא יכולה להתחיל עם date_range_ או RESERVED_. אם המדיניות לא מוגדרת, השמות של טווחי התאריכים נכללים באינדקס שמבוסס על אפסים בבקשה: date_range_0, date_range_1 וכו'.

משפך

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

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

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

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

StringFilter

סינון לפי מחרוזת

ייצוג JSON 
{
  "matchType": enum (MatchType),
  "value": string,
  "caseSensitive": boolean
}
שדות
matchType

enum (MatchType)

סוג ההתאמה למסנן הזה.
value

string

ערך המחרוזת ששימש להתאמה.
caseSensitive

boolean

אם הערך הוא True, ערך המחרוזת הוא תלוי אותיות רישיות.

MatchType

סוג ההתאמה של מסנן מחרוזת

טיפוסים בני מנייה (enums)
MATCH_TYPE_UNSPECIFIED לא צוין
EXACT התאמה מדויקת של ערך המחרוזת.
BEGINS_WITH מתחיל בערך המחרוזת.
ENDS_WITH מסתיים בערך המחרוזת.
CONTAINS מכיל את ערך המחרוזת.
FULL_REGEXP התאמה מלאה של הביטוי הרגולרי לערך המחרוזת.
PARTIAL_REGEXP התאמה חלקית של הביטוי הרגולרי לערך המחרוזת.

InListFilter

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

ייצוג JSON 
{
  "values": [
    string
  ],
  "caseSensitive": boolean
}
שדות
values[]

string

הרשימה של ערכי המחרוזת. אי אפשר להשאיר את השדה ריק.
caseSensitive

boolean

אם הערך הוא True, ערך המחרוזת הוא תלוי אותיות רישיות.

NumericFilter

מסננים לערכים מספריים או לערכים של תאריכים.

ייצוג JSON 
{
  "operation": enum (Operation),
  "value": {
    object (NumericValue)
  }
}
שדות
operation

enum (Operation)

סוג הפעולה למסנן הזה.
value

object (NumericValue)

ערך מספרי או ערך תאריך.

פעולה

הפעולה שהוחלה על מסנן מספרי

טיפוסים בני מנייה (enums)
OPERATION_UNSPECIFIED לא צוין.
EQUAL שווה
LESS_THAN פחות מ-
LESS_THAN_OR_EQUAL פחות מ- או שווה ל-
GREATER_THAN גדול מ-
GREATER_THAN_OR_EQUAL גדול מ- או שווה ל-

NumericValue

שמייצג מספר.

ייצוג JSON 
{

  // Union field one_value can be only one of the following:
  "int64Value": string,
  "doubleValue": number
  // End of list of possible types for union field one_value.
}
שדות
שדה איחוד one_value. אחד מהערכים המספריים של one_value יכול להיות רק אחד מהערכים הבאים:
int64Value

string (int64 format)

ערך של מספר שלם
doubleValue

number

ערך כפול

BetweenFilter

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

ייצוג JSON 
{
  "fromValue": {
    object (NumericValue)
  },
  "toValue": {
    object (NumericValue)
  }
}
שדות
fromValue

object (NumericValue)

מתחיל במספר הזה.
toValue

object (NumericValue)

מסתיים במספר הזה.

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.

המאפיין

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

ייצוג JSON 
{
  "name": string,
  "dimensionExpression": {
    object (DimensionExpression)
  }
}
שדות
name

string

שם המאפיין. בקטע מאפייני API מופיעה רשימה של שמות המאפיינים שנתמכים בשיטות דיווח מרכזיות, כמו runReport ו-batchRunReports. בקטע מאפיינים בזמן אמת מופיעה רשימה של שמות המאפיינים שנתמכים בשיטת runRealtimeReport. בקטע מאפייני משפך מופיעה רשימה של שמות המאפיינים שנתמכים בשיטה runFunnelReport.

אם מציינים dimensionExpression, name יכול להיות כל מחרוזת שרוצים בתוך קבוצת התווים המותרת. לדוגמה, אם dimensionExpression משרשר את country ו-city, אפשר לקרוא למאפיין הזה countryAndCity. שמות המאפיינים שבוחרים חייבים להתאים לביטוי הרגולרי ^[a-zA-Z0-9_]$.

המאפיינים name מפנים למאפיינים בdimensionFilter, בorderBys, בdimensionExpression ובpivots.
dimensionExpression

object (DimensionExpression)

מאפיין אחד יכול להיות תוצאה של ביטוי של כמה מאפיינים. לדוגמה, המאפיין 'מדינה, עיר': שרשור(מדינה, ", ", עיר).

DimensionExpression

משמש לציון מאפיין שהוא תוצאה של נוסחה של כמה מאפיינים. שימושים לדוגמה: 1) lowerCase(dimension) 2) שרשור(dimension1, icon, dimension2).

ייצוג JSON 
{

  // Union field one_expression can be only one of the following:
  "lowerCase": {
    object (CaseExpression)
  },
  "upperCase": {
    object (CaseExpression)
  },
  "concatenate": {
    object (ConcatenateExpression)
  }
  // End of list of possible types for union field one_expression.
}
שדות
שדה איחוד one_expression. יש לציין סוג אחד של ביטוי מאפיין עבור DimensionExpression. one_expression יכול להיות רק אחד מהבאים:
lowerCase

object (CaseExpression)

משמש להמרת ערך של מאפיין לאותיות קטנות.
upperCase

object (CaseExpression)

משמש להמרת ערך של מאפיין לאותיות רישיות.
concatenate

object (ConcatenateExpression)

משמש לשילוב ערכי מאפיינים למאפיין אחד. לדוגמה, המאפיין 'מדינה, עיר': שרשור(מדינה, ", ", עיר).

CaseExpression

משמש להמרת ערך של מאפיין לאותיות גדולות או קטנות.

ייצוג JSON 
{
  "dimensionName": string
}
שדות
dimensionName

string

שם של מאפיין. השם חייב להתייחס לשם בשדה המימדים של הבקשה.

ConcatenateExpression

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

ייצוג JSON 
{
  "dimensionNames": [
    string
  ],
  "delimiter": string
}
שדות
dimensionNames[]

string

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

string

התו המפריד בין שמות המאפיינים.

תווים מפרידים הם בדרך כלל תווים יחידים כמו '|' או ',', אבל הם יכולים להיות מחרוזות ארוכות יותר. אם ערך מאפיין מכיל את התו המפריד, שניהם יוצגו בתגובה ללא הבחנה. לדוגמה,אם הערך של מאפיין 1 = "US,FR", ערך של מאפיין 2 = "JP" והתו המפריד = ",", התשובה תכיל את הערכים "US,FR,JP".

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.

FilterExpression

כדי לציין מסננים של מאפיינים או מדדים. השדות באותו FilterExpression צריכים להיות כל המאפיינים או כל המדדים.

ייצוג JSON 
{

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

object (FilterExpressionList)

ל-FilterExpressions ב-ו-Group יש קשר AND.
orGroup

object (FilterExpressionList)

ל-FilterExpressions או ל-Groups יש קשר OR.
notExpression

object (FilterExpression)

ה-FilterExpression אינו notExpression.
filter

object (Filter)

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

FilterExpressionList

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

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

object (FilterExpression)

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

סינון

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

ייצוג 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. ציון סוג מסנן אחד עבור Filter. one_filter יכול להיות רק אחד מהבאים:
stringFilter

object (StringFilter)

מסנן שקשור למחרוזות.
inListFilter

object (InListFilter)

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

object (NumericFilter)

מסנן לערכים מספריים או לערכים של תאריכים.
betweenFilter

object (BetweenFilter)

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

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)

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

DimensionHeader

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

ייצוג JSON 
{
  "name": string
}
שדות
name

string

שם המאפיין.

MetricHeader

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

ייצוג JSON 
{
  "name": string,
  "type": enum (MetricType)
}
שדות
name

string

שם המדד.
type

enum (MetricType)

סוג הנתונים של המדד.

MetricType

סוג הערך של המדד.

טיפוסים בני מנייה (enums)
METRIC_TYPE_UNSPECIFIED הסוג לא צוין.
TYPE_INTEGER סוג מספר שלם.
TYPE_FLOAT סוג נקודה צפה (floating-point).
TYPE_SECONDS משך זמן של שניות. סוג מיוחד של נקודה צפה (floating-point).
TYPE_MILLISECONDS משך זמן באלפיות שנייה. סוג מיוחד של נקודה צפה (floating-point).
TYPE_MINUTES משך זמן בדקות; סוג מיוחד של נקודה צפה (floating-point).
TYPE_HOURS משך זמן בשעות, סוג מיוחד של נקודה צפה (floating-point).
TYPE_STANDARD מדד מותאם אישית מסוג סטנדרטי; סוג מיוחד של נקודה צפה (floating-point).
TYPE_CURRENCY סכום כסף, סוג של נקודה צפה (floating-point).
TYPE_FEET אורך במטרים; סוג מיוחד של נקודה צפה (floating-point).
TYPE_MILES אורך במיילים. סוג מיוחד של נקודה צפה (floating-point).
TYPE_METERS אורך במטרים. סוג מיוחד של נקודה צפה (floating-point).
TYPE_KILOMETERS אורך בקילומטרים. סוג מיוחד של נקודה צפה (floating-point).

שורה

דיווח על נתוני כל שורה. לדוגמה, אם RunReportRequest כולל:

"dimensions": [
  {
    "name": "eventName"
  },
  {
    "name": "countryId"
  }
],
"metrics": [
  {
    "name": "eventCount"
  }
]

שורה אחת עם האירוע eventName היא 'in_app_purchase', 'JP' כמזהה המדינה ו-15 בתור eventCount, תהיה:

"dimensionValues": [
  {
    "value": "in_app_purchase"
  },
  {
    "value": "JP"
  }
],
"metricValues": [
  {
    "value": "15"
  }
]
ייצוג JSON 
{
  "dimensionValues": [
    {
      object (DimensionValue)
    }
  ],
  "metricValues": [
    {
      object (MetricValue)
    }
  ]
}
שדות
dimensionValues[]

object (DimensionValue)

רשימה של ערכי המאפיינים המבוקשים. ב-PivotReport, ערכי מאפיינים מופיעים רק עבור המאפיינים שנכללים בטבלת צירים.
metricValues[]

object (MetricValue)

רשימת ערכי מדדים גלויים שהתבקשו.

DimensionValue

הערך של מאפיין.

ייצוג JSON 
{

  // Union field one_value can be only one of the following:
  "value": string
  // End of list of possible types for union field one_value.
}
שדות
שדה איחוד one_value. ערך מאפיין מסוג one_value יכול להיות רק אחד מהערכים הבאים:
value

string

ערך כמחרוזת אם סוג המאפיין הוא מחרוזת.

MetricValue

הערך של מדד.

ייצוג JSON 
{

  // Union field one_value can be only one of the following:
  "value": string
  // End of list of possible types for union field one_value.
}
שדות
שדה איחוד one_value. אחד מערכים של one_value יכול להיות רק אחד מהבאים:
value

string

ערך מדידה. סוג הפנייה MetricHeader.

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

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