खास जानकारी
Google Analytics iOS की टॉप-लेवल की क्लास.
ट्रैकर बनाने और व्यवहार के हिसाब से फ़्लैग सेट करने की सुविधा देता है.
NSObject इनहेरिट करता है.
इंस्टेंस के तरीके | |
| (आईडी< GAITracker >) | - trackerWithName:trackingId: |
| तय किए गए नाम और ट्रैकिंग आईडी के साथ, GAITracker लागू करता है या उसे वापस लाता है. ज़्यादा देखें... | |
| (आईडी< GAITracker >) | - trackerWithTrackingId: |
| तय ट्रैकिंग आईडी के बराबर नाम वाला GAITracker लागू करता है या उसे फिर से हासिल करता है. ज़्यादा देखें... | |
| (void) | - removeTrackerByName: |
| ट्रैकर शब्दकोश से ट्रैकर को हटाएं. ज़्यादा देखें... | |
| (void) | - डिस्पैच |
| यह ट्रैकिंग की ऐसी जानकारी को भेजता है जिसे ट्रैक नहीं किया जा सका. ज़्यादा देखें... | |
| (void) | - dispatchWithCompleteHandler: |
| यह सूची में अगला ट्रैकिंग बीकन भेजता है, पूरा होने वाले हैंडलर को कॉल करता है. ऐसा तब होता है, जब ट्रैकिंग बीकन भेजा जाता है (kGAIDispatchGood को रिटर्न करना) या कोई गड़बड़ी होने पर (kGAIDispatchError दिखाता है). ज़्यादा देखें... | |
क्लास के तरीके | |
| (GAI *) | + sharedInstance |
| iOS क्लास के लिए Google Analytics का शेयर किया गया इंस्टेंस पाएं. ज़्यादा देखें... | |
प्रॉपर्टी | |
| आईडी< GAITracker > | defaultTracker |
| सुविधा के लिए, यह क्लास एक डिफ़ॉल्ट ट्रैकर इंस्टेंस दिखाती है. ज़्यादा देखें... | |
| आईडी< GAILogger > | logger |
| इस्तेमाल करने के लिए GAILogger. ज़्यादा देखें... | |
| बूल | optOut |
| ऐसा होने पर, ट्रैकिंग की कोई जानकारी इकट्ठा नहीं की जाएगी. कॉल ट्रैक करने से कोई कार्रवाई नहीं होगी. ज़्यादा देखें... | |
| NSTimeInterval | dispatchInterval |
| अगर यह वैल्यू पॉज़िटिव है, तो ट्रैकिंग की जानकारी हर अंतराल सेकंड में अपने-आप डिस्पैच हो जाएगी. ज़्यादा देखें... | |
| बूल | trackUncaughtExceptions |
| अगर नीति को 'सही है' पर सेट किया जाता है, तो SDK टूल, रजिस्टर किए गए ऐसे अपवाद वाले हैंडलर को रिकॉर्ड करेगा जो अभी तक रजिस्टर नहीं हुआ है. इसके बाद, वह अपवाद हैंडलर को रजिस्टर करेगा, जो डिफ़ॉल्ट ट्रैकर का इस्तेमाल करके होने वाले अपवादों को ट्रैक करता है. ज़्यादा देखें... | |
| बूल | dryRun |
| 'हां' पर सेट होने पर, ट्रैकिंग की कोई जानकारी नहीं भेजी जाएगी. ज़्यादा देखें... | |
तरीके का दस्तावेज़
| + (GAI *) शेयर किए गए इंस्टेंस |
iOS क्लास के लिए Google Analytics का शेयर किया गया इंस्टेंस पाएं.
| - (आईडी<GAITracker>) trackerWithName: | (एनएसस्ट्रिंग *) | name | |
| ट्रैकिंग आईडी: | (एनएसस्ट्रिंग *) | trackingId | |
तय किए गए नाम और ट्रैकिंग आईडी के साथ, GAITracker लागू करता है या उसे वापस लाता है.
अगर बताए गए नाम वाला ट्रैकर पहले से मौजूद नहीं है, तो इसे बनाया जाएगा और वापस लाया जाएगा. ऐसा न होने पर, मौजूदा ट्रैकर दिखाया जाएगा. अगर संबंधित नाम के मौजूदा ट्रैकर का ट्रैकिंग आईडी अलग है, तो वह ट्रैकिंग आईडी इस तरीके से नहीं बदलता. अगर डिफ़ॉल्ट ट्रैकर सेट नहीं है, तो उसे यहां दिए गए ट्रैकर इंस्टेंस पर सेट किया जाएगा.
- पैरामीटर
-
नाम इस ट्रैकर का नाम. nilया खाली नहीं होना चाहिए.trackingID इस ट्रैकर के लिए इस्तेमाल किया जाने वाला ट्रैकिंग आईडी. यह UA-xxxxx-yफ़ॉर्मैट में होना चाहिए.
- लौटाए गए प्रॉडक्ट
- बताए गए नाम से जुड़ा GAITracker. Google Analytics को ट्रैकिंग डेटा भेजने के लिए, ट्रैकर का इस्तेमाल किया जा सकता है. अगर इस तरीके को पहली बार किसी खास नाम से कॉल किया जाता है, तो उस नाम का ट्रैकर दिखेगा. साथ ही, एक ही नाम वाले बाद के कॉल में वही इंस्टेंस दिखेगा. ट्रैकर को अपने पास रखने की ज़रूरत नहीं है, क्योंकि लाइब्रेरी में ट्रैकर को सेव रखा जाएगा.
अगर कोई गड़बड़ी होती है या नाम मान्य नहीं है, तो यह तरीका nil दिखाएगा.
| - (आईडी<GAITracker>) trackerWithTrackingId: | (एनएसस्ट्रिंग *) | trackingId |
तय ट्रैकिंग आईडी के बराबर नाम वाला GAITracker लागू करता है या उसे फिर से हासिल करता है.
अगर संबंधित नाम के लिए ट्रैकर पहले से मौजूद नहीं है, तो इसे बनाया जा सकता है. साथ ही, इसका ट्रैकिंग आईडी |trackingId| पर सेट करके दिखाया जाता है. अगर ऐसा नहीं होता है, तो मौजूदा ट्रैकर लौटाया जाता है. अगर संबंधित नाम के मौजूदा ट्रैकर का ट्रैकिंग आईडी अलग है, तो वह ट्रैकिंग आईडी इस तरीके से नहीं बदलता. अगर डिफ़ॉल्ट ट्रैकर सेट नहीं है, तो यह यहां दिए गए ट्रैकर इंस्टेंस पर सेट किया जाता है.
- पैरामीटर
-
trackingID इस ट्रैकर के लिए इस्तेमाल किया जाने वाला ट्रैकिंग आईडी. यह UA-xxxxx-yफ़ॉर्मैट में होना चाहिए. ट्रैकर का नाम और TrackingID का नाम एक ही होगा.
- लौटाए गए प्रॉडक्ट
- किसी खास ट्रैकिंग आईडी से जुड़ा GAITracker. Google Analytics को ट्रैकिंग डेटा भेजने के लिए, ट्रैकर का इस्तेमाल किया जा सकता है. अगर किसी खास ट्रैकिंग आईडी के साथ पहली बार इस तरीके को कॉल किया जाता है, तो संबंधित नाम के लिए ट्रैकर दिखाया जाएगा और उसी ट्रैकिंग आईडी वाले बाद के कॉल में उसी ट्रैकिंग आईडी को दिखाया जाएगा. ट्रैकर को अपने पास रखने की ज़रूरत नहीं है, क्योंकि लाइब्रेरी में ट्रैकर को सेव रखा जाएगा.
अगर कोई गड़बड़ी होती है या TrackingId मान्य नहीं है, तो यह तरीका nil दिखाएगा.
| - (void) removeTrackerByName: | (एनएसस्ट्रिंग *) | name |
ट्रैकर शब्दकोश से ट्रैकर को हटाएं.
अगर यह डिफ़ॉल्ट ट्रैकर है, तो डिफ़ॉल्ट ट्रैकर को भी हटा देता है.
- पैरामीटर
-
नाम ट्रैकर का नाम.
| - (शून्य) डिस्पैच |
यह ट्रैकिंग की ऐसी जानकारी को भेजता है जिसे ट्रैक नहीं किया जा सका.
ध्यान दें कि इसका डिस्पैच इंटरवल पर कोई असर नहीं पड़ता. इसका इस्तेमाल, समय-समय पर भेजे जाने वाले डिस्पैच के साथ किया जा सकता है.
| - (void) | (void(^)(GAIDispatchresults रिज़ल्ट)) | completionHandler |
यह सूची में अगला ट्रैकिंग बीकन भेजता है, पूरा होने वाले हैंडलर को कॉल करता है. ऐसा तब होता है, जब ट्रैकिंग बीकन भेजा जाता है (kGAIDispatchGood को रिटर्न करना) या कोई गड़बड़ी होने पर (kGAIDispatchError दिखाता है).
अगर इंटरनेट कनेक्शन न हो या भेजने के लिए कोई डेटा मौजूद न हो, तो kGAIDispatchNoData दिखता है.
ध्यान दें कि इस तरीके को गैर-शून्य तरीके से पूरा करने वाले हैंडल से कॉल करने से, समय-समय पर डिस्पैच बंद हो जाता है. समय-समय पर भेजे जाने वाले डिस्पैच को फिर से चालू किया जा सकता है. इसे तब चालू किया जा सकता है, जब ऐप्लिकेशन बैकग्राउंड से फिर से शुरू होता है, तो DispatchInterval को पॉज़िटिव नंबर पर सेट करें.
इस तरीके को पूरी तरह से काम करने वाले हैंडल से कॉल करना, ऊपर डिस्पैच को कॉल करने के जैसा ही है.
इस तरीके का इस्तेमाल, iOS 7.0 या बाद के वर्शन में बैकग्राउंड डेटा फ़ेच करने के लिए किया जा सकता है. किसी भी सबमिट न की गई ट्रैकिंग जानकारी को सबमिट करने की प्रक्रिया शुरू करने के लिए, ऐप्लिकेशन से एग्ज़िट करते समय इस नंबर पर संपर्क करना एक सही तरीका होगा.
- पैरामीटर
-
completionHandler एक बार डिस्पैच अनुरोध के बाद चलाया जाने वाला ब्लॉक. GAIDispatchresults पैरामीटर से पता चलता है कि डिस्पैच सफल हुआ, उसमें कोई गड़बड़ी हुई या भेजने के लिए कोई हिट नहीं मिला.
प्रॉपर्टी का दस्तावेज़
|
(रीडराइट, नॉन-एटॉमिक, असाइन) |
सुविधा के लिए, यह क्लास एक डिफ़ॉल्ट ट्रैकर इंस्टेंस दिखाती है.
इसे nil पर शुरू किया जाता है और यह trackerWithTrackingId: में इंस्टैंशिएट किए गए पहले ट्रैकर पर सेट किया जाएगा. इसे ज़रूरत के हिसाब से बदला जा सकता है.
डिफ़ॉल्ट रूप से, GAITrackedViewController क्लास इस ट्रैकर इंस्टेंस का इस्तेमाल करेगी.
|
(रीडराइट, नॉन-एटॉमिक, असाइन) |
ऐसा होने पर, ट्रैकिंग की कोई जानकारी इकट्ठा नहीं की जाएगी. कॉल ट्रैक करने से कोई कार्रवाई नहीं होगी.
अगर नीति को 'सही है' पर सेट किया जाता है, तो अपलोड की जाने वाली सारी जानकारी मिटा दी जाएगी. SDK टूल, इस फ़्लैग की वैल्यू अपने-आप बरकरार रखेगा. डेवलपर, ऐप्लिकेशन में ऑप्ट-आउट करने की सेटिंग लागू करने के लिए, इस फ़्लैग का इस्तेमाल कर सकते हैं. ऐसा करके, उपयोगकर्ताओं को Google Analytics ट्रैकिंग से ऑप्ट-आउट करने का विकल्प दिया जा सकता है.
जब किसी डिवाइस पर Google Analytics SDK टूल का पहली बार इस्तेमाल किया जाता है, तो यह NO पर सेट होता है और बाद में भी बना रहता है.
|
(रीडराइट, नॉन-एटॉमिक, असाइन) |
अगर यह वैल्यू पॉज़िटिव है, तो ट्रैकिंग की जानकारी हर अंतराल सेकंड में अपने-आप डिस्पैच हो जाएगी.
अगर ऐसा नहीं है, तो डिस्पैच को कॉल करके ट्रैकिंग की जानकारी मैन्युअल तरीके से भेजी जानी चाहिए.
डिफ़ॉल्ट रूप से, यह 120 पर सेट होता है. इससे पता चलता है कि ट्रैकिंग की जानकारी हर 120 सेकंड में अपने-आप भेज दी जाएगी.
|
(रीडराइट, नॉन-एटॉमिक, असाइन) |
अगर नीति को 'सही है' पर सेट किया जाता है, तो SDK टूल, रजिस्टर किए गए ऐसे अपवाद वाले हैंडलर को रिकॉर्ड करेगा जो अभी तक रजिस्टर नहीं हुआ है. इसके बाद, वह अपवाद हैंडलर को रजिस्टर करेगा, जो डिफ़ॉल्ट ट्रैकर का इस्तेमाल करके होने वाले अपवादों को ट्रैक करता है.
अगर डिफ़ॉल्ट ट्रैकर nil नहीं है, तो यह फ़ंक्शन ट्रैकर पर अपवाद को ट्रैक करेगा और किसी भी बकाया ट्रैकिंग जानकारी को 5 सेकंड के लिए भेजने की कोशिश करेगा. इसके बाद, अगर पहले से रजिस्टर किया गया अपवाद हैंडलर है, तो उसे कॉल किया जाएगा. वापस 'गलत' पर सेट करने पर, पहले रजिस्टर नहीं किया गया अपवाद हैंडलर वापस आ जाएगा.
|
(रीडराइट, नॉन-एटॉमिक, असाइन) |
'हां' पर सेट होने पर, ट्रैकिंग की कोई जानकारी नहीं भेजी जाएगी.
डिफ़ॉल्ट वैल्यू 'नहीं' होती है.