תרחישים לדוגמה לשימוש מתקדם

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

מבוא

אחרי שיוצרים דוח פשוט, כדאי להשתמש בתכונות הבאות כדי ליצור דוחות מתקדמים:

צירים

ב-Google Analytics Reporting API v4 אפשר ליצור טבלאות צירים. כדי ליצור בקשה באמצעות טבלת צירים, מגדירים את השדה Pivot ב-ReportRequest. לאובייקט Pivot יש קבוצה משלו של מאפיינים ומדדים. אפשר גם startGroup ו-maxGroupCount לציין את מספר המאפיינים שייכללו בטבלת הצירים.

בקשה

ההפעלות הבאות של בקשות לקריאה ל-API מוצגות לפי מדינה, ומחזירות את התוצאות בדפדפן:

POST https://analyticsreporting.googleapis.com/v4/reports:batchGet
{
  "reportRequests":
  [
    {
      "viewId": "XXXX",
      "dateRanges":
      [
        {
          "startDate": "2014-11-01",
          "endDate": "2014-11-30"
        }
      ],
      "metrics":
      [
        {
          "expression": "ga:sessions"
        }
      ],
      "dimensions":
      [
        {
          "name": "ga:country"
        }
      ],
      "pivots":
      [
        {
          "dimensions":
          [
            {
              "name": "ga:browser"
            }
          ],
          "maxGroupCount": 3,
          "startGroup": 3,
          "metrics":
          [
            {
              "expression": "ga:sessions"
            }
          ]
        }
      ]
    }
  ]
}

כותרת העמודה של התשובה

באובייקט report שמוחזר לבקשת ציר, ב-metricHeader יש רשימה של אובייקטים pivotHeaders בשדות pivotHeaderEntries שלהם מגדירים את הסדר של ערכי המאפיינים ואת ערכי המדדים התואמים, לדוגמה:

"columnHeader": {
    "dimensions": [
        "ga:country"
    ],
    "metricHeader": {
        "metricHeaderEntries": [
            {
                "name": "ga:sessions",
                "type": "INTEGER"
            }
        ],
        "pivotHeaders": [
            {
                "pivotHeaderEntries": [
                    {
                        "dimensionNames": [
                            "ga:browser"
                        ],
                        "dimensionValues": [
                            "Internet Explorer"
                        ],
                        "metric": {
                            "name": "ga:sessions",
                            "type": "INTEGER"
                        }
                    },
                    {
                        "dimensionNames": [
                            "ga:browser"
                        ],
                        "dimensionValues": [
                            "Firefox"
                        ],
                        "metric": {
                            "name": "ga:sessions",
                            "type": "INTEGER"
                        }
                    },
                    {
                        "dimensionNames": [
                            "ga:browser"
                        ],
                        "dimensionValues": [
                            "Android Browser"
                        ],
                        "metric": {
                            "name": "ga:sessions",
                            "type": "INTEGER"
                        }
                    }
                ],
                "totalPivotGroupsCount": 7
            }
        ]
    }
},

שורות תגובה

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

"rows": [
    ...
    {
        "dimensions": [
            "United States"
        ],
        "metrics": [
            {
                "pivotValues": [
                    {
                        "values": [
                            "21",
                            "18",
                            "1"
                        ]
                    }
                ],
                "values": [
                    "192"
                ]
            }
        ]
    }
],

שימו לב שבדוח יש רק שלושה ערכי צירים, כי בבקשה המקורית הערך maxGroupCount הוא 3. יכולים להיות עד שבעה ערכים בגלל "totalPivotGroupsCount": 7.

דוגמה לשורה בטבלת צירים

בתגובה לדוגמה שלמעלה, השורה המשויכת למדינה ארצות הברית מיוצגת בטבלת הצירים הבאה:

מדינה סה"כ
פעילויות באתר
הפעלות של Internet Explorer
פעילויות ב-FireFox		 סשנים של
בדפדפן Android
הודו 12 3 2 4
ארה"ב 192 22 18 1
בריטניה 35 12 2 0

קבוצות בעלות מאפיינים משותפים (cohorts)

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

כדי להגדיר בקשה לקבוצה בעלת מאפיינים משותפים, עליך להגדיר אובייקט של קבוצה בעלת מאפיינים משותפים עם name, type ו-dateRange:

POST https://analyticsreporting.googleapis.com/v4/reports:batchGet
{
  "reportRequests":
  [
    {
      "viewId": "XXXX",
      "dimensions":
      [
        {
          "name": "ga:cohort"
        },
        {
          "name": "ga:cohortNthDay"
        }
      ],
      "metrics":
      [
        {
          "expression": "ga:cohortActiveUsers"
        },
        {
          "expression": "ga:cohortTotalUsers"
        }
      ],
      "cohortGroup":
      {
        "cohorts":
        [
          {
            "name": "cohort 1",
            "type": "FIRST_VISIT_DATE",
            "dateRange":
            {
              "startDate": "2015-08-01",
              "endDate": "2015-08-01"
            }
          },
          {
            "name": "cohort 2",
            "type": "FIRST_VISIT_DATE",
            "dateRange":
            {
              "startDate": "2015-07-01",
              "endDate": "2015-07-01"
            }
          }
        ]
      }
    }
  ]
}

