تسهِّل حزمة تطوير البرامج (SDK) لخدمة "إحصاءات Google" لنظام التشغيل Android على المطوّرين عملية جمع بيانات تفاعل المستخدمين من تطبيقاتهم. سيقدم هذا المستند نظرة عامة على قيمة حزمة تطوير البرامج (SDK) بالإضافة إلى دليل لبدء قياس أداء تطبيقك باستخدام رقم تعريف موقع واحد وخدمة EasyTracker.
مقدمة
وتسهِّل حزمة تطوير البرامج (SDK) لخدمة "إحصاءات Google" لنظام التشغيل Android على المطوّرين عملية جمع بيانات تفاعل المستخدمين من تطبيقاتهم. يمكن للمطوّرين بعد ذلك استخدام تقارير "إحصاءات Google" لقياس ما يلي:
- عدد المستخدمين النشطين الذين يستخدمون تطبيقاتهم.
- من أي مكان في العالم يتم استخدام التطبيق.
- اعتماد واستخدام ميزات محددة.
- عمليات الشراء والمعاملات داخل التطبيق
- عدد أعطال التطبيق ونوعها.
- مقاييس مفيدة أخرى
إضافةً إلى ذلك، تمنحك حزمة تطوير البرامج (SDK) لخدمة "إحصاءات Google" لنظام التشغيل Android الأدوات اللازمة لرصد مدى نجاح حملات التسويق عبر الأجهزة الجوّالة من خلال توفير رؤية شاملة لأداء قنواتك التسويقية، بدءًا من عمليات التثبيت في Google Play وصولاً إلى عمليات التثبيت والمعاملات داخل التطبيق.
قبل البدء
قبل بدء تنفيذ حزمة تطوير البرامج (SDK)، تأكّد من توفُّر ما يلي:
- حزمة تطوير البرامج (SDK) لنظام التشغيل Android (متاحة لأنظمة التشغيل Windows وMac OS X وLinux)
- الإصدار الثاني من حزمة تطوير البرامج (SDK) لخدمة "إحصاءات Google" لنظام التشغيل Android (مع تضمين
libGoogleAnalyticsV2.jar
في دليل/libs
ومسار الإصدار الخاص بمشروعك) - يشير هذا المصطلح إلى أحد تطبيقات Android التي يمكنك استخدامها لتنفيذ حزمة تطوير البرامج (SDK) لخدمة "إحصاءات Google" لنظام التشغيل Android، الإصدار الثاني.
- موقع وملف شخصي لتطبيق (الملف الشخصي) جديدان في "إحصاءات Google".
البدء
هناك ثلاث خطوات لبدء استخدام حزمة تطوير البرامج (SDK):
بعد إكمال هذه الخطوات، يمكنك قياس ما يلي باستخدام "إحصاءات Google":
- عمليات تثبيت التطبيقات
- المستخدمون النشطون والخصائص الديمغرافية
- الشاشات وتفاعل المستخدم
- الأعطال والاستثناءات
1- جارٍ تحديث ملف AndroidManifest.xml
حدِّث ملف AndroidManifest.xml بإضافة الأذونات التالية:
<uses-permission android:name="android.permission.INTERNET" /> <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
2. إضافة طرق EasyTracker
أضِف طرق الإرسال إلى طريقتَي onStart()
وonStop()
لكل من Activities
كما في المثال التالي:
/** * An example Activity in your app with Analytics * implemented. */ public class myTrackedActivity extends Activity { @Override public void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); } @Override public void onStart() { super.onStart(); ... // The rest of your onStart() code. EasyTracker.getInstance().activityStart(this); // Add this method. } @Override public void onStop() { super.onStop(); ... // The rest of your onStop() code. EasyTracker.getInstance().activityStop(this); // Add this method. } }
تجدر الإشارة إلى أنّ EasyTracker يتطلّب السمة Context
قبل أن تتمكّن من استدعاء الطرق
الخاصة به. في المثال أعلاه، هذا السطر:
EasyTracker.getInstance.activityStart(this);
بتحديد السياق. ومع ذلك، إذا كنت بحاجة إلى إجراء طلبات EasyTracker
في فئات أو طرق أخرى، فستحتاج إلى استدعاء طريقة
setContext(Context ctx)
في EasyTracker أولاً:
// Set Context before using EasyTracker. Note that the SDK will // use the application context. EasyTracker.getInstance().setContext(this); // EasyTracker is now ready for use.
3. إنشاء ملف analytics.xml
في الإصدار 2 من Google Analytics SDK لنظام التشغيل Android، تتم إدارة خيارات التهيئة من ملف موارد xml، يُسمى analytics.xml
في هذا الدليل. يجب إنشاء هذا الملف في دليل
res/values
لمشروعك وإضافة رقم تعريف التتبّع. يوضّح
المثال التالي كيفية إضافة رقم تعريف التتبّع وتفعيل Activity
وقياس الاستثناءات:
<?xml version="1.0" encoding="utf-8" ?> <resources> <!--Replace placeholder ID with your tracking ID--> <string name="ga_trackingId">UA-XXXX-Y</string> <!--Enable automatic activity tracking--> <bool name="ga_autoActivityTracking">true</bool> <!--Enable automatic exception tracking--> <bool name="ga_reportUncaughtExceptions">true</bool> </resources>
قد يحذرك مدقق الوبر بشأن استخدام شرطة الشكل ("-") في رقم تعريف التتبّع. يمكنك منع ظهور هذا التحذير من خلال إضافة سمات أخرى إلى علامة <resources>
:
<resources xmlns:tools="http://schemas.android.com/tools" tools:ignore="TypographyDashes">
راجِع مرجع مَعلمات analytics.xml للاطّلاع على القائمة الكاملة بالمَعلمات التي يمكنك استخدامها لتكوين عملية التنفيذ.
تهانينا! تم إعداد تطبيقك الآن لإرسال البيانات إلى "إحصاءات Google".
الخطوات التالية
يمكنك إنجاز المزيد باستخدام Google Analytics، بما في ذلك قياس الحملات، والدفعات والمعاملات داخل التطبيقات، وأحداث تفاعل المستخدمين. يُرجى الاطّلاع على أدلة المطوّرين التالية للتعرّف على كيفية إضافة هذه الميزات إلى التنفيذ:
- الضبط المتقدّم: تعرَّف على المزيد من المعلومات عن خيارات الضبط المتقدّمة، بما في ذلك استخدام أجهزة تتبُّع متعدّدة.
- قياس الحملات – تعرَّف على كيفية تنفيذ قياس أداء الحملات لمعرفة القنوات والحملات التي تزيد من عمليات تثبيت التطبيق.
- قياس الأحداث: تعرَّف على كيفية قياس تفاعل المستخدم مع المحتوى التفاعلي مثل الأزرار والفيديوهات والوسائط الأخرى باستخدام الأحداث.
- قياس الدفعات ضمن التطبيق – تعرَّف على كيفية قياس الدفعات والمعاملات داخل التطبيق.
- توقيتات المستخدم: تعرَّف على كيفية قياس توقيتات المستخدمين في تطبيقك لقياس أوقات التحميل والتفاعل مع الوسائط والمزيد.
- مَعلمات Analytics.xml – يمكنك الاطّلاع على القائمة الكاملة
لمَعلمات الإعدادات
analytics.xml
.