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

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

खास जानकारी

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

• कस्टम डाइमेंशन या मेट्रिक को कॉन्फ़िगर करने के लिए, Google Analytics वेब इंटरफ़ेस का इस्तेमाल करें. कस्टम डाइमेंशन या मेट्रिक को कॉन्फ़िगर करने का तरीका जानें (सहायता केंद्र).
• किसी ऐप्लिकेशन से कस्टम डाइमेंशन और मेट्रिक वैल्यू सेट करना और भेजना.

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

फ़ील्ड का नाम	टाइप	ब्यौरा
इंडेक्स	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 सर्वर को व्यक्तिगत पहचान से जुड़ी कोई भी जानकारी (पीआईआई) नहीं भेजी जा सकती. ज़्यादा जानकारी के लिए, कृपया सेवा की शर्तें देखें.