कस्टम डाइमेंशन और मेट्रिक - Android SDK v2 (लेगसी)

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

खास जानकारी

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

कस्टम डाइमेंशन या मेट्रिक को लागू करने के दो मुख्य चरण हैं:

  1. Google Analytics वेब इंटरफ़ेस का इस्तेमाल करके कस्टम डाइमेंशन या मेट्रिक तय करें.
    वेब इंटरफ़ेस के प्रॉपर्टी सेटिंग सेक्शन में कस्टम डाइमेंशन या मेट्रिक का इंडेक्स, नाम, और दायरा सेट करें.
    कस्टम डाइमेंशन या मेट्रिक तय करने का तरीका जानें.
  2. कस्टम डाइमेंशन और मेट्रिक वैल्यू को सेट और इकट्ठा करने के लिए, कोड लागू करें.
    पिछले चरण में तय किए गए इंडेक्स पर, अपनी Google Analytics हिट के लिए कस्टम डाइमेंशन या मेट्रिक वैल्यू सेट करने के लिए, अपने ऐप्लिकेशन में कोड जोड़ें.

इस लेख के अगले हिस्से में, कस्टम डाइमेंशन या मेट्रिक वैल्यू को सेट करने और भेजने के लिए, कोड को लागू करने का तरीका बताया गया है.

कस्टम डाइमेंशन

कस्टम डाइमेंशन वैल्यू, Google Analytics के सभी हिट टाइप पर सेट की जा सकती हैं. आपको जिस भेजें कॉल पर वैल्यू लागू करनी है उसके ठीक पहले कस्टम डाइमेंशन वैल्यू सेट करें.

कस्टम डाइमेंशन का तय किया गया दायरा उस प्रोसेस के समय तय करेगा कि उस वैल्यू से कौनसे दूसरे हिट जोड़े जा सकते हैं.

कस्टम डाइमेंशन वैल्यू सेट करने के लिए, ये फ़ील्ड ज़रूरी हैं:

  • Integer इंडेक्स – कस्टम डाइमेंशन डेफ़िनिशन का इंडेक्स. यह इंडेक्स 1 पर आधारित है.
  • String वैल्यू – कस्टम डाइमेंशन की वैल्यू.

कस्टम आयाम मान सेट करना

कस्टम डाइमेंशन वैल्यू सेट करने के लिए, 'भेजें कॉल' से पहले setCustomDimension को कॉल करें, जिसके साथ आपको वैल्यू जोड़नी है:

// Get the tracker object.
Tracker tracker = EasyTracker.getTracker();

// Set the dimension value for index 1.
tracker.setCustomDimension(1, "myValue");

// Dimension value is associated and sent with this hit.
tracker.sendView();

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

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

उपयोगकर्ता और सेशन-लेवल के दायरे लालची होते हैं

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

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

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

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

जब किसी कस्टम डाइमेंशन वैल्यू के हिसाब से फ़िल्टर किया जाता है, तो हिट उस कस्टम डाइमेंशन वैल्यू के दायरे के हिसाब से फ़िल्टर किए जाते हैं.

आपका डेटा प्रोसेस होने के दौरान फ़िल्टर और कस्टम डाइमेंशन वैल्यू कैसे इंटरैक्ट करती हैं, इसके बारे में ज़्यादा जानें.

स्क्रीन की अपने-आप माप होने की सुविधा की मदद से वैल्यू सेट करना

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

ध्यान दें कि जिन मामलों में onStart() के लागू होने पर, वैल्यू का पता नहीं चलता है वहां हमारा सुझाव है कि आप मैन्युअल तरीके से स्क्रीन मेज़रमेंट का इस्तेमाल करें.

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

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

कस्टम मेट्रिक

कस्टम डाइमेंशन को खास हिट पर सावधानी से लागू करना चाहिए और स्कोप से मैनेज करना होता है. हालांकि, जिस हिट पर कस्टम मेट्रिक लागू की गई है उसका रिपोर्टिंग पर असर आम तौर पर नहीं होता. इसलिए, मेट्रिक की वैल्यू पता चलने पर, उन्हें सेट किया जा सकता है.

कस्टम मेट्रिक वैल्यू सेट करने के लिए, ये फ़ील्ड ज़रूरी हैं:

  • Integer इंडेक्स – कस्टम मेट्रिक की डेफ़िनिशन का इंडेक्स.
  • Integer वैल्यू – कस्टम मेट्रिक की वैल्यू. वैल्यू नेगेटिव हो सकती हैं.

कस्टम मेट्रिक वैल्यू सेट करना

कस्टम मेट्रिक वैल्यू सेट करने के लिए, एक और कॉल भेजने से पहले setCustomMetric को कॉल करें:

// Get the tracker object.
Tracker tracker = EasyTracker.getTracker();

// Increment the metric at index 1.
tracker.setCustomMetric(1, 1);

// Metric value sent with this hit.
tracker.sendView();

इसके अलावा, मुद्रा के लिए कस्टम मेट्रिक सेट करने के लिए:

// Get the tracker.
Tracker tracker = EasyTracker.getTracker();

// Create a map for hit params.
HashMap params = new HashMap();
params.put(ModelFields.APP_SCREEN, "Product Page");

// Set currency value to custom metric slot 1.
// Currency values may be fixed decimal.
params.put("&cm1", "24.99");

// Send the custom metric value with a screen view.
tracker.send("appview", params);

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

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

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

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

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

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