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