يوضّح هذا المستند كيفية بدء استخدام حزمة تطوير البرامج (SDK) لخدمة "إحصاءات Google" لنظام التشغيل Android v3.
قبل البدء
قبل تنفيذ حزمة تطوير البرامج (SDK)، تأكَّد من توفُّر ما يلي:
- حزمة تطوير البرامج (SDK) لمطوّري برامج Android (متوفّرة لأنظمة التشغيل Windows وMac OS X وLinux)
- الإصدار 3 من حزمة تطوير البرامج (SDK) لخدمة "إحصاءات Google" لنظام التشغيل Android (مع تضمين
libGoogleAnalyticsServices.jar
في دليل/libs
ومسار الإصدار لمشروعك) - تطبيق Android يمكنك استخدامه لتنفيذ "إحصاءات Google"
- موقع وملف شخصي (ملف شخصي) واحد على الأقل في "إحصاءات 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
، كما في المثال التالي:
package com.example.app; import android.app.Activity; import com.google.analytics.tracking.android.EasyTracker; /** * An example Activity using Google Analytics and EasyTracker. */ 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(this).activityStart(this); // Add this method. } @Override public void onStop() { super.onStop(); ... // The rest of your onStop() code. EasyTracker.getInstance(this).activityStop(this); // Add this method. } }
3- إنشاء ملف analytics.xml
عند استخدام EasyTracker، تتم إدارة إعدادات الضبط العامة باستخدام الموارد المحددة في ملف XML. أنشئ ملفًا باسم analytics.xml
في
دليل res/values
لمشروعك وأضِف الموارد التالية:
<?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 للحصول على قائمة كاملة بالمَعلمات التي يمكنك استخدامها لتكوين عملية التنفيذ. تبعًا لمتطلبات تطبيقاتك، قد تحتاج إلى تغيير فترة الإرسال للتحقق من إرسال النتائج بشكلٍ صحيح. على سبيل المثال، إذا كنت تريد رؤية البيانات في الوقت الفعلي، فقد تحتاج إلى ضبطها على قيمة منخفضة مثل 5 ثوانٍ.
تهانينا تم إعداد تطبيقك الآن لإرسال البيانات إلى "إحصاءات Google".
الخطوات التالية
يمكنك فعل المزيد باستخدام "إحصاءات Google"، بما في ذلك قياس الحملات، والدفعات والمعاملات داخل التطبيق، وأحداث تفاعل المستخدم.
تقدِّم أدلة المطوِّرين التالية تفاصيل إضافية حول كيفية تنفيذ ميزات "إحصاءات Google" في تطبيقك:
- قياس الأحداث: تعرّف على كيفية قياس تفاعل المستخدمين مع المحتوى التفاعلي، مثل الأزرار والفيديوهات والوسائط الأخرى، باستخدام "الأحداث".
- قياس الدفعات داخل التطبيق – تعرَّف على كيفية قياس الدفعات والمعاملات داخل التطبيق.
- قياس الحملات – تعرَّف على كيفية تنفيذ قياس الحملات لمعرفة القنوات والحملات التي تزيد من عمليات تثبيت التطبيق.
- توقيتات المستخدم: تعرَّف على كيفية قياس توقيتات المستخدمين في تطبيقك لقياس أوقات التحميل والتفاعل مع الوسائط وغير ذلك.
- الضبط المتقدّم: يمكنك معرفة المزيد من المعلومات عن خيارات الضبط المتقدّمة، بما في ذلك استخدام عدة أدوات تتبُّع.
-
مَعلمات Analytics.xml – اطّلِع على قائمة كاملة
بمَعلمات الإعداد
analytics.xml
.