यह दस्तावेज़, Android SDK के पुराने वर्शन के बारे में बताता है. अगर आपके लिए Analyitcs नया है, तो नए SDK टूल का इस्तेमाल करें. ज़्यादा जानें

कस्टम आयाम और मीट्रिक

इस डेवलपर गाइड में, Android के लिए Google Analytics SDK v4 के इस्तेमाल का तरीका बताया गया है. इसकी मदद से, कस्टम डाइमेंशन और मेट्रिक लागू की जा सकती हैं.

खास जानकारी

ये काम किए जा सकते हैं:

कस्टम डाइमेंशन और मेट्रिक में दो फ़ील्ड होते हैं:

फ़ील्ड का नाम टाइप जानकारी
सूची Integer कस्टम डाइमेंशन या मेट्रिक का इंडेक्स. यह इंडेक्स 1-आधारित है.
वैल्यू String कस्टम डाइमेंशन या मेट्रिक की वैल्यू. मेट्रिक के इस मामले में, अगर मेट्रिक को किसी मुद्रा के तौर पर कॉन्फ़िगर किया गया है, तो उसे पूर्णांक या तय किए गए दशमलव के तौर पर दिखाया जाएगा.

वैल्यू सेट करना और भेजना

कस्टम आयाम मान सेट करने और भेजने के लिए:

// Get tracker.
Tracker t = ((AnalyticsSampleApp) getActivity().getApplication()).getTracker(
    TrackerName.APP_TRACKER);
t.setScreenName("Home Screen");

// Send the custom dimension value with a screen view.
// Note that the value only needs to be sent once.
t.send(new HitBuilders.ScreenViewBuilder()
    .setCustomDimension(1, "premiumUser")
    .build()
);

कस्टम आयाम मान किसी भी Google Analytics हिट प्रकार के साथ भेजे जा सकते हैं, जिनमें स्क्रीन व्यू, इवेंट, ई-कॉमर्स लेन-देन, उपयोगकर्ता समय और सामाजिक इंटरैक्शन शामिल हैं. कस्टम डाइमेंशन का तय किया गया दायरा, प्रोसेस करते समय तय करेगा कि कौनसे हिट डाइमेंशन वैल्यू के साथ जुड़े होते हैं.

कस्टम मेट्रिक वैल्यू सेट करने और भेजने के लिए:

// Get tracker.
Tracker t = ((AnalyticsSampleApp) getActivity().getApplication()).getTracker(
    TrackerName.APP_TRACKER);
t.setScreenName("Home Screen");

// Send the custom dimension value with a screen view.
// Note that the value only needs to be sent once.
t.send(new HitBuilders.ScreenViewBuilder()
    .setCustomMetric(1, 5)
    .build()
);

getTracker तरीके के बारे में जानने के लिए, बेहतर कॉन्फ़िगरेशन देखें.

कार्यान्वयन विचार

इस सेक्शन में कस्टम डाइमेंशन या मेट्रिक लागू करते समय, इन बातों का ध्यान रखना चाहिए.

कस्टम डाइमेंशन के लिए ज़रूरी बातें

उपयोगकर्ता और सत्र-स्तर के दायरों वाले मान पिछले हिट पर लागू होते हैं

  • उपयोगकर्ता या सेशन-लेवल के दायरे वाले कस्टम डाइमेंशन वैल्यू, मौजूदा सेशन के सभी हिट पर लागू होंगे. इनमें पिछले हिट भी शामिल हैं. अगर आप सेशन में या उपयोगकर्ता-लेवल के दायरे में, किसी कस्टम डाइमेंशन की वैल्यू को मौजूदा सेशन के पिछले हिट पर लागू नहीं करना चाहते हैं, तो हिट के साथ वैल्यू को लागू करने से पहले एक नया सेशन शुरू करें.
  • उदाहरण के लिए, अगर आप उपयोगकर्ता-लेवल कस्टम डाइमेंशन के तौर पर सदस्यता टाइप का इस्तेमाल कर रहे हैं और कोई उपयोगकर्ता सेशन के बीच में अपनी सदस्यता अपग्रेड करता है, तो हो सकता है कि आप नया कस्टम डाइमेंशन वैल्यू सेट करने से पहले नया सेशन शुरू करना चाहें. इससे यह पक्का होता है कि अपग्रेड से पहले के हिट, सदस्यता की पुरानी वैल्यू के साथ जोड़े जाएंगे. साथ ही, नए हिट नई वैल्यू के साथ जोड़े जाएंगे.

