Google Analytics Data API के बारे में खास जानकारी

Google Analytics रिपोर्टिंग डेटा को प्रोग्राम के हिसाब से ऐक्सेस करने के लिए, Data API का इस्तेमाल किया जा सकता है.

Google Analytics प्रॉपर्टी के बारे में ज़्यादा जानें.

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

यहां कुछ उदाहरण दिए गए हैं जिनकी रिपोर्ट Google Analytics Data API v1 का इस्तेमाल करके बनाई जा सकती है:

• पिछले हफ़्ते आपके Android ऐप्लिकेशन के हर दिन के सक्रिय उपयोगकर्ताओं की संख्या.
• पिछले 28 दिनों में, आपकी साइट के टॉप 10 पेजों को कितने पेज व्यू मिले.
• पिछले 30 मिनट में, हर देश के हिसाब से आपके iOS ऐप्लिकेशन पर कितने सक्रिय उपयोगकर्ता थे.

Google Analytics Data API v1 का इस्तेमाल करके, ये काम भी किए जा सकते हैं:

• Google Analytics का डेटा दिखाने के लिए, कस्टम डैशबोर्ड बनाएं.
• रिपोर्टिंग से जुड़े मुश्किल टास्क को ऑटोमेट करें, ताकि समय बचाया जा सके.
• अपने Google Analytics डेटा को कारोबार के लिए इस्तेमाल होने वाले अन्य ऐप्लिकेशन के साथ इंटिग्रेट करें.

डेटा की एक जैसी क्वालिटी और रिपोर्टिंग आइडेंटिटी

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

अलग-अलग आइडेंटिटी स्पेस आपकी रिपोर्ट पर कैसे असर डाल सकते हैं, इस बारे में ज़्यादा जानने के लिए रिपोर्टिंग आइडेंटिटी लेख पढ़ें.

अपनी प्रोफ़ाइल बनाना शुरू करें

Java, Python, Node.js, PHP, C#, Go या Ruby में क्लाइंट लाइब्रेरी का इस्तेमाल शुरू करने के लिए, क्लाइंट लाइब्रेरी की क्विकस्टार्ट गाइड देखें. क्वेरी बनाने, डाइमेंशन फ़िल्टर करने, और जवाब पढ़ने का तरीका जानने के लिए, रिपोर्ट बनाएं लेख पढ़ें या क्वेरी एक्सप्लोरर में क्वेरी को इंटरैक्टिव तरीके से टेस्ट करें.

runReport के अनुरोध और जवाब का सैंपल

REST पर इवेंट डेटा के बारे में क्वेरी करने के लिए, runReport एंडपॉइंट पर POST अनुरोध भेजें. साथ ही, RunReportRequest JSON बॉडी भेजें, जिसमें आपके dateRanges, dimensions, और metrics की जानकारी हो:

POST https://analyticsdata.googleapis.com/v1beta/properties/GA_PROPERTY_ID:runReport
{
  "dateRanges": [
    { "startDate": "7daysAgo", "endDate": "yesterday" }
  ],
  "dimensions": [
    { "name": "country" }
  ],
  "metrics": [
    { "name": "activeUsers" }
  ]
}

इसके अलावा, ऐप्लिकेशन के डिफ़ॉल्ट क्रेडेंशियल का इस्तेमाल करके, इसके जैसा curl कमांड चलाएं:

curl -X POST \
  "https://analyticsdata.googleapis.com/v1beta/properties/GA_PROPERTY_ID:runReport" \
  -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
  -H "x-goog-user-project: PROJECT_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "dateRanges": [
      { "startDate": "7daysAgo", "endDate": "yesterday" }
    ],
    "dimensions": [
      { "name": "country" }
    ],
    "metrics": [
      { "name": "activeUsers" }
    ]
  }'

एपीआई, RunReportResponse दिखाता है. इसमें कॉलम हेडर और डेटा की लाइनें शामिल होती हैं:

{
  "dimensionHeaders": [
    { "name": "country" }
  ],
  "metricHeaders": [
    { "name": "activeUsers", "type": "TYPE_INTEGER" }
  ],
  "rows": [
    {
      "dimensionValues": [{ "value": "United States" }],
      "metricValues": [{ "value": "4820" }]
    },
    {
      "dimensionValues": [{ "value": "Japan" }],
      "metricValues": [{ "value": "2541" }]
    }
  ],
  "rowCount": 2,
  "kind": "analyticsData#runReport"
}

उपलब्ध तरीके

यहां Data API के तरीकों की सूची दी गई है. ज़्यादा जानकारी के लिए, रेफ़रंस दस्तावेज़ देखें.

