कस्टम डाइमेंशन और मेट्रिक - iOS SDK टूल

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

खास जानकारी

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

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

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

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

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

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

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

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

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

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

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

// Get the tracker object.
id tracker = [[GAI sharedInstance].defaultTracker;

// Set the dimension value for index 1.
[tracker setCustom:1
         dimension:@"myValue"];

// Dimension value is associated and sent with this hit.
[tracker sendView:screenName];

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

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

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

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

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

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

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

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

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

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

अपने-आप होने वाले स्क्रीन मेज़रमेंट की मदद से भेजे गए स्क्रीन व्यू पर कस्टम डाइमेंशन वैल्यू लागू करने के लिए, व्यू कंट्रोलर के viewDidAppear: तरीके से वैल्यू सेट करें. उदाहरण के लिए, आपके व्यू कंट्रोलर की .m फ़ाइल ऐसी दिख सकती है:

#import "myViewController.h"
#import "GAI.h"

@implementation myViewController

-(void)viewDidAppear
{
    id tracker = [[GAI sharedInstance].defaultTracker;  // Get the tracker object.
    [tracker setCustom:1
             dimension:@"myValue"];  // Set the custom dimension value.
    [super viewDidAppear:animated]   // Custom dimension value will be sent with the screen view.

}

// The remainder of the implementation is omitted.

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

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

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

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

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

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

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

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

// Get the tracker object.
id tracker = [GAI sharedInstance].defaultTracker;

// Increment the metric at index 1.
[tracker setCustom:1
            metric:[NSNumber numberWithLongLong:1]];

// Metric value sent with this hit.
[tracker sendView:screenName];

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

// Get the tracker.
id tracker = [GAI sharedInstance].defaultTracker;

// Create a dictionary for hit params.
NSDictionary *params = [[NSDictionary alloc] initWithObjectsAndKeys:
    @"Product Page", @"&cd",
   // Set currency value to custom metric slot 1.
   // Currency values may be fixed decimal.
    @"24.99", @"&cm1", nil];

// Send the custom metric value with a screen view.
[tracker send:@"appview"
       params:params];

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

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

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

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

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

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