इस डेवलपर गाइड में iOS v3 के लिए Google Analytics SDK का उपयोग करके कस्टम आयाम और मीट्रिक लागू करने का तरीका बताया गया है.
खास जानकारी
कस्टम डाइमेंशन की मदद से, Google Analytics में मेटाडेटा को हिट, उपयोगकर्ताओं, और सेशन के साथ जोड़ा जा सकता है. वहीं, कस्टम मेट्रिक की मदद से Google Analytics में अपनी मेट्रिक बनाई जा सकती हैं और उनमें बढ़ोतरी की जा सकती है.
- Google Analytics वेब इंटरफ़ेस का इस्तेमाल करके कस्टम डाइमेंशन या मेट्रिक को कॉन्फ़िगर करें. कस्टम डाइमेंशन या मेट्रिक को कॉन्फ़िगर करने का तरीका जानें (सहायता केंद्र).
- किसी ऐप्लिकेशन से कस्टम डाइमेंशन और मेट्रिक वैल्यू सेट करना और भेजना.
कस्टम डाइमेंशन और मेट्रिक में दो फ़ील्ड होते हैं:
-
NSNumberइंडेक्स – कस्टम डाइमेंशन या मेट्रिक का इंडेक्स. यह इंडेक्स 1 पर आधारित है. -
NSStringवैल्यू – कस्टम डाइमेंशन या मेट्रिक की वैल्यू. इस मामले में, मेट्रिक को पूर्णांक या फ़िक्स पॉइंट दशमलव वैल्यू के तौर पर पार्स किया जाएगा. ऐसा तब होगा, जब मेट्रिक को मुद्रा के तौर पर कॉन्फ़िगर किया गया हो.
वैल्यू सेट करना और भेजना
कस्टम डाइमेंशन वैल्यू को सेट करने और भेजने के लिए:
// May return nil if a tracker has not yet been initialized with a property ID.
id tracker = [[GAI sharedInstance] defaultTracker];
// Set the custom dimension value on the tracker using its index.
[tracker set:[GAIFields customDimensionForIndex:1]
value:@"Premium user"];
[tracker set:kGAIScreenName
value:@"Home screen"];
// Send the custom dimension value with a screen view.
// Note that the value only needs to be sent once, so it is set on the Map,
// not the tracker.
// Previous V3 SDK versions.
// [tracker send:[[[GAIDictionaryBuilder createAppView] set:@"premium"
// forKey:[GAIFields customDimensionForIndex:1]] build]];
// // SDK Version 3.08 and up.
[tracker send:[[[GAIDictionaryBuilder createScreenView] set:@"premium"
forKey:[GAIFields customDimensionForIndex:1]] build]];
कस्टम आयाम मान किसी भी Google Analytics हिट प्रकार के साथ भेजे जा सकते हैं, जिनमें स्क्रीन व्यू, इवेंट, ई-कॉमर्स लेन-देन, उपयोगकर्ता समय, और सोशल इंटरैक्शन शामिल हैं. कस्टम डाइमेंशन का तय किया गया दायरा प्रोसेसिंग के दौरान, डाइमेंशन वैल्यू से जुड़े हिट तय करेगा.
कस्टम मेट्रिक की वैल्यू सेट करने और भेजने के लिए:
// May return nil if a tracker has not yet been initialized with a property ID.
id tracker = [[GAI sharedInstance] defaultTracker];
// Set the custom metric to be incremented by 5 using its index.
[tracker set:[GAIFields customMetricForIndex:1]
value:[[NSNumber numberWithInt:5] stringValue]];
[tracker set:kGAIScreenName
value:@"Home screen"];
// Custom metric value is sent with this screen view.
// [tracker send:[[GAIDictionaryBuilder createAppView] build]]; // Previous V3 SDK versions.
[tracker send:[[GAIDictionaryBuilder createScreenView] build]]; // SDK Version 3.08 and up.
कार्यान्वयन विचार
इस सेक्शन में कुछ और बातों के बारे में बताया गया है, जिन्हें कस्टम डाइमेंशन या मेट्रिक को लागू करते समय ध्यान में रखना चाहिए.
कस्टम डाइमेंशन के लिए ध्यान रखने वाली बातें
उपयोगकर्ता और सेशन-लेवल के दायरों वाली वैल्यू, पिछले हिट पर लागू होती हैं
- उपयोगकर्ता या सेशन-लेवल के स्कोप वाली कस्टम डाइमेंशन वैल्यू, मौजूदा सेशन के सभी हिट पर लागू होंगी. इनमें, पुराने हिट भी शामिल हैं. अगर आपको सेशन या उपयोगकर्ता-लेवल के स्कोप वाली कस्टम डाइमेंशन वैल्यू को मौजूदा सेशन के पुराने हिट पर लागू नहीं करना है, तो हिट पर वैल्यू लागू करने से पहले, नया सेशन शुरू करें.
- उदाहरण के लिए, अगर सदस्यता टाइप का इस्तेमाल उपयोगकर्ता-लेवल के कस्टम डाइमेंशन के तौर पर किया जा रहा है और कोई उपयोगकर्ता किसी सेशन के बीच में अपनी सदस्यता अपग्रेड करता है, तो हो सकता है कि आप नई कस्टम डाइमेंशन वैल्यू को सेट करने से पहले, नया सेशन शुरू करना चाहें. इससे यह पक्का होगा कि अपग्रेड से पहले के हिट, सदस्यता की पुरानी वैल्यू से जुड़े होंगे, जबकि नए हिट नई वैल्यू के साथ जोड़े जाएंगे.
कस्टम डाइमेंशन और व्यू (प्रोफ़ाइल) फ़िल्टर
- उपयोगकर्ता या सेशन-लेवल के कस्टम डाइमेंशन वैल्यू, मौजूदा और/या आने वाले सेशन के सभी हिट पर अब भी लागू होंगी. भले ही, उन्हें भेजा गया हिट, व्यू (प्रोफ़ाइल) से फ़िल्टर किया गया हो.
- किसी कस्टम डाइमेंशन वैल्यू के हिसाब से फ़िल्टर करने पर, हिट, उस कस्टम डाइमेंशन वैल्यू के दायरे के अनुसार फ़िल्टर किए जाते हैं. आपका डेटा प्रोसेस होने के दौरान, फ़िल्टर और कस्टम डाइमेंशन वैल्यू कैसे इंटरैक्ट करती हैं, इसके बारे में ज़्यादा जानें.
कस्टम मेट्रिक के लिए ध्यान देने वाली बातें
कस्टम मेट्रिक वैल्यू को रिपोर्ट में एग्रीगेट किया जाता है
- कस्टम मेट्रिक की वैल्यू को रिपोर्ट में, Google Analytics में पहले से तय की गई दूसरी
मेट्रिक की तरह ही एग्रीगेट किया जाता है. इस वजह से, अपनी रिपोर्ट में मेट्रिक की कुल संख्या को बढ़ाने के लिए,
कस्टम मेट्रिक की वैल्यू को
1पर सेट किया जाएगा.
कस्टम मेट्रिक और व्यू (प्रोफ़ाइल) फ़िल्टर
- हालांकि, आम तौर पर कस्टम मेट्रिक की वैल्यू अपनी सुविधा के मुताबिक सेट की जा सकती हैं, लेकिन उन हिट पर कस्टम मेट्रिक वैल्यू सेट करने से बचें जो आपके व्यू (प्रोफ़ाइल) से फ़िल्टर हो सकती हैं. अगर किसी हिट को व्यू (प्रोफ़ाइल) फ़िल्टर की मदद से फ़िल्टर किया जाता है, तो उससे जुड़ी सभी कस्टम मेट्रिक की वैल्यू भी फ़िल्टर हो जाएंगी. कस्टम डाइमेंशन, मेट्रिक, और व्यू (प्रोफ़ाइल) फ़िल्टर के बारे में ज़्यादा जानें.
स्क्रीन की अपने-आप माप होने की सुविधा की मदद से वैल्यू सेट करना
- अपने-आप होने वाले स्क्रीन मेज़रमेंट की मदद से भेजे गए स्क्रीन व्यू पर कस्टम डाइमेंशन वैल्यू लागू करने के लिए, व्यू कंट्रोलर के
viewDidAppear:तरीके के दौरान वैल्यू सेट करें. उदाहरण के लिए, आपके व्यू कंट्रोलर की.mफ़ाइल ऐसी दिख सकती है:
#import "myViewController.h"
#import "GAI.h"
@implementation myViewController
-(void)viewDidAppear
{
id<GAITracker> tracker = [[GAI sharedInstance] defaultTracker]; // Get the tracker object.
[tracker set:[GAIFields customDimensionForIndex:1]
value:@"premium"];
[super viewDidAppear:animated]; // Custom dimension value will be sent with the screen view.
}
// The remainder of the implementation is omitted.
व्यक्तिगत पहचान से जुड़ी जानकारी (पीआईआई) को वैल्यू के तौर पर न भेजें
- Google Analytics की सेवा की शर्तों के तहत, Google Analytics सर्वर को व्यक्तिगत पहचान से जुड़ी कोई भी जानकारी (पीआईआई) नहीं भेजी जा सकती. ज़्यादा जानकारी के लिए, कृपया सेवा की शर्तें देखें.