- בקשת HTTP
- פרמטרים של נתיב
- גוף הבקשה
- גוף התשובה
- היקפי ההרשאות
- משפך
- FunnelStep
- FunnelFilterExpression
- FunnelFilterExpressionList
- FunnelFieldFilter
- FunnelEventFilter
- FunnelParameterFilterExpression
- FunnelParameterFilterExpressionList
- FunnelParameterFilter
- FunnelBreakdown
- FunnelNextAction
- FunnelVisualizationType
- פילוח
- UserSegment
- UserSegmentCriteria
- UserSegmentConditionGroup
- UserCriteriaScoping
- SegmentFilterExpression
- SegmentFilterExpressionList
- SegmentFilter
- SegmentFilterScoping
- SegmentEventFilter
- SegmentParameterFilterExpression
- SegmentParameterFilterExpressionList
- SegmentParameterFilter
- SegmentParameterFilterScoping
- UserSegmentSequenceGroup
- UserSequenceStep
- UserSegmentExclusion (החרגה של פלח משתמשים)
- UserExclusionDuration
- SessionSegment
- SessionSegmentCriteria
- SessionSegmentConditionGroup
- SessionCriteriaScoping
- SessionSegmentExclusion (החרגה של סשן)
- SessionExclusionDuration
- EventSegment
- EventSegmentCriteria
- EventSegmentConditionGroup
- EventCriteriaScoping
- EventSegmentExclusion (החרגת האירוע)
- EventExclusionDuration
- FunnelSubReport
- FunnelResponseMetadata
- SamplingMetadata
- PropertyQuota
- QuotaStatus
- רוצים לנסות?
הפונקציה מחזירה דוח משפך מותאם אישית שכולל את נתוני האירוע שלכם ב-Google Analytics. הנתונים שמוחזרים מה-API הם כטבלה עם עמודות עבור המאפיינים והמדדים המבוקשים.
ניתוח משפך ממחיש חזותית את הפעולות שהמשתמשים מבצעים כדי להשלים משימה, ומאפשר לכם לבדוק מה מידת ההצלחה שלהם בכל שלב. לדוגמה, מה הופך לקוחות פוטנציאליים לקונים ומה גורם להם לבצע את הרכישה בפועל? מה גורם למשתמשים שקנו אצלכם פעם אחת להפוך לקונים חוזרים? המידע הזה יבהיר לכם אילו שלבים במסלול להמרת לקוח לא יעילים ובאילו שלבים הלקוחות נוטשים ויעזור לכם לשפר ולייעל את השלבים האלה. מידע נוסף זמין במאמר ניתוח משפכים של GA4.
נכון לעכשיו השיטה מבוססת על יציבות אלפא במטרה לקבל משוב על תחביר ויכולות לפני המעבר לבטא. כדי לשלוח משוב על ה-API הזה, אתם יכולים למלא את המשוב על דיווח משפך לגבי Google Analytics Data API.
בקשת HTTP
POST https://analyticsdata.googleapis.com/v1alpha/{property=properties/*}:runFunnelReport
בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.
פרמטרים של נתיב
פרמטרים | |
---|---|
property |
זה שינוי אופציונלי. מזהה נכס GA4 של Google Analytics שיש מעקב אחרי האירועים שלו. מצוין בנתיב כתובת ה-URL ולא בגוף הטקסט. למידע נוסף, אפשר לעיין במאמר איפה למצוא את מזהה הנכס. בתוך בקשה באצווה, המאפיין הזה צריך להיות לא מוגדר או תואם למאפיין ברמת האצווה. דוגמה: properties/1234 |
גוף הבקשה
גוף הבקשה מכיל נתונים במבנה הבא:
ייצוג JSON |
---|
{ "dateRanges": [ { object ( |
שדות | |
---|---|
dateRanges[] |
זה שינוי אופציונלי. טווחי תאריכים של נתונים לקריאה. אם מבקשים מספר טווחי תאריכים, כל שורת תגובה תכיל אינדקס של טווח תאריכים מבוסס אפס. אם שני טווחי תאריכים חופפים, נתוני האירועים של הימים החופפים נכללים בשורות התגובה של שני טווחי התאריכים. |
funnel |
זה שינוי אופציונלי. התצורה של המשפך של הבקשה הזו. חובה להגדיר את המשפך. |
funnelBreakdown |
זה שינוי אופציונלי. אם צוין אחרת, הפירוט הזה יוסיף מאפיין לתגובה בדוח המשנה של טבלת המשפך. מאפיין הפירוט הזה מרחיב כל שלב במשפך לערכים הייחודיים של מאפיין הפירוט. לדוגמה, פירוט לפי המאפיין |
funnelNextAction |
זה שינוי אופציונלי. אם צוין, הפעולה הבאה מוסיפה מאפיין לתגובה של דוח המשנה בנושא הצגת משפך. מאפיין הפעולה הבאה מרחיב כל שלב במשפך לערכים הייחודיים של הפעולה הבאה. לדוגמה, הפעולה הבאה של המאפיין הפעולה הבאה תומכת רק ב- |
funnelVisualizationType |
זה שינוי אופציונלי. סוג התצוגה החזותית של המשפך קובע את המאפיינים שמופיעים בתגובה של דוח המשנה 'תצוגה חזותית של משפך'. אם לא מציינים שום אפשרות, ייעשה שימוש ב- |
segments[] |
זה שינוי אופציונלי. התצורות של הפלחים. פלחים הם קבוצות משנה של נתונים בנכס. בדוח משפך עם פלחים, המשפך עובר הערכה בכל פלח. כל מקטע שצוין בבקשה הזו יוצר שורה נפרדת בתשובה. בתגובה, כל פלח שמזוהה לפי השם שלו. הפרמטר segments הוא אופציונלי. הבקשות מוגבלות ל-4 קטעים. |
limit |
זה שינוי אופציונלי. מספר השורות שיש להחזיר. אם לא צוין אחרת, יוחזרו 10,000 שורות. ה-API מחזיר עד 250,000 שורות לבקשה, ללא קשר לכמות שתבקש. הערך כמו כן, ה-API יכול להחזיר פחות שורות מהשדה |
dimensionFilter |
זה שינוי אופציונלי. מסנני מאפיינים מאפשרים לכם לבקש רק ערכי מאפיינים ספציפיים בדוח. מידע נוסף מפורט במאמר יצירת דוח: מסנני מאפיינים. אי אפשר להשתמש במדדים במסנן הזה. |
returnPropertyQuota |
זה שינוי אופציונלי. הלחצן מציין אם להחזיר את המצב הנוכחי של המכסה בנכס Analytics הזה. המכסות מוחזרות ב-PropertyQuota. |
גוף התשובה
התשובה של דוח המשפך מכילה שני דוחות משנה. שני דוחות המשנה הם שילובים שונים של מאפיינים ומדדים.
אם הפעולה בוצעה ללא שגיאות, גוף התשובה מכיל נתונים במבנה הבא:
ייצוג JSON |
---|
{ "funnelTable": { object ( |
שדות | |
---|---|
funnelTable |
טבלת המשפך היא דוח שכולל את השלבים במשפך, הפלח, מאפיין הפירוט, משתמשים פעילים, שיעור ההשלמה, נטישה ושיעור הנטישה. מאפיין הפלח מופיע בתגובה הזו רק אם נשלחה בקשה לפלח. מאפיין הפירוט יופיע בתגובה הזו רק אם היא התבקשה. |
funnelVisualization |
התצוגה החזותית של המשפך היא דוח שכולל את השלבים במשפך, הפלח, התאריך, מאפיין הפעולה הבאה והמשתמשים הפעילים. מאפיין הפלח מופיע בתגובה הזו רק אם נשלחה בקשה לפלח. מאפיין התאריך מופיע בתגובה הזו רק אם הבקשה נשלחה דרך סוג המשפך |
propertyQuota |
מצב המכסה של נכס Analytics הזה, כולל הבקשה הזו. |
kind |
מזהה את סוג המשאב ההודעה הזו. |
היקפי הרשאות
נדרש אחד מהיקפי ההרשאות הבאים של OAuth:
https://www.googleapis.com/auth/analytics.readonly
https://www.googleapis.com/auth/analytics
משפך
מגדיר את המשפך בבקשה לדוח משפך. במשפך מדווח על המשתמשים כשהם עוברים ברצף של שלבים.
ניתוח משפך ממחיש חזותית את הפעולות שהמשתמשים מבצעים כדי להשלים משימה, ומאפשר לכם לבדוק מה מידת ההצלחה שלהם בכל שלב. לדוגמה, מה הופך לקוחות פוטנציאליים לקונים ומה גורם להם לבצע את הרכישה בפועל? מה גורם למשתמשים שקנו אצלכם פעם אחת להפוך לקונים חוזרים? המידע הזה יבהיר לכם אילו שלבים במסלול להמרת לקוח לא יעילים ובאילו שלבים הלקוחות נוטשים ויעזור לכם לשפר ולייעל את השלבים האלה.
ייצוג JSON |
---|
{
"isOpenFunnel": boolean,
"steps": [
{
object ( |
שדות | |
---|---|
isOpenFunnel |
במשפך פתוח, משתמשים יכולים להיכנס למשפך בכל שלב, ובמשפך סגור המשתמשים חייבים להיכנס למשפך בשלב הראשון. זה שינוי אופציונלי. אם לא צוין אחרת, המערכת משתמשת במשפך סגור. |
steps[] |
השלבים ברצף של המשפך הזה. |
FunnelStep
השלבים מגדירים את החלקים שאתם רוצים למדוד בתהליך שעובר המשתמש. בכל שלב יש תנאי אחד או יותר שהמשתמשים צריכים לעמוד בו כדי להיכלל באותו שלב במשפך.
ייצוג JSON |
---|
{
"name": string,
"isDirectlyFollowedBy": boolean,
"filterExpression": {
object ( |
שדות | |
---|---|
name |
השם הייחודי של השלב הזה. אם לא צוין השם, השלבים ייקראו לפי שם אינדקס מבוסס 1 (לדוגמה "0. ", "1. " וכו'). השם הזה מגדיר את ערך המחרוזת המוחזר על ידי המאפיין |
isDirectlyFollowedBy |
אם הערך הוא True, השלב הזה חייב לבצע ישירות את השלב הקודם. אם הערך הוא False, יכולים להיות אירועים בין השלב הקודם לשלב הזה. אם לא צוין, |
filterExpression |
התנאי שהמשתמשים צריכים לעמוד בו כדי להיכלל בשלב הזה במשפך. |
withinDurationFromPriorStep |
אם צוין, שלב זה חייב להסתיים בתוך פרק הזמן הזה של השלמת השלב הקודם.
משך זמן בשניות עם עד תשע ספרות עשרוניות, המסתיים ב-' |
FunnelFilterExpression
מבטאים שילובים של מסנני משפך.
ייצוג JSON |
---|
{ // Union field |
שדות | |
---|---|
שדה איחוד expr . ציון סוג מסנן אחד עבור FunnelFilterExpression . expr יכול להיות רק אחד מהבאים: |
|
andGroup |
ל-FunnelFilterExpression |
orGroup |
ל-FunnelFilterExpression ב- |
notExpression |
הערך FunnelFilterExpression לא הוא |
funnelFieldFilter |
מסנן משפך למאפיין או למדד. |
funnelEventFilter |
יוצר מסנן שתואם לאירועים של שם אירוע יחיד. אם ציינתם ביטוי סינון של פרמטר, רק קבוצת המשנה של האירועים שתואמים גם לשם האירוע היחיד וגם לביטויי סינון הפרמטרים יתאימו למסנן האירועים הזה. |
FunnelFilterExpressionList
רשימה של ביטויי סינון במשפך.
ייצוג JSON |
---|
{
"expressions": [
{
object ( |
שדות | |
---|---|
expressions[] |
רשימת ביטויי הסינון במשפך. |
FunnelFieldFilter
ביטוי לסינון ערכי מאפיינים או מדדים.
ייצוג JSON |
---|
{ "fieldName": string, // Union field |
שדות | |
---|---|
fieldName |
שם המאפיין או שם המדד. |
שדה איחוד one_filter . ציון סוג מסנן אחד. one_filter יכול להיות רק אחד מהבאים: |
|
stringFilter |
מסנן שקשור למחרוזות. |
inListFilter |
מסנן לערכים ברשימה. |
numericFilter |
מסנן לערכים מספריים או לערכים של תאריכים. |
betweenFilter |
מסנן בין שני ערכים. |
FunnelEventFilter
יוצר מסנן שתואם לאירועים של שם אירוע יחיד. אם ציינתם ביטוי סינון של פרמטר, רק קבוצת המשנה של האירועים שתואמים גם לשם האירוע היחיד וגם לביטויי סינון הפרמטרים יתאימו למסנן האירועים הזה.
ייצוג JSON |
---|
{
"eventName": string,
"funnelParameterFilterExpression": {
object ( |
שדות | |
---|---|
eventName |
המסנן הזה תואם לאירועים של שם האירוע היחיד הזה. חובה להזין את שם האירוע. |
funnelParameterFilterExpression |
אם המסנן הזה צוין, המסנן הזה תואם לאירועים שתואמים גם לשם האירוע היחיד וגם לביטויי סינון הפרמטרים. בתוך הביטוי של סינון הפרמטרים, רק מסנני פרמטרים זמינים. |
FunnelParameterFilterExpression
מבטא שילובים של מסנני משפך בפרמטרים.
ייצוג JSON |
---|
{ // Union field |
שדות | |
---|---|
שדה איחוד expr . ציון סוג מסנן אחד עבור FunnelParameterFilterExpression . expr יכול להיות רק אחד מהבאים: |
|
andGroup |
ל-FunnelParameterFilterExpression ב- |
orGroup |
ל-FunnelParameterFilterExpression ב- |
notExpression |
הערך FunnelParameterFilterExpression אינו |
funnelParameterFilter |
מסנן פרמטרים בסיסיים במשפך. |
FunnelParameterFilterExpressionList
רשימה של ביטויי סינון לפרמטרים במשפך.
ייצוג JSON |
---|
{
"expressions": [
{
object ( |
שדות | |
---|---|
expressions[] |
רשימת ביטויי הסינון לפרמטרים במשפך. |
FunnelParameterFilter
ביטוי לסינון ערכי הפרמטרים במשפך.
ייצוג JSON |
---|
{ // Union field |
שדות | |
---|---|
שדה איחוד one_parameter . השדה שמסננים. one_parameter יכול להיות רק אחד מהבאים: |
|
eventParameterName |
המסנן יעבור הערכה לפי פרמטר האירוע שצוין. פרמטרים של אירועים נרשמים כפרמטרים של האירוע. פרמטרים של אירועים כוללים שדות כמו firebase_screen ו-"currency". ניתן להשתמש בפרמטרים של אירועים רק בפלחים ובמשפכים, ואפשר להשתמש בהם רק במסנן צאצא ממסנן EventFilter. במסנן צאצא מ-EventFilter, יש להשתמש בפרמטרים של אירוע או של פריטים. |
itemParameterName |
המסנן הזה יעבור הערכה לפי פרמטר הפריט שצוין. פרמטרים של פריטים נרשמים כפרמטרים במערך הפריטים. פרמטרים של פריטים כוללים שדות כמו "item_name" ו-"item_category". ניתן להשתמש בפרמטרים של פריטים רק בפלחים ובמשפכים, ואפשר להשתמש בהם רק במסנן צאצא ממסנן EventFilter. במסנן צאצא מ-EventFilter, יש להשתמש בפרמטרים של אירוע או של פריטים. פרמטרים של פריטים זמינים רק באירועי מסחר אלקטרוני. מידע נוסף על אירועי מסחר אלקטרוני זמין במדריך מדידת מסחר אלקטרוני. |
שדה איחוד one_filter . ציון סוג מסנן אחד. one_filter יכול להיות רק אחד מהבאים: |
|
stringFilter |
מסנן שקשור למחרוזות. |
inListFilter |
מסנן לערכים ברשימה. |
numericFilter |
מסנן לערכים מספריים או לערכים של תאריכים. |
betweenFilter |
מסנן בין שני ערכים. |
FunnelBreakdown
פירוטים מוסיפים מאפיין לתגובת דוח המשנה של טבלת המשפך.
ייצוג JSON |
---|
{
"breakdownDimension": {
object ( |
שדות | |
---|---|
breakdownDimension |
עמודת המאפיין נוספה לתגובת דוח המשנה של טבלת המשפך. מאפיין הפירוט מציג פירוט של כל שלב במשפך. אם צוין |
limit |
המספר המקסימלי של הערכים הנפרדים של מאפיין הפירוט שיוחזרו בתגובה. אם לא צוינה מגבלה, המערכת תשתמש בערך |
FunnelNextAction
הפעולות הבאות מציין את הערך של מאפיין אחרי שהמשתמש השיג שלב, אבל לפני שאותו המשתמש השיג את השלב הבא. למשל, אם הערך של nextActionDimension
הוא eventName
, אז האירוע nextActionDimension
בשורה הi
של השלב במשפך יחזיר את האירוע הראשון אחרי האירוע שהכשיר את המשתמש לשלב הi
במשפך, אבל לפני שהמשתמש הגיע לשלב ה-i+1
במשפך.
ייצוג JSON |
---|
{
"nextActionDimension": {
object ( |
שדות | |
---|---|
nextActionDimension |
עמודת המאפיין נוספה לתגובה בדוח המשנה של התצוגה החזותית של המשפך. מאפיין הפעולה הבא מחזיר את ערך המאפיין הבא של המאפיין הזה אחרי שהמשתמש מגיע לשלב ה- בשלב זה ב- |
limit |
המספר המקסימלי של הערכים הנפרדים של מאפיין הפירוט שיוחזרו בתגובה. אם לא צוינה מגבלה, המערכת תשתמש בערך |
FunnelVisualizationType
ההגדרה הזו קובעת את המאפיינים שמופיעים בתגובה לדוח המשנה של התצוגה החזותית של המשפך.
טיפוסים בני מנייה (enums) | |
---|---|
FUNNEL_VISUALIZATION_TYPE_UNSPECIFIED |
הסוג לא צוין. |
STANDARD_FUNNEL |
משפך רגיל (מחולק לשלבים). דוח המשנה 'תצוגה חזותית של משפך' שמופיע בתגובה לא יכלול תאריך. |
TRENDED_FUNNEL |
משפך מגמות (תרשים קו). דוח המשנה 'תצוגה חזותית של משפך' שמופיע בתגובה יכלול את מאפיין התאריך. |
פילוח
פלח הוא קבוצת משנה של נתונים ב-Analytics. לדוגמה, מתוך קבוצה כוללת של משתמשים, אפשר ליצור פלח של משתמשים מעיר או ממדינה מסוימות. אתם יכולים ליצור פלח נוסף של משתמשים שקנו סדרת מוצרים מסוימת, נכנסו לחלק מסוים של האתר או הפעילו אירועים מסוימים באפליקציה שלכם.
מידע נוסף זמין במאמר בונה הפלחים של GA4.
ייצוג JSON |
---|
{ "name": string, // Union field |
שדות | |
---|---|
name |
השם של הפלח הזה. אם לא ציינתם פלחים בשם 'פלח'. השם הזה מגדיר את ערך המחרוזת המוחזר על ידי המאפיין |
שדה איחוד one_segment_scope . כל פלח מצוין בהיקף אחד. one_segment_scope יכול להיות רק אחד מהבאים: |
|
userSegment |
פלחי משתמשים הם קבוצות משנה של משתמשים שקיימו אינטראקציה עם האתר או האפליקציה. |
sessionSegment |
פלחי סשנים הם קבוצות משנה של סשנים שהתרחשו באתר או באפליקציה שלכם. |
eventSegment |
פלחי אירועים הם קבוצות משנה של אירועים שהופעלו באתר או באפליקציה שלכם. |
UserSegment
פלחי משתמשים הם קבוצות משנה של משתמשים שהביעו עניין באתר או באפליקציה שלכם. לדוגמה, משתמשים שביצעו רכישה בעבר או משתמשים שהוסיפו פריטים לעגלת הקניות אבל לא השלימו את הרכישה.
ייצוג JSON |
---|
{ "userInclusionCriteria": { object ( |
שדות | |
---|---|
userInclusionCriteria |
מגדיר אילו משתמשים נכללים בפלח הזה. זה שינוי אופציונלי. |
exclusion |
מגדיר אילו משתמשים יוחרגו מהפלח הזה. זה שינוי אופציונלי. |
UserSegmentCriteria
משתמש מתאים לקריטריונים אם האירועים של המשתמש עומדים בתנאים שבקריטריונים.
ייצוג JSON |
---|
{ "andConditionGroups": [ { object ( |
שדות | |
---|---|
andConditionGroups[] |
משתמש תואם לקריטריונים האלה אם הוא תואם לכל אחד מה |
andSequenceGroups[] |
משתמש תואם לקריטריונים האלה אם הוא תואם לכל אחד מה |
UserSegmentConditionGroup
תנאים מורים ל-Analytics אילו נתונים לכלול או לא לכלול בפלח.
ייצוג JSON |
---|
{ "conditionScoping": enum ( |
שדות | |
---|---|
conditionScoping |
אם הנתונים תואמים לקבוצת התנאים, הנתונים נכללים בפלח או מוחרגים ממנו. ההיקפים האלה מגדירים את מספר האירועים שבהם מתבצעת ההערכה של זה שינוי אופציונלי. אם לא צוין אחרת, נעשה שימוש ב- |
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 . ציון סוג מסנן אחד עבור SegmentFilterExpression . expr יכול להיות רק אחד מהבאים: |
|
andGroup |
ל-segmentFilterExpression ב- |
orGroup |
ל-segmentFilterExpression ב- |
notExpression |
הערך segmentFilterExpression לא הוא |
segmentFilter |
מסנן פלחים פרימיטיביים. |
segmentEventFilter |
יוצר מסנן שתואם לאירועים של שם אירוע יחיד. אם ציינתם ביטוי סינון של פרמטר, רק קבוצת המשנה של האירועים שתואמים גם לשם האירוע היחיד וגם לביטויי סינון הפרמטרים יתאימו למסנן האירועים הזה. |
SegmentFilterExpressionList
רשימה של ביטויי סינון של פלחים.
ייצוג JSON |
---|
{
"expressions": [
{
object ( |
שדות | |
---|---|
expressions[] |
רשימה של ביטויים לסינון לפי פילוח |
SegmentFilter
ביטוי לסינון ערכי מאפיינים או מדדים.
ייצוג JSON |
---|
{ "fieldName": string, "filterScoping": { object ( |
שדות | |
---|---|
fieldName |
שם המאפיין או שם המדד. |
filterScoping |
מציין את היקף המסנן. |
שדה איחוד one_filter . ציון סוג מסנן אחד עבור Filter . one_filter יכול להיות רק אחד מהבאים: |
|
stringFilter |
מסנן שקשור למחרוזות. |
inListFilter |
מסנן לערכים ברשימה. |
numericFilter |
מסנן לערכים מספריים או לערכים של תאריכים. |
betweenFilter |
מסנן בין שני ערכים. |
SegmentFilterScoping
היקפים מציינים איך יש להתחשב במאפיינים ובמדדים של כמה אירועים כשבוחנים מסנן לפי פלח.
ייצוג JSON |
---|
{ "atAnyPointInTime": boolean } |
שדות | |
---|---|
atAnyPointInTime |
אם הערך של הפרמטר ניתן לציין את אם בחירת ההיקף של הקריטריונים היא |
SegmentEventFilter
יוצר מסנן שתואם לאירועים של שם אירוע יחיד. אם ציינתם ביטוי סינון של פרמטר, רק קבוצת המשנה של האירועים שתואמים גם לשם האירוע היחיד וגם לביטויי סינון הפרמטרים יתאימו למסנן האירועים הזה.
ייצוג JSON |
---|
{
"eventName": string,
"segmentParameterFilterExpression": {
object ( |
שדות | |
---|---|
eventName |
המסנן הזה תואם לאירועים של שם האירוע היחיד הזה. חובה להזין את שם האירוע. |
segmentParameterFilterExpression |
אם המסנן הזה צוין, המסנן הזה תואם לאירועים שתואמים גם לשם האירוע היחיד וגם לביטויי סינון הפרמטרים. בתוך הביטוי של סינון הפרמטרים, רק מסנני פרמטרים זמינים. |
SegmentParameterFilterExpression
מבטאים שילובים של סינון פלחים בפרמטרים.
ייצוג JSON |
---|
{ // Union field |
שדות | |
---|---|
שדה איחוד expr . ציון סוג מסנן אחד עבור SegmentParameterFilterExpression . expr יכול להיות רק אחד מהבאים: |
|
andGroup |
ל-segmentParameterFilterExpression ב- |
orGroup |
ל-segmentParameterFilterExpression ב- |
notExpression |
הערך של segmentParameterFilterExpression לא הוא |
segmentParameterFilter |
מסנן פרמטרים של פלחים פרימיטיביים. |
SegmentParameterFilterExpressionList
רשימה של ביטויי סינון לפרמטרים של פלחים.
ייצוג JSON |
---|
{
"expressions": [
{
object ( |
שדות | |
---|---|
expressions[] |
רשימת ביטויי הסינון לפרמטרים של פלחים. |
SegmentParameterFilter
ביטוי לסינון ערכי הפרמטרים בקטע.
ייצוג JSON |
---|
{ "filterScoping": { object ( |
שדות | |
---|---|
filterScoping |
מציין את היקף המסנן. |
שדה איחוד one_parameter . השדה שמסננים. one_parameter יכול להיות רק אחד מהבאים: |
|
eventParameterName |
המסנן יעבור הערכה לפי פרמטר האירוע שצוין. פרמטרים של אירועים נרשמים כפרמטרים של האירוע. פרמטרים של אירועים כוללים שדות כמו firebase_screen ו-"currency". ניתן להשתמש בפרמטרים של אירועים רק בפלחים ובמשפכים, ואפשר להשתמש בהם רק במסנן צאצא ממסנן EventFilter. במסנן צאצא מ-EventFilter, יש להשתמש בפרמטרים של אירוע או של פריטים. |
itemParameterName |
המסנן הזה יעבור הערכה לפי פרמטר הפריט שצוין. פרמטרים של פריטים נרשמים כפרמטרים במערך הפריטים. פרמטרים של פריטים כוללים שדות כמו "item_name" ו-"item_category". ניתן להשתמש בפרמטרים של פריטים רק בפלחים ובמשפכים, ואפשר להשתמש בהם רק במסנן צאצא ממסנן EventFilter. במסנן צאצא מ-EventFilter, יש להשתמש בפרמטרים של אירוע או של פריטים. פרמטרים של פריטים זמינים רק באירועי מסחר אלקטרוני. מידע נוסף על אירועי מסחר אלקטרוני זמין במדריך מדידת מסחר אלקטרוני. |
שדה איחוד one_filter . ציון סוג מסנן אחד. one_filter יכול להיות רק אחד מהבאים: |
|
stringFilter |
מסנן שקשור למחרוזות. |
inListFilter |
מסנן לערכים ברשימה. |
numericFilter |
מסנן לערכים מספריים או לערכים של תאריכים. |
betweenFilter |
מסנן בין שני ערכים. |
SegmentParameterFilterScoping
היקפים מציינים את האופן שבו יש להתחשב במספר אירועים כשבוחנים מסנן פרמטרים של פלחים.
ייצוג JSON |
---|
{ "inAnyNDayPeriod": string } |
שדות | |
---|---|
inAnyNDayPeriod |
הפרמטר מצטבר במהלך תקופת הימים שצוינה לפני החלת המסנן. האפשרות נתמכת רק אם היקף הקריטריונים הוא לדוגמה, אם הערך של טווח התאריכים לא מורחב כדי ליצור חלון מלא של N ימים קרוב לתחילת טווח התאריכים. לדוגמה, אם הדוח מתייחס ל-1 בנובמבר 2021 עד 10 בנובמבר 2021, הערך |
UserSegmentSequenceGroup
יש להגדיר את התנאים שחייבים להתקיים בסדר מסוים כדי שהמשתמש יהיה חבר בפלח.
ייצוג JSON |
---|
{ "sequenceScoping": enum ( |
שדות | |
---|---|
sequenceScoping |
כדי שהמשתמש יתאים לרצף, יש להקפיד על כל שלבי הרצף בהיקף. לדוגמה, אם זה שינוי אופציונלי. אם לא צוין אחרת, נעשה שימוש ב- |
sequenceMaximumDuration |
תקופת הזמן שבה כל הרצף צריך להתרחש. לדוגמה, 30 דקות.
משך זמן בשניות עם עד תשע ספרות עשרוניות, המסתיים ב-' |
userSequenceSteps[] |
רצף מסודר של שלבי התנאי. האירועים של המשתמש חייבים להשלים כל שלב כדי שהמשתמש יתאים ל |
UserSequenceStep
תנאי שחייב להתקיים בסדר השלבים שצוין כדי שהמשתמש יתאים לרצף.
ייצוג JSON |
---|
{ "isDirectlyFollowedBy": boolean, "stepScoping": enum ( |
שדות | |
---|---|
isDirectlyFollowedBy |
אם הערך הוא true, האירוע שתואם לשלב הזה חייב להיות האירוע הבא אחרי האירוע שתואם לשלב האחרון. אם השלב הקודם הוא False, השלב הזה מופיע בעקיפין אחרי השלב הקודם. לדוגמה, יכולים להיות אירועים בין השלב הקודם לשלב הזה. הערך |
stepScoping |
כדי שהמשתמש יתאים לרצף, השלב הזה ברצף חייב להתבצע במסגרת ההיקף. לדוגמה, אם זה שינוי אופציונלי. אם לא צוין, |
segmentFilterExpression |
משתמש תואם לשלב הרצף הזה אם האירועים שלו תואמים לביטוי הזה. ביטויים מבטאים קריטריונים של מאפיין, מדדים ו/או פרמטרים. |
UserSegmentExclusion
מציין אילו משתמשים מוחרגים מהפלח הזה.
ייצוג JSON |
---|
{ "userExclusionDuration": enum ( |
שדות | |
---|---|
userExclusionDuration |
מציין כמה זמן ההחרגה תישאר בתוקף אם המשתמש יהיה תואם ל- זה שינוי אופציונלי. אם לא צוין, נעשה שימוש ב- |
userExclusionCriteria |
אם משתמש עומד בתנאי הזה, המשתמש לא ייכלל בפלח של |
UserExclusionDuration
פירוט האפשרויות למשך הזמן שבו ההחרגה תישאר אם המשתמש יתאים ל-userExclusionCriteria
.
טיפוסים בני מנייה (enums) | |
---|---|
USER_EXCLUSION_DURATION_UNSPECIFIED |
משך הזמן להחרגה לא צוין. אין לציין. |
USER_EXCLUSION_TEMPORARY |
מחריגים משתמשים מהפלח באופן זמני בתקופות שבהן המשתמשים עומדים בתנאי userExclusionCriteria . |
USER_EXCLUSION_PERMANENT |
מחריגים משתמשים מהפלח באופן קבוע אם הם עומדים בתנאי userExclusionCriteria . |
SessionSegment
פלחי סשנים הם קבוצות משנה של סשנים שהתרחשו באתר או באפליקציה שלכם: לדוגמה, כל הסשנים שמקורם בקמפיין פרסום מסוים.
ייצוג JSON |
---|
{ "sessionInclusionCriteria": { object ( |
שדות | |
---|---|
sessionInclusionCriteria |
מגדיר אילו סשנים נכללים בפלח הזה. זה שינוי אופציונלי. |
exclusion |
המדיניות מגדירה אילו ביקורים לא נכללים בפלח הזה. זה שינוי אופציונלי. |
SessionSegmentCriteria
סשן תואם לקריטריונים אם האירועים בסשן עונים על התנאים בקריטריונים.
ייצוג JSON |
---|
{
"andConditionGroups": [
{
object ( |
שדות | |
---|---|
andConditionGroups[] |
סשן תואם לקריטריונים האלה אם סשן תואם לכל אחד מ |
SessionSegmentConditionGroup
תנאים מורים ל-Analytics אילו נתונים לכלול או לא לכלול בפלח.
ייצוג JSON |
---|
{ "conditionScoping": enum ( |
שדות | |
---|---|
conditionScoping |
אם הנתונים תואמים לקבוצת התנאים, הנתונים נכללים בפלח או מוחרגים ממנו. ההיקפים האלה מגדירים את מספר האירועים שבהם מתבצעת ההערכה של זה שינוי אופציונלי. אם לא צוין אחרת, נעשה שימוש ב- |
segmentFilterExpression |
אם הנתונים תואמים לביטוי הזה, הנתונים נכללים בפלח או לא נכללים בו. ביטויים מבטאים קריטריונים של מאפיין, מדדים ו/או פרמטרים. |
SessionCriteriaScoping
ההיקפים מציינים אילו אירועים נלקחים בחשבון במסגרת ההערכה אם סשן עומד בקריטריונים.
טיפוסים בני מנייה (enums) | |
---|---|
SESSION_CRITERIA_SCOPING_UNSPECIFIED |
בחירת היקף לקריטריונים שלא צוינו. אין לציין. |
SESSION_CRITERIA_WITHIN_SAME_EVENT |
אם הקריטריונים מתקיימים באירוע אחד, הסשן תואם לקריטריונים. |
SESSION_CRITERIA_WITHIN_SAME_SESSION |
אם הקריטריונים מתקיימים במהלך סשן אחד, הסשן תואם לקריטריונים. |
SessionSegmentExclusion
מציין אילו ביקורים מוחרגים בפלח הזה.
ייצוג JSON |
---|
{ "sessionExclusionDuration": enum ( |
שדות | |
---|---|
sessionExclusionDuration |
מציין כמה זמן ההחרגה תישאר בתוקף אם סשן תואם ל- זה שינוי אופציונלי. אם לא צוין אחרת, נעשה שימוש ב- |
sessionExclusionCriteria |
אם סשן עומד בתנאי הזה, הסשן לא ייכלל בפלח של |
SessionExclusionDuration
מציין את האפשרויות למשך הזמן שבו ההחרגה תהיה בתוקף אם סשן תואם ל-sessionExclusionCriteria
.
טיפוסים בני מנייה (enums) | |
---|---|
SESSION_EXCLUSION_DURATION_UNSPECIFIED |
משך הזמן להחרגה לא צוין. אין לציין. |
SESSION_EXCLUSION_TEMPORARY |
באופן זמני אין לכלול ביקורים מהפלח בתקופות שבהן הסשן עומד בתנאי sessionExclusionCriteria . |
SESSION_EXCLUSION_PERMANENT |
באופן קבוע אין לכלול ביקורים מהפלח אם הסשן עומד אי פעם בתנאי sessionExclusionCriteria . |
EventSegment
פלחי אירועים הם קבוצות משנה של אירועים שהופעלו באתר או באפליקציה שלכם. לדוגמה, כל אירועי הרכישה שהתרחשו במיקום מסוים או אירועי app_exception שהתרחשו במערכת הפעלה ספציפית.
ייצוג JSON |
---|
{ "eventInclusionCriteria": { object ( |
שדות | |
---|---|
eventInclusionCriteria |
ההגדרה קובעת אילו אירועים נכללים בפלח הזה. זה שינוי אופציונלי. |
exclusion |
ההגדרה קובעת אילו אירועים יוחרגו מהפלח הזה. זה שינוי אופציונלי. |
EventSegmentCriteria
אירוע תואם לקריטריונים אם הוא עומד בתנאים המפורטים בקריטריונים.
ייצוג JSON |
---|
{
"andConditionGroups": [
{
object ( |
שדות | |
---|---|
andConditionGroups[] |
אירוע תואם לקריטריונים האלה אם האירוע תואם לכל אחד מה |
EventSegmentConditionGroup
תנאים מורים ל-Analytics אילו נתונים לכלול או לא לכלול בפלח.
ייצוג JSON |
---|
{ "conditionScoping": enum ( |
שדות | |
---|---|
conditionScoping |
הערך זה שינוי אופציונלי. אם לא צוין אחרת, נעשה שימוש ב- |
segmentFilterExpression |
אם הנתונים תואמים לביטוי הזה, הנתונים נכללים בפלח או לא נכללים בו. ביטויים מבטאים קריטריונים של מאפיין, מדדים ו/או פרמטרים. |
EventCriteriaScoping
ההיקפים מציינים אילו אירועים נלקחים בחשבון כשמתבצעת הערכה אם אירוע מסוים עומד בקריטריונים.
טיפוסים בני מנייה (enums) | |
---|---|
EVENT_CRITERIA_SCOPING_UNSPECIFIED |
בחירת היקף לקריטריונים שלא צוינו. אין לציין. |
EVENT_CRITERIA_WITHIN_SAME_EVENT |
אם הקריטריונים מתקיימים באירוע אחד, האירוע תואם לקריטריונים. |
EventSegmentExclusion
מציין אילו אירועים מוחרגים מהפלח הזה.
ייצוג JSON |
---|
{ "eventExclusionDuration": enum ( |
שדות | |
---|---|
eventExclusionDuration |
הערך זה שינוי אופציונלי. אם לא צוין ערך, נעשה שימוש ב- |
eventExclusionCriteria |
אם אירוע עומד בתנאי הזה, האירוע לא ייכלל בפלח של |
EventExclusionDuration
מציין את האפשרויות למשך הזמן שבו ההחרגה תישאר אם אירוע מסוים תואם ל-eventExclusionCriteria
.
טיפוסים בני מנייה (enums) | |
---|---|
EVENT_EXCLUSION_DURATION_UNSPECIFIED |
משך הזמן להחרגה לא צוין. אין לציין. |
EVENT_EXCLUSION_PERMANENT |
מחריגים אירועים מהפלח באופן סופי אם האירוע עומד אי פעם בתנאי eventExclusionCriteria . |
FunnelSubReport
דוחות המשנה של המשפך מכילים את ערכי הנתונים של המאפיינים והמדדים. לדוגמה, 12 משתמשים הגיעו לשלב השני במשפך.
ייצוג JSON |
---|
{ "dimensionHeaders": [ { object ( |
שדות | |
---|---|
dimensionHeaders[] |
מתאר את עמודות המימדים. דוחות המשפך כוללים תמיד את מאפיין השלב במשפך בתגובות של דוח המשנה. אם תתבקשו, ייתכן שהתשובה תכלול מאפיינים נוספים, כמו פירוטים, תאריכים והפעולות הבאות. |
metricHeaders[] |
מתאר עמודות מטריות. דוחות המשפך כוללים תמיד משתמשים פעילים בתגובות לדוח המשנה. טבלת המשפך כוללת מדדים נוספים כמו שיעור ההשלמה, נטישות ושיעור הנטישה. |
rows[] |
שורות של שילובי ערכי מאפיינים וערכי מדדים בדוח. |
metadata |
מטא-נתונים של דוח המשפך. |
FunnelResponseMetadata
המטא-נתונים של התשובות בדוח המשפך כוללים מידע נוסף לגבי דוח המשפך.
ייצוג JSON |
---|
{
"samplingMetadatas": [
{
object ( |
שדות | |
---|---|
samplingMetadatas[] |
אם התוצאות של דוח המשפך נדגמו, המדד הזה מתאר את אחוז האירועים שנעשה בהם שימוש בדוח המשפך הזה. השדה עם זאת, אם התוצאות לא נדגמו, השדה הזה לא יוגדר. |
SamplingMetadata
אם התוצאות של דוח המשפך נדגמו, המטא-נתונים האלה מתארים את אחוז האירועים שנעשה בהם שימוש בדוח המשפך הזה בטווח תאריכים מסוים. דגימה היא שיטה לניתוח קבוצת משנה של כל הנתונים כדי לחשוף את המידע המשמעותי בקבוצת הנתונים הגדולה.
ייצוג JSON |
---|
{ "samplesReadCount": string, "samplingSpaceSize": string } |
שדות | |
---|---|
samplesReadCount |
המספר הכולל של האירועים שנקראו בדוח שנדגם עבור טווח תאריכים. זהו הגודל של קבוצת המשנה של הנתונים בנכס הזה שנותחו בדוח המשפך הזה. |
samplingSpaceSize |
המספר הכולל של האירועים שנמצאים בנתונים של הנכס הזה שניתן היה לנתח בדוח המשפך הזה בטווח תאריכים מסוים. דגימה חושפת את המידע המשמעותי לגבי קבוצת הנתונים הגדולה, וזהו הגודל של קבוצת הנתונים הגדולה יותר. כדי לחשב את אחוז הנתונים הזמינים שבהם נעשה שימוש בדוח המשפך הזה, צריך לחשב את הערך |
PropertyQuota
המצב הנוכחי של כל המכסות בנכס Analytics הזה. אם תנוצל כל המכסה בנכס, כל הבקשות לנכס הזה יחזירו שגיאות של 'מיצוי המשאבים'.
ייצוג JSON |
---|
{ "tokensPerDay": { object ( |
שדות | |
---|---|
tokensPerDay |
נכסים רגילים של Analytics יכולים להשתמש בעד 200,000 אסימונים ביום. נכסי Analytics 360 יכולים להשתמש ב-2,000,000 אסימונים ביום. בשביל רוב הבקשות צריך פחות מ-10 אסימונים. |
tokensPerHour |
נכסים רגילים של Analytics יכולים להשתמש בעד 40,000 אסימונים בשעה. נכסים של Analytics 360 יכולים להשתמש ב-400,000 אסימונים בשעה. בקשת API צורכת מספר יחיד של אסימונים, והמספר מנוכה מכל המכסות השעתיות, היומיות והשעתיות של הפרויקט. |
concurrentRequests |
נכסי Analytics רגילים יכולים לשלוח עד 10 בקשות בו-זמנית. נכסי Analytics 360 יכולים להשתמש ב-50 בקשות בו-זמנית לכל היותר. |
serverErrorsPerProjectPerHour |
בנכסים רגילים של Analytics ובצמדים של פרויקטים בענן יכולות להיות עד 10 שגיאות שרת בשעה. בנכסים של Analytics 360 ובצמדים של פרויקטים בענן יכולות להיות עד 50 שגיאות שרת בשעה. |
potentiallyThresholdedRequestsPerHour |
נכסים של Analytics יכולים לשלוח עד 120 בקשות לשעה, עם מאפיינים שעשויים להיות מוגדרים כסף. בבקשה באצווה, כל בקשה לדוח נספרת בנפרד עבור המכסה הזו, אם הבקשה מכילה מאפיינים שעשויים לעבור סף סף. |
tokensPerProjectPerHour |
נכסים של Analytics יכולים להשתמש ב-35% לכל היותר מהאסימונים שלהם בכל פרויקט בשעה. לעומת זאת, נכסים רגילים של Analytics יכולים להשתמש ב-14,000 אסימונים לכל פרויקט בשעה, ונכסים של Analytics 360 יכולים להשתמש ב-140,000 אסימונים לכל פרויקט בשעה. בקשת API צורכת מספר יחיד של אסימונים, והמספר מנוכה מכל המכסות השעתיות, היומיות והשעתיות של הפרויקט. |
QuotaStatus
המצב הנוכחי של קבוצת מכסות מסוימת.
ייצוג JSON |
---|
{ "consumed": integer, "remaining": integer } |
שדות | |
---|---|
consumed |
המכסה נוצלה בעקבות הבקשה הזו. |
remaining |
המכסה שנותרה אחרי הבקשה הזו. |