• runReport इस तरीके से, आपके Google Analytics इवेंट डेटा की कस्टम रिपोर्ट मिलती है. साथ ही, सामान्य रिपोर्ट क्वेरी के लिए यह सबसे सही तरीका है.
• batchRunReports यह runReport तरीके का बैच वर्शन है. इसकी मदद से, एक ही एपीआई कॉल का इस्तेमाल करके कई रिपोर्ट जनरेट की जा सकती हैं.
• runPivotReport इस तरीके की मदद से, आपके Google Analytics इवेंट डेटा की पिवट रिपोर्ट को पसंद के मुताबिक बनाया जाता है. पिवट रिपोर्ट, सामान्य रिपोर्ट की तुलना में ज़्यादा बेहतर और जानकारी देने वाले फ़ॉर्मैट में होती हैं. हर पिवट, रिपोर्ट के रिस्पॉन्स में दिखने वाले डाइमेंशन कॉलम और लाइनों के बारे में बताता है.
• batchRunPivotReports यह runPivotReport तरीके का बैच वर्शन है. इसकी मदद से, एक ही एपीआई कॉल का इस्तेमाल करके कई रिपोर्ट जनरेट की जा सकती हैं.
• getMetadata यह तरीका, रिपोर्टिंग के तरीकों में उपलब्ध डाइमेंशन और मेट्रिक के लिए मेटाडेटा दिखाता है. इसका इस्तेमाल, डाइमेंशन और मेट्रिक को एक्सप्लोर करने के लिए किया जाता है. इस तरीके के रिस्पॉन्स में, तय की गई Google Analytics प्रॉपर्टी के लिए उपलब्ध कस्टम डाइमेंशन और मेट्रिक भी शामिल होती हैं.
• checkCompatibility इस तरीके से, उन डाइमेंशन और मेट्रिक की सूची बनाई जाती है जिन्हें रिपोर्ट के अनुरोध में जोड़ा जा सकता है और जो साथ काम करती हैं.
• runRealtimeReport इस तरीके से, आपकी प्रॉपर्टी के लिए रीयलटाइम इवेंट डेटा की पसंद के मुताबिक बनाई गई रिपोर्ट मिलती है. Google Analytics को भेजे जाने के कुछ सेकंड बाद, इवेंट रीयलटाइम रिपोर्ट में दिखने लगते हैं. रीयलटाइम रिपोर्ट में, मौजूदा समय से लेकर 30 मिनट पहले तक की अवधि के इवेंट और इस्तेमाल से जुड़ा डेटा दिखता है. Google Analytics 360 प्रॉपर्टी के लिए, यह अवधि 60 मिनट तक की होती है.
• properties.audienceExports तरीकों का एक ग्रुप, जिसकी मदद से ऑडियंस एक्सपोर्ट जनरेट किए जा सकते हैं. इनमें ऑडियंस में शामिल उपयोगकर्ताओं का स्नैपशॉट शामिल होता है.
• properties.recurringAudienceLists (सार्वजनिक तौर पर उपलब्ध होने से पहले वाला वर्शन) ऐसे तरीकों का ग्रुप जिनकी मदद से, बार-बार होने वाले ऑडियंस एक्सपोर्ट को मैनेज किया जा सकता है. बार-बार होने वाले ऑडियंस एक्सपोर्ट से, हर दिन ऑडियंस की नई सूचियां जनरेट होती हैं.
• runFunnelReport (सार्वजनिक तौर पर उपलब्ध होने से पहले वाला वर्शन) इस तरीके की मदद से, आपके Google Analytics इवेंट डेटा की फ़नल रिपोर्ट को पसंद के मुताबिक बनाया जाता है. फ़नल एक्सप्लोरेशन से उन चरणों को विज़ुअलाइज़ किया जा सकता है जिनका इस्तेमाल करके, आपके उपयोगकर्ता टास्क पूरा करते हैं. साथ ही, यह भी तुरंत देखा जा सकता है कि वे हर चरण को पूरा कर रहे हैं या नहीं.
• properties.chat (सार्वजनिक तौर पर उपलब्ध होने से पहले वाला वर्शन) इस तरीके से, Google Analytics में Ask Advisor सुविधा को प्रोग्राम के हिसाब से ऐक्सेस किया जा सकता है. इवेंट डेटा के बारे में नैचुरल लैंग्वेज में सवाल पूछे जा सकते हैं. साथ ही, परफ़ॉर्मेंस में हुए बदलावों का विश्लेषण किया जा सकता है. इसके अलावा, स्ट्रक्चर्ड नैरेटिव और टेबल के तौर पर इनसाइट पाई जा सकती हैं.

इस्तेमाल किए जा सकने वाले डाइमेंशन और मेट्रिक

Data API के साथ काम करने वाले सभी डाइमेंशन और मेट्रिक की सूची देखने के लिए, एपीआई स्कीमा से जुड़ा दस्तावेज़ देखें.