बेहतर कॉन्फ़िगरेशन - iOS SDK टूल

इस दस्तावेज़ में iOS v2 के लिए Google Analytics SDK की कुछ बेहतर कॉन्फ़िगरेशन सुविधाओं का व्यूव्यू है.

खास जानकारी

iOS के लिए Google Analytics SDK टूल, लागू करने की ग्लोबल स्थिति को मैनेज करने और Google Analytics सर्वर पर डेटा भेजने के लिए, दो क्लास का इस्तेमाल करता है.

  • GAI – यह सिंगलटन है जो आपके लागू करने की ग्लोबल स्थिति को मैनेज करता है. इसमें नए GAITracker ऑब्जेक्ट पाना, ऐप्लिकेशन-लेवल से ऑप्ट-आउट करने की सेटिंग और डिस्पैच करने की सेटिंग शामिल हैं.
  • GAITracker – वह क्लास जिससे Google Analytics को डेटा भेजा जाता है. एक से ज़्यादा ट्रैकर इंस्टैंशिएट किए जा सकते हैं, हर एक यूनीक प्रॉपर्टी आईडी के लिए.

कई ट्रैकर इस्तेमाल करना

SDK टूल के वर्शन 2 से, एक ही बार में एक से ज़्यादा ट्रैकर इस्तेमाल किए जा सकते हैं. हर यूनीक ट्रैकिंग आईडी के लिए एक ट्रैकर. सभी ट्रैकर का ग्लोबल स्टेट, आपकेGAI सिंगलटन में एक ही होता है.

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

#import "RootViewController.h"
#import "GAI.h"

@interface RootViewController ()

@end

@implementation RootViewController
{
- (void)viewDidLoad {
  [super viewDidLoad];

  // Send a screen view to the first property.
  id tracker1 = [[GAI sharedInstance] trackerWithTrackingId:@"UA-XXXX-Y"];
  [tracker1 sendView:@"/HomeScreen"];

  // Send another screen view to the second property.
  id tracker2 = [[GAI sharedInstance] trackerWithTrackingId:@"UA-XXXX-Z"];
  [tracker2 sendView:@"Home"];
}

@end

ध्यान रखें कि अपने-आप मेज़रमेंट की सुविधाएं, जैसे कि ऑटोमैटिक स्क्रीन और छूटे हुए अपवाद मेज़रमेंट की सुविधा, Google Analytics को डेटा भेजने के लिए सिर्फ़ एक ट्रैकर का इस्तेमाल करेगी. अगर इन सुविधाओं का इस्तेमाल किया जा रहा है और आपको दूसरे ट्रैकर का इस्तेमाल करके डेटा भेजना है, तो आपको यह काम मैन्युअल तरीके से करना होगा.

रेफ़रंस के लिए, अपने-आप स्क्रीन मेज़रमेंट की सुविधा, दी गई GAITrackedViewController की tracker प्रॉपर्टी में दिए गए ट्रैकर का इस्तेमाल करती है. अपवाद के तौर पर पता न लगने वाला मेज़रमेंट, आपके GAI इंस्टेंस में बताए गए डिफ़ॉल्ट ट्रैकर का इस्तेमाल करता है.

डिफ़ॉल्ट ट्रैकर

लागू करने के लिए एक से ज़्यादा ट्रैकर का इस्तेमाल किया जा सकता है, लेकिन दुनिया भर में इसका एक डिफ़ॉल्ट ट्रैकर होता है. हासिल किया गया पहला Tracker, डिफ़ॉल्ट ट्रैकर बन जाता है.

डिफ़ॉल्ट ट्रैकर पाने के लिए इनका इस्तेमाल करें:

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

डिफ़ॉल्ट ट्रैकर सेट करने के लिए, इसका इस्तेमाल करें:

// Get a new tracker.
id newTracker = [[GAI sharedInstance]trackerWithTrackingId:@"UA-NEW-TRACKING-ID");

// Set the new tracker as the default tracker, globally.
[GAI sharedInstance].defaultTracker = newTracker;

सैंपलिंग

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

उदाहरण के लिए, 50% की दर पर क्लाइंट-साइड सैंपलिंग लागू करने के लिए, इस कोड का इस्तेमाल करें:

// Set a sample rate of 50%.
[tracker setSampleRate:50.0];  // Sample rate is a double.

ऐप्लिकेशन-लेवल से ऑप्ट आउट करना

ऐप्लिकेशन-लेवल पर ऑप्ट आउट फ़्लैग को चालू किया जा सकता है, जो Google Analytics को पूरे ऐप्लिकेशन के लिए बंद कर देगा. सेट करने के बाद, फ़्लैग हमेशा ऐप्लिकेशन के चालू रहने या उसे रीसेट किए जाने तक बना रहेगा.

ऐप्लिकेशन लेवल से ऑप्ट आउट करने की सेटिंग पाने के लिए, इनका इस्तेमाल करें:

// Get the app-level opt out preference.
if ([GAI sharedInstance].optOut) {
  ... // Alert the user they have opted out.
}

ऐप्लिकेशन-लेवल का ऑप्ट आउट फ़्लैग सेट करने के लिए, इनका इस्तेमाल करें:


// Set the app-level opt out preference.
[[GAI sharedInstance].setOptOut = YES];

जांच और डीबग करना

iOS के लिए Google Analytics SDK एक डीबग मोड देता है, जो आपके लॉग में Google Analytics को भेजा जा रहा डेटा इस बारे में उपयोगी जानकारी प्रिंट करेगा.

// Enable debug mode.
[GAI sharedInstance].debug = YES;