এই দস্তাবেজটি বর্ণনা করে যে আপনি কীভাবে Android v2 এর জন্য Google Analytics SDK ব্যবহার করে Google Analytics-এ পাঠানো ডেটা পরিচালনা করতে পারেন৷
ওভারভিউ
Android-এর জন্য Google Analytics SDK-এ, স্ক্রিন ভিউ বা ইভেন্টের মতো সংগৃহীত ডেটা Google Analytics সার্ভারে পাঠানোর আগে একটি সারিতে স্থানীয়ভাবে সংরক্ষণ করা হয়। যে প্রক্রিয়ার মাধ্যমে ডেটার এই টুকরোগুলি (এখানে "হিট" হিসাবে উল্লেখ করা হয়েছে) SDK থেকে Google Analytics-এ পাঠানো হয় তাকে পাঠানো হয়।
ডিসপ্যাচিং মোবাইল সংগ্রহের লাইব্রেরির জন্য অনন্য এবং এটি অবিশ্বস্ত নেটওয়ার্ক অ্যাক্সেস এবং সীমিত ব্যাটারি লাইফের চ্যালেঞ্জগুলি কমানোর জন্য ডিজাইন করা হয়েছে।
দুটি ধরণের প্রেরণ রয়েছে:
- পর্যায়ক্রমিক প্রেরণ - একটি পুনরাবৃত্ত বিরতিতে স্বয়ংক্রিয়ভাবে হিট প্রেরণ করে যা আপনি প্রোগ্রামগতভাবে বা আপনার
analytics.xmlফাইলে নির্দিষ্ট করেন। - ম্যানুয়াল প্রেরণ - আপনার জন্য সুবিধাজনক হলে ডেটা পাঠাতে ম্যানুয়ালি হিটগুলি প্রেরণ করুন, উদাহরণস্বরূপ যখন একটি বিদ্যমান HTTP সংযোগ থাকে৷
SDK-এর সংস্করণ 2-এ প্রধান UI থ্রেডের বাইরে উভয় ধরনের প্রেরণই ঘটে
এই নথির অবশিষ্টাংশ প্রতিটি ধরণের প্রেরণ এবং কীভাবে সেগুলিকে আপনার অ্যাপে প্রয়োগ করতে হয় তার আরও গভীর দৃষ্টিভঙ্গি প্রদান করবে৷
পর্যায়ক্রমিক প্রেরণ
যেহেতু আপনার অ্যাপ GA ডেটা সংগ্রহ করে, সেই ডেটা একটি সারিতে যোগ করা হয় এবং পর্যায়ক্রমে Google Analytics-এ পাঠানো হয়। আপনার অ্যাপ ফোরগ্রাউন্ডে বা ব্যাকগ্রাউন্ডে চলার সময় পর্যায়ক্রমিক প্রেরণ হতে পারে।
ডিফল্ট প্রেরণ সময়কাল 30 মিনিট। আপনি আপনার analytics.xml ফাইলে ga_dispatchPeriod প্যারামিটার ব্যবহার করে সেকেন্ডের মধ্যে আপনার নিজস্ব ব্যবধান প্রদান করতে পারেন, অথবা এই উদাহরণের মতো setDispatchPeriod(int dispatchPeriodInSeconds) কল করে:
আপনার analytics.xml ফাইলে:
<integer name="ga_dispatchPeriod">60</integer>
প্রোগ্রামগতভাবে:
GAServiceManager.getInstance().setDispatchPeriod(60);
একটি নেতিবাচক মান সেট করলে পর্যায়ক্রমিক প্রেরণ অক্ষম হবে, যদি আপনি Google Analytics-এ কোনো ডেটা পাঠাতে চান তাহলে আপনাকে ম্যানুয়াল প্রেরণ ব্যবহার করতে হবে। অন্যদিকে, 0 এর মান সেট করা প্রতিটি হিটকে অবিলম্বে প্রেরণ করবে যদি একটি নেটওয়ার্ক সংযোগ উপলব্ধ থাকে।
একবার সমস্ত হিট প্রেরণ করা হয়ে গেলে, পর্যায়ক্রমিক প্রেরণ একটি পাওয়ার সেভ মোডে প্রবেশ করবে এবং অন্য একটি পাঠান কল না করা পর্যন্ত নিষ্ক্রিয় থাকবে৷
হিট পাঠানোর অপেক্ষায় থাকা অবস্থায় যদি কোনো ব্যবহারকারী নেটওয়ার্ক অ্যাক্সেস হারায় বা আপনার অ্যাপ ছেড়ে দেয়, সেই হিটগুলি স্থানীয় স্টোরেজে টিকে থাকে। পরের বার যখন আপনার অ্যাপ চালু হবে এবং পাঠানোর কল করা হবে তখন সেগুলি পাঠানো হবে।
ম্যানুয়াল প্রেরণ
পর্যায়ক্রমিক প্রেরণের উপর নির্ভর করা ছাড়াও, এমন সময় থাকতে পারে যখন আপনি ম্যানুয়ালি আপনার হিটগুলি প্রেরণ করতে চান। উদাহরণস্বরূপ, আপনি ওভারহেড কমাতে আপনার অ্যাপ্লিকেশন দ্বারা তৈরি অন্যান্য HTTP অনুরোধগুলির সাথে আপনার প্রেরণগুলি বান্ডিল করতে পারেন।
GAServiceManager উদাহরণ ব্যবহার করে হিটগুলি ম্যানুয়ালি পাঠানো যেতে পারে:
GAServiceManager.getInstance().dispatch();