कस्टम डाइमेंशन और व्यू (प्रोफ़ाइल) फ़िल्टर

  • उपयोगकर्ता या सेशन-लेवल के कस्टम डाइमेंशन की वैल्यू, अब भी मौजूदा और/या आने वाले सेशन के सभी हिट पर लागू होंगी, भले ही उन्हें जिस हिट के साथ भेजा गया है वह व्यू (प्रोफ़ाइल) से फ़िल्टर की गई हो.
  • किसी कस्टम आयाम मान पर फ़िल्टर करते समय, हिट उस कस्टम आयाम मान के दायरे के अनुसार फ़िल्टर किए जाते हैं. डेटा प्रोसेस होने के बाद, फ़िल्टर और कस्टम डाइमेंशन की वैल्यू कैसे इंटरैक्ट करती हैं, इस बारे में ज़्यादा जानें.

कस्टम मेट्रिक के लिए ज़रूरी बातें

कस्टम मेट्रिक वैल्यू को रिपोर्ट में एग्रीगेट किया जाता है

  • रिपोर्ट में कस्टम मेट्रिक की वैल्यू, Google Analytics में पहले से तय की गई मेट्रिक की तरह ही इकट्ठा की जाती हैं. इसलिए, आप अपनी रिपोर्ट में मेट्रिक के कुल योग को बढ़ाने के लिए, कस्टम मेट्रिक की वैल्यू 1 पर सेट करेंगे.

कस्टम मेट्रिक और व्यू (प्रोफ़ाइल) फ़िल्टर

  • आम तौर पर, कस्टम मेट्रिक वैल्यू को कभी भी सुविधा के साथ सेट किया जा सकता है. हालांकि, ऐसे हिट के लिए कस्टम मेट्रिक की वैल्यू सेट करने से बचें जिन्हें आपके व्यू (प्रोफ़ाइलों) से फ़िल्टर किया जा सकता है. अगर किसी हिट को किसी व्यू (प्रोफ़ाइल) फ़िल्टर से फ़िल्टर किया जाता है, तो उससे जुड़ी कस्टम मेट्रिक की वैल्यू भी फ़िल्टर कर दी जाएंगी. कस्टम डाइमेंशन और मेट्रिक और व्यू (प्रोफ़ाइल) फ़िल्टर के बारे में ज़्यादा जानें.

अपने-आप होने वाले स्क्रीन मेज़रमेंट के साथ वैल्यू सेट करना

  • अपने-आप होने वाले स्क्रीन मेज़रमेंट से भेजे गए स्क्रीन व्यू पर कस्टम डाइमेंशन वैल्यू लागू करने के लिए, onStart() के दौरान activityStart() को कॉल करने से पहले वैल्यू सेट करें. ध्यान दें कि onStart() के एक्ज़ीक्यूट करते समय, जिन वैल्यू की जानकारी नहीं होती है उनके लिए मैन्युअल स्क्रीन मेज़रमेंट का सुझाव दिया जाता है.

व्यक्तिगत पहचान से जुड़ी जानकारी (पीआईआई) को वैल्यू के तौर पर न भेजें

  • Google Analytics की सेवा की शर्तों के तहत, Google Analytics के सर्वर पर, व्यक्तिगत पहचान से जुड़ी जानकारी (पीआईआई) नहीं भेजी जा सकती. ज़्यादा जानकारी के लिए, कृपया सेवा की शर्तें देखें.