אפשר לראות את הדוגמה שלמעלה ב-API Explorer.

הגבלות על קבוצה בעלת מאפיינים משותפים

בקשה תקפה לקבוצה בעלת מאפיינים משותפים חייבת לעמוד בהגבלות הבאות:

  • המאפיין ga:cohort נכלל אם ורק אם הבקשה מכילה הגדרה אחת או יותר של קבוצה בעלת מאפיינים משותפים.
  • השם של הקבוצה בעלת המאפיינים המשותפים חייב להיות ייחודי.
  • הבקשה יכולה לכלול עד 12 קבוצות בעלות מאפיינים משותפים.
  • אם מגדירים את הערך ga:cohortNthWeek, תאריך ההתחלה צריך להיות יום ראשון ותאריך הסיום חייב להיות יום שבת. אם מגדירים את הערך ga:cohortNthMonth, תאריך ההתחלה צריך להיות היום הראשון בחודש ותאריך הסיום חייב להיות היום האחרון בחודש. אם מגדירים את הערך ga:cohortNthDay, טווח התאריכים חייב להיות יום אחד בדיוק.
  • אסור לשלוח בקשות לקבוצה בעלת מאפיינים משותפים עם התאריך של היום.
  • בקשות לקבוצה בעלת מאפיינים משותפים ובקשות שלא בעלות מאפיינים משותפים לא יכולות להיכלל באותה בקשת batchGet.
  • טווח התאריכים בקבוצות בעלות עניין משותף חייב להיות אחרי 1 בפברואר 2015.

ערך חיי המשתמש (LTV)

הדוח 'ערך חיי המשתמש' מראה את הגידול בערך המשתמש (הכנסה) ובמעורבות (צפיות באפליקציה, יעדים שהושלמו, פעילויות באתר ומשך פעילות באתר) במהלך 90 הימים שאחרי צירוף משתמש. בקישור הבא אפשר לעיין במאפיינים ובמדדים ספציפיים של ערך חיי המשתמש.

בקשת ערך חיי המשתמש מוגדרת כקבוצה בעלת מאפיינים משותפים והשדה lifetimeValue מוגדר ל-true. לדוגמה:

POST https://analyticsreporting.googleapis.com/v4/reports:batchGet
{
  "reportRequests":
  [
    {
      "viewId": "XXXX",
      "dimensions":
      [
        {
          "name": "ga:cohort"
        },
        {
          "name": "ga:cohortNthWeek"
        }
      ],
      "metrics":
      [
        {
          "expression": "ga:cohortTotalUsersWithLifetimeCriteria"
        },
        {
          "expression": "ga:cohortRevenuePerUser"
        }
      ],
      "cohortGroup":
      {
        "cohorts":
        [
          {
            "name": "cohort 1",
            "type": "FIRST_VISIT_DATE",
            "dateRange":
            {
              "startDate": "2015-08-01",
              "endDate": "2015-09-01"
            }
          },
          {
            "name": "cohort 2",
            "type": "FIRST_VISIT_DATE",
            "dateRange":
            {
              "startDate": "2015-07-01",
              "endDate": "2015-08-01"
            }
          }
        ],
        "lifetimeValue": true
      }
    }
  ]
}

אפשר לראות את הדוגמה שלמעלה ב-API Explorer.

מאפיינים ומדדים של קבוצה בעלת מאפיינים משותפים וערך חיי המשתמש (LTV)

מאפיינים

שם המאפיין הגדרה
ga:cohort השם של הקבוצה בעלת המאפיינים המשותפים שאליה משתייך משתמש. בהתאם להגדרה של קבוצות בעלות מאפיינים משותפים, משתמש יכול להשתייך לכמה קבוצות בעלות מאפיינים משותפים, בדומה לאופן שבו משתמש יכול להשתייך למספר פלחים.
ga:cohortNthDay קיזוז ימים מבוסס 0 ביחס לתאריך ההגדרה של הקבוצה בעלת המאפיינים המשותפים. לדוגמה, אם קבוצה בעלת מאפיינים משותפים (cohort) מוגדרת עם תאריך הביקור הראשון כ-2015-09-01, הערך של ga:cohortNthDay יהיה 3 עבור תאריך 2015-09-04.
ga:cohortNthMonth קיזוז חודשים מבוסס-0 ביחס לתאריך ההגדרה של הקבוצה בעלת המאפיינים המשותפים.
ga:cohortNthWeek קיזוז שבועות מבוסס 0 ביחס לתאריך ההגדרה של הקבוצה בעלת המאפיינים המשותפים.
ga:acquisitionTrafficChannel ערוץ התנועה שדרכו המשתמש צורף. הוא מחולץ מהסשן הראשון של המשתמש. ערוץ התנועה מחושב על סמך כללי ברירת המחדל לקיבוץ ערוצים (ברמת התצוגה המפורטת, אם הם זמינים) במועד צירוף המשתמשים.
ga:acquisitionSource המקור שדרכו המשתמש צורף. נגזר מהסשן הראשון של המשתמש.
ga:acquisitionMedium אמצעי ההגעה לאתר שדרכו המשתמש צורף. נגזר מהסשן הראשון של המשתמש.
ga:acquisitionSourceMedium הערך המשולב של ga:userAcquisitionSource ו-ga:acquisitionMedium.
ga:acquisitionCampaign הקמפיין שדרכו המשתמש צורף. נגזר מהסשן הראשון של המשתמש.

