इस दस्तावेज़ में, Google Analytics Reporting API v4 की बेहतर सुविधाओं की जानकारी दी गई है. एपीआई के बारे में ज़्यादा जानकारी पाने के लिए, रेफ़रंस गाइड देखें.
शुरुआती जानकारी
आसान रिपोर्ट बनाने के बाद, बेहतर रिपोर्ट बनाने के लिए इन सुविधाओं का इस्तेमाल करें:
पिवट
Google Analytics Reporting API 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"
}
]
}
]
}
]
}
जवाब वाले कॉलम का हेडर
पिवट अनुरोध के लिए, लौटाए गए 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 की वैल्यू तीन होती है. "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 |
कोहॉर्ट की परिभाषा की तारीख के मुकाबले 0-आधारित हफ़्ते का ऑफ़सेट. |
ga:acquisitionTrafficChannel |
ट्रैफ़िक चैनल, जिसके ज़रिए उपयोगकर्ता हासिल किया गया था. इसे उपयोगकर्ता के पहले सेशन से निकाला जाता है. ट्रैफ़िक चैनल की गिनती, उपयोगकर्ता हासिल करने के समय, चैनल ग्रुपिंग के डिफ़ॉल्ट नियमों के आधार पर की जाती है. यह नियम, व्यू के लेवल पर उपलब्ध होने पर ही लागू होता है. |
ga:acquisitionSource |
वह सोर्स जिससे उपयोगकर्ता को हासिल किया गया था. उपयोगकर्ता के पहले सेशन से लिया गया. |
ga:acquisitionMedium |
वह माध्यम जिसके ज़रिए उपयोगकर्ता हासिल किया गया था. उपयोगकर्ता के पहले सेशन से लिया गया. |
ga:acquisitionSourceMedium |
ga:userAcquisitionSource और ga:acquisitionMedium की कुल वैल्यू. |
ga:acquisitionCampaign |
वह कैंपेन जिससे उपयोगकर्ता को हासिल किया गया था. उपयोगकर्ता के पहले सेशन से लिया गया. |
मेट्रिक
| मेट्रिक नाम | परिभाषा |
|---|---|
ga:cohortActiveUsers |
यह मेट्रिक, 0-आधारित ऑफ़सेट डाइमेंशन (ga:cohortNthDay, ga:cohortNthWeek या ga:cohortNthMonth) के हिसाब से काम की है. इससे, कोहॉर्ट में उन उपयोगकर्ताओं की संख्या पता चलता है जो कोहॉर्ट के nवें दिन/हफ़्ता/महीने के हिसाब से टाइम विंडो में सक्रिय हैं. उदाहरण के लिए, 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 |
किसी कोहॉर्ट के लिए उपयोगकर्ता हासिल करने वाले डाइमेंशन के लिए, हर उपयोगकर्ता के हिसाब से सेशन की अवधि (सिर्फ़ ऐप्लिकेशन व्यू). |