- בקשת 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[] |
זה שינוי אופציונלי. ההגדרות האישיות של הפלחים. פלחים הם קבוצות משנה של נתונים של נכס. בדוח משפך עם פלחים, המשפך נבדק בכל פלח. כל פלח שצוין בבקשה הזו יוצר שורה נפרדת בתשובה. בתשובה, כל פלח שמזוהה לפי השם שלו. הפרמטר 'פלחים' הוא אופציונלי. הבקשות מוגבלות ל-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 |
השם הייחודי של השלב הזה. אם לא צוין, השמות של השלבים יופיעו לפי שם שנוסף לאינדקס על ידי מדד אחד (לדוגמה, '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
המדיניות הזו קובעת את המאפיינים שמופיעים בתגובה לדוח המשנה 'הצגת נתוני משפך'.
טיפוסים בני מנייה (enum) | |
---|---|
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
הגדרת ההיקף מציינת אילו אירועים נכללים בהערכה אם משתמש עומד בקריטריונים.
טיפוסים בני מנייה (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 . צריך לציין סוג מסנן אחד בשביל 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-11.2021 עד 10.11.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
.
טיפוסים בני מנייה (enum) | |
---|---|
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
ההיקף מציין אילו אירועים נכללים בהערכה אם סשן עומד בקריטריונים.
טיפוסים בני מנייה (enum) | |
---|---|
SESSION_CRITERIA_SCOPING_UNSPECIFIED |
היקף קריטריונים שלא צוינו. אין לציין. |
SESSION_CRITERIA_WITHIN_SAME_EVENT |
אם הקריטריונים מתקיימים באירוע אחד, הסשן תואם לקריטריונים. |
SESSION_CRITERIA_WITHIN_SAME_SESSION |
אם הקריטריונים מתקיימים בסשן אחד, הסשן תואם לקריטריונים. |
SessionSegmentExclusion
מציין אילו סשנים מוחרגים בפלח הזה.
ייצוג JSON |
---|
{ "sessionExclusionDuration": enum ( |
שדות | |
---|---|
sessionExclusionDuration |
מציינת כמה זמן יימשך ההחרגה אם סשן תואם ל- זה שינוי אופציונלי. אם לא צוין אחרת, המערכת תשתמש ב- |
sessionExclusionCriteria |
אם סשן עומד בתנאי הזה, הסשן מוחרג מהחברות בפלח של |
SessionExclusionDuration
מציינת את האפשרויות למשך הזמן של ההחרגה אם סשן תואם ל-sessionExclusionCriteria
.
טיפוסים בני מנייה (enum) | |
---|---|
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
הגדרת ההיקף מציינת אילו אירועים נכללים בהערכה אם אירוע עומד בקריטריונים.
טיפוסים בני מנייה (enum) | |
---|---|
EVENT_CRITERIA_SCOPING_UNSPECIFIED |
היקף קריטריונים שלא צוינו. אין לציין. |
EVENT_CRITERIA_WITHIN_SAME_EVENT |
אם הקריטריונים מתקיימים באירוע אחד, האירוע תואם לקריטריונים. |
EventSegmentExclusion
מציין אילו אירועים מוחרגים בפלח הזה.
ייצוג JSON |
---|
{ "eventExclusionDuration": enum ( |
שדות | |
---|---|
eventExclusionDuration |
זה שינוי אופציונלי. אם לא צוין אחרת, המערכת תשתמש ב- |
eventExclusionCriteria |
אם אירוע מסוים עומד בתנאי הזה, האירוע מוחרג מהחברות בפלח |
EventExclusionDuration
מציינת את האפשרויות למשך כמה זמן ההחרגה תימשך אם אירוע מסוים תואם ל-eventExclusionCriteria
.
טיפוסים בני מנייה (enum) | |
---|---|
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. אם מיציתם את המכסה של נכס מסוים, כל הבקשות לנכס הזה יחזירו שגיאות מסוג Resource Ex ארצות הברית.
ייצוג 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 |
המכסה שנותרה אחרי הבקשה הזו. |