מדדים

שם המדד הגדרה
ga:cohortActiveUsers המדד הזה רלוונטי בהקשר של מאפייני ההיסט שמבוססים על 0 (ga:cohortNthDay, ga:cohortNthWeek או ga:cohortNthMonth). הוא מציין את מספר המשתמשים בקבוצה בעלת המאפיינים המשותפים שפעילים בחלון הזמן התואם ליום/שבוע/חודש של הקבוצה בעלת המאפיינים המשותפים. לדוגמה, עבור ga:cohortNthWeek = 1, מספר המשתמשים (בקבוצה בעלת מאפיינים משותפים) שהיו פעילים בשבוע השני. אם הבקשה לא כוללת את הערכים ga:cohortNthDay, ga:cohortNthWeek או ga:cohortNthMonth, למדד הזה יהיה אותו ערך כמו ga:cohortTotalUsers.
ga:cohortTotalUsers מספר המשתמשים ששייכים לקבוצה בעלת מאפיינים משותפים, שנקראים גם 'גודל קבוצה בעלת מאפיינים משותפים'.
ga:cohortAppviewsPerUser צפיות באפליקציה לכל משתמש בקבוצה בעלת מאפיינים משותפים.
ga:cohortGoalCompletionsPerUser מטרות עסקיות שהושלמו לכל משתמש בקבוצה בעלת מאפיינים משותפים.
ga:cohortPageviewsPerUser צפיות בדף לכל משתמש בקבוצה בעלת מאפיינים משותפים.
ga:cohortRetentionRate שיעור השימור של קבוצה בעלת מאפיינים משותפים.
ga:cohortRevenuePerUser הכנסה למשתמש בקבוצה בעלת מאפיינים משותפים.
ga:cohortVisitDurationPerUser משך הסשן לכל משתמש בקבוצה בעלת מאפיינים משותפים.
ga:cohortSessionsPerUser ביקורים לכל משתמש בקבוצה בעלת מאפיינים משותפים.

מדדים של ערך חיי המשתמש (LTV)

שם המדד הגדרה
ga:cohortTotalUsersWithLifetimeCriteria הדבר רלוונטי בהקשר של בקשה עם המאפיינים ga:acquisitionTrafficChannel, ga:acquisitionSource, ga:acquisitionMedium או ga:acquisitionCampaign. המדד הזה מייצג את מספר המשתמשים בקבוצות בעלות מאפיינים משותפים שצורפו דרך הערוץ, המקור, אמצעי ההגעה לאתר או הקמפיין הנוכחיים. לדוגמה, עבור ga:acquisitionTrafficChannel=Direct, הוא מייצג את מספר המשתמשים בקבוצה בעלת המאפיינים המשותפים שצורפו ישירות. אם אף אחד מהמאפיינים שצוינו לא קיים, הערך שלו שווה ל-ga:cohortTotalUsers (רק צפיות באפליקציה).
ga:cohortAppviewsPerUserWithLifetimeCriteria צפיות באפליקציה לכל משתמש במאפיין צירוף המשתמשים של קבוצה בעלת מאפיינים משותפים (צפיות באפליקציה בלבד).
ga:cohortGoalCompletionsPerUserWithLifetimeCriteria מטרות עסקיות שהושלמו לכל משתמש במאפיין 'צירוף משתמשים' של קבוצה בעלת מאפיינים משותפים (צפיות באפליקציה בלבד).
ga:cohortPageviewsPerUserWithLifetimeCriteria צפיות בדף לכל משתמש במאפיין 'צירוף משתמשים' של קבוצה בעלת מאפיינים משותפים (צפיות באפליקציה בלבד).
ga:cohortRevenuePerUserWithLifetimeCriteria הכנסה לכל משתמש במאפיין 'צירוף משתמשים' של קבוצה בעלת מאפיינים משותפים (צפיות באפליקציה בלבד).
ga:cohortSessionsPerUserWithLifetimeCriteria משך הסשן לכל משתמש ביחס למאפיין 'צירוף משתמשים' של קבוצה בעלת מאפיינים משותפים (צפיות באפליקציה בלבד).