इस दस्तावेज़ में बताया गया है कि iOS v2 के लिए Google Analytics SDK का इस्तेमाल करके, Google Analytics को डेटा कैसे मैनेज किया जा सकता है.
खास जानकारी
iOS के लिए Google Analytics SDK में, स्क्रीन व्यू या इवेंट जैसा इकट्ठा किया गया डेटा, Google Analytics सर्वर पर भेजे जाने से पहले स्थानीय तौर पर सूची में स्टोर किया जाता है. जिस प्रक्रिया से (जिसे यहां "हिट" कहा गया है) डेटा को SDK टूल से Google Analytics में भेजा जाता है उसे डिस्पैच करने की प्रक्रिया कहा जाता है.
डिस्पैच करने की सुविधा, मोबाइल कलेक्शन लाइब्रेरी के लिए खास है. इसे नेटवर्क के गैर-भरोसेमंद ऐक्सेस और बैटरी लाइफ़ के सीमित होने की चुनौतियों को कम करने के लिए डिज़ाइन किया गया है.
डिस्पैच करने के दो तरीके हैं:
- किसी खास समय के दौरान मिलने वाली सूचना – आपके बताए गए समय के हिसाब से, हिट अपने-आप भेजे जाते हैं.
- मैन्युअल डिस्पैच – आपकी सुविधा के हिसाब से डेटा भेजने के लिए, हिट को मैन्युअल तरीके से डिस्पैच करें. उदाहरण के लिए, जब कोई मौजूदा एचटीटीपी कनेक्शन हो.
इस दस्तावेज़ के बाकी हिस्से में, हर तरह के डिस्पैच और उन्हें अपने ऐप्लिकेशन में लागू करने के तरीके के बारे में विस्तार से बताया गया है.
समय-समय पर डिस्पैच
जब आपका ऐप्लिकेशन GA डेटा इकट्ठा करता है, तो वह डेटा सूची में जुड़ जाता है और समय-समय पर Google Analytics को भेजा जाता है. समय-समय पर डिस्पैच तब हो सकता है, जब आपका ऐप्लिकेशन फ़ोरग्राउंड में या बैकग्राउंड में चल रहा हो.
डिस्पैच की डिफ़ॉल्ट अवधि
दो मिनट होती है.
इस उदाहरण में बताए गए तरीके से, setDispatchPeriod:(NSTimeInterval) को कॉल करके
कुछ सेकंड में अपना इंटरवल दिया जा सकता है:
[[GAI sharedInstance] setDispatchPeriod:60];
नेगेटिव वैल्यू सेट करने पर, समय-समय पर डिस्पैच की सुविधा बंद हो जाएगी. इसके बाद, अगर आपको Google Analytics को कोई भी डेटा भेजना है, तो मैन्युअल डिस्पैच का इस्तेमाल करना होगा. वहीं दूसरी ओर, 0 वैल्यू सेट करने से, नेटवर्क कनेक्शन उपलब्ध होने पर हर हिट को तुरंत डिस्पैच किया जाएगा.
सभी हिट भेजे जाने के बाद, समय-समय पर डिस्पैच पावर बचत मोड में चला जाएगा और दूसरा कॉल भेजने तक बंद रहेगा.
अगर किसी उपयोगकर्ता के नेटवर्क का ऐक्सेस खो जाता है या वह आपका ऐप्लिकेशन बंद कर देता है, जबकि एक हिट के भेजे जाने के लिए इंतज़ार किया जा रहा होता है, तो वे हिट स्थानीय मेमोरी में बने रहते हैं. अगली बार जब आपका ऐप्लिकेशन चालू होगा और डिस्पैच कॉल किया जाएगा, तब उसे भेज दिया जाएगा.
मैन्युअल डिस्पैच
समय-समय पर डिस्पैच पर निर्भर रहने के अलावा, कई बार ऐसा भी हो सकता है कि आप अपने हिट को मैन्युअल तरीके से भेजना चाहें. उदाहरण के लिए, ओवरहेड कम करने के लिए, अपने ऐप्लिकेशन से किए गए अन्य एचटीटीपी अनुरोधों के साथ डिस्पैच को बंडल किया जा सकता है.
dispatch को कॉल करके, हिट मैन्युअल तरीके से भेजे जा सकते हैं, जैसा कि यहां दिखाया गया है:
[[GAI sharedTracker] dispatch];