يوضّح هذا المستند كيف يمكنك إدارة بيانات الإرسال إلى Google Analytics باستخدام الإصدار الثالث من حزمة تطوير البرامج (SDK) لخدمة "إحصاءات Google".
نظرة عامة
ويتم تخزين البيانات التي يتم جمعها باستخدام حزمة تطوير البرامج (SDK) لخدمة "إحصاءات Google" لنظام التشغيل Android محليًا قبل إرسالها في سلسلة محادثات منفصلة إلى "إحصاءات Google".
يجب إرسال البيانات واستلامها بحلول 4 صباحًا من اليوم التالي، حسب المنطقة الزمنية المحلية لكل ملف شخصي. ولن تظهر في التقارير أي بيانات يتم تلقّيها بعد ذلك التاريخ. على سبيل المثال، إذا كانت النتيجة مُدرَجة في قائمة الانتظار محليًا عند الساعة 11:59 مساءً، يجب إرسالها في غضون 4 ساعات بحلول الساعة 3:59 صباحًا حتى تظهر في التقارير. من ناحية أخرى، يجب إرسال النتيجة المعروضة في قائمة الانتظار عند الساعة 12:00 صباحًا في غضون 28 ساعة، أي 3:59 صباحًا من اليوم التالي، لتظهر في التقارير.
الإرسال الدوري
يتم تلقائيًا إرسال البيانات من حزمة تطوير البرامج (SDK) لخدمة "إحصاءات Google" لنظام التشغيل Android كل 30 دقيقة.
لضبط فترة الإرسال آليًا:
// Set the dispatch period in seconds. GAServiceManager.getInstance().setLocalDispatchPeriod(15);
لضبط فترة الإرسال بتنسيق XML باستخدام EasyTracker:
<integer name="ga_dispatchPeriod">30</integer>
ويؤدي ضبط قيمة سالبة إلى إيقاف الإرسال الدوري، ما يتطلب منك استخدام الإرسال اليدوي إذا كنت تريد إرسال أي بيانات إلى "إحصاءات Google".
// Disable periodic dispatch by setting dispatch period to a value less than 1. GoogleAnalytics.getInstance(this).setDispatchPeriod(0);
إذا فقد المستخدم إمكانية الوصول إلى الشبكة أو أنهى تطبيقك بينما لا تزال هناك نتائج في انتظار الإرسال، تظل هذه النتائج في مساحة التخزين المحلية. وسيتم إرسالها عند تشغيل تطبيقك في المرة التالية التي يتم فيها استدعاء طريقة الإرسال.
الإرسال اليدوي
لإرسال النتائج يدويًا، على سبيل المثال، عندما تعرف أنّ لاسلكي الجهاز قيد الاستخدام حاليًا لإرسال بيانات أخرى:
GAServiceManager.getInstance().dispatchLocalHits();