बेहतर इस्तेमाल के उदाहरण

इस दस्तावेज़ में, Google Analytics रिपोर्टिंग API v4 की बेहतर सुविधाओं के बारे में बताया गया है. एपीआई की पूरी जानकारी के लिए, रेफ़रंस गाइड देखें.

इसके बारे में जानकारी

एक सामान्य रिपोर्ट बनाने के बाद, बेहतर रिपोर्ट बनाने के लिए इन सुविधाओं का इस्तेमाल करें:

पिवट

Google Analytics रिपोर्टिंग एपीआई v4 की मदद से, पिवट टेबल जनरेट की जा सकती हैं. पिवट टेबल से अनुरोध करने के लिए, reportRequest में पिवट फ़ील्ड तय करें. पिवट ऑब्जेक्ट में डाइमेंशन और मेट्रिक का अपना सेट होता है. साथ ही, पिवट टेबल में शामिल किए जाने वाले डाइमेंशन की संख्या बताने के लिए startGroup और maxGroupCount ज़रूरी नहीं होते.

अनुरोध करें

नीचे दिए गए एपीआई कॉल, देश के हिसाब से सेशन का अनुरोध करते हैं और नतीजों को ब्राउज़र में पिवट करते हैं:

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"
            }
          ]
        }
      ]
    }
  ]
}

रिस्पॉन्स कॉलम का हेडर

पिवट अनुरोध के लिए, रिटर्न की गई रिपोर्ट ऑब्जेक्ट में, 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 तीन होता है. "totalPivotGroupsCount": 7 की वजह से ज़्यादा से ज़्यादा सात वैल्यू हो सकती हैं.

पिवट टेबल की लाइन का उदाहरण

ऊपर दिए गए सैंपल के जवाब में, देश अमेरिका से जुड़ी पंक्ति को इस पिवट टेबल में दिखाया गया है:

देश कुल
सेशन
Internet Explorer
सेशन
FireFox
सेशन
Android ब्राउज़र
सेशन
भारत 12 3 2 4
अमेरिका 192 21 18 1
यूनाइटेड किंगडम 35 12 2 0

एक जैसे उपयोगकर्ताओं का ग्रुप

कोहॉर्ट, ऐसे उपयोगकर्ताओं के ग्रुप को कहते हैं जिनमें एक जैसी विशेषताएं होती है. उदाहरण के लिए, किसी खास तारीख को आप जितने भी नए उपयोगकर्ता हासिल करते हैं उन सभी को कोहॉर्ट (एक जैसे उपयोगकर्ताओं के ग्रुप) में रखा जाता है. सहगण विश्लेषण रिपोर्ट की सहायता से आप सहगणों के व्यवहार को पृथक करके उनका विश्लेषण कर सकते हैं. एक जैसे उपयोगकर्ताओं के ग्रुप और डाइमेंशन की सूची के लिए, एक जैसे उपयोगकर्ताओं के ग्रुप और लाइफ़टाइम वैल्यू (डाइमेंशन) और डाइमेंशन देखें.

एक जैसे उपयोगकर्ताओं के ग्रुप के बारे में बताने के लिए, आपको 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"
            }
          }
        ]
      }
    }
  ]
}

एपीआई एक्सप्लोरर में ऊपर दिया गया उदाहरण देखें.

एक जैसे उपयोगकर्ताओं के ग्रुप के लिए पाबंदियां

कोहॉर्ट के मान्य अनुरोध को नीचे दी गई पाबंदियों के मुताबिक होना चाहिए:

  • 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
      }
    }
  ]
}

एपीआई एक्सप्लोरर में ऊपर दिया गया उदाहरण देखें.

एक जैसे उपयोगकर्ताओं के ग्रुप और लाइफ़टाइम वैल्यू के डाइमेंशन और मेट्रिक

डाइमेंशन

डाइमेंशन का नाम परिभाषा
ga:cohort उस कोहॉर्ट का नाम जिससे उपयोगकर्ता जुड़ा है. एक जैसे उपयोगकर्ताओं के ग्रुप बनाने के तरीके के आधार पर, एक जैसे उपयोगकर्ताओं के ग्रुप में कई उपयोगकर्ता शामिल हो सकते हैं.
ga:cohortNthDay कोहॉर्ट की परिभाषा की तारीख के हिसाब से, 0 पर आधारित दिन का ऑफ़सेट. उदाहरण के लिए, अगर किसी कोहॉर्ट की पहली विज़िट की तारीख 2015-09-01 है, तो 2015-09-04 की तारीख ga:cohortNthDay होगी.
ga:cohortNthMonth कोहॉर्ट की तारीख के हिसाब से, 0 पर आधारित महीने का ऑफ़सेट.
ga:cohortNthWeek कोहॉर्ट की परिभाषा की तारीख के मुकाबले हफ़्ते का ऑफ़सेट.
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 एक जैसे उपयोगकर्ताओं के ग्रुप के लिए सेशन की संख्या.

लाइफ़टाइम वैल्यू (एलटीवी) की मेट्रिक

मीट्रिक नाम परिभाषा
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 एक जैसे उपयोगकर्ताओं के ग्रुप के लिए, उपयोगकर्ता हासिल करने के डाइमेंशन के हिसाब से सेशन की अवधि (सिर्फ़ ऐप्लिकेशन व्यू).