حزمة تطوير البرامج (SDK) لخدمة "إحصاءات Google" لنظام التشغيل Android، الإصدار 2 (الإصدار القديم) - نظرة عامة

وتسهِّل حزمة تطوير البرامج (SDK) لخدمة "إحصاءات Google" لنظام التشغيل Android على المطوّرين إمكانية جمع بيانات تفاعل المستخدمين من تطبيقاتهم. سيقدم هذا المستند نظرة عامة على قيمة SDK، بالإضافة إلى دليل لبدء قياس أداء تطبيقك باستخدام رقم تعريف موقع واحد وEasyTracker.

مقدمة

وتسهِّل حزمة تطوير البرامج (SDK) لخدمة "إحصاءات Google" لنظام التشغيل Android على المطوّرين جمع بيانات تفاعل المستخدمين من تطبيقاتهم. يمكن للمطوّرين عندئذٍ استخدام تقارير "إحصاءات Google" لقياس ما يلي:

  • عدد المستخدمين النشطين الذين يستخدمون تطبيقاتهم.
  • من أي مكان في العالم يتم استخدام التطبيق.
  • اعتماد واستخدام ميزات محددة.
  • عمليات الشراء والمعاملات داخل التطبيق
  • عدد أعطال التطبيق ونوعها.
  • والعديد من المقاييس المفيدة الأخرى

علاوة على ذلك، تمنحك حزمة Google Analytics SDK لنظام التشغيل Android الأدوات اللازمة لمراقبة نجاح حملات التسويق عبر الأجهزة الجوّالة من خلال توفير رؤية شاملة لأداء قنواتك التسويقية، بدءًا من عمليات تثبيت Google Play ووصولاً إلى عمليات الشراء والمعاملات داخل التطبيق.

قبل البدء

قبل بدء تنفيذ حزمة SDK، يُرجى التأكّد مما يلي:

البدء

هناك ثلاث خطوات لبدء استخدام حزمة تطوير البرامج (SDK):

  1. تحديث AndroidManifest.xml
  2. إضافة طرق EasyTracker
  3. إنشاء ملف analytics.xml

بعد إتمام هذه الخطوات، يمكنك قياس ما يلي باستخدام "إحصاءات 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 من حزمة تطوير البرامج (SDK) لخدمة "إحصاءات Google" لنظام التشغيل 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.xml – يمكنك الاطّلاع على قائمة كاملة بمَعلمات الإعدادات analytics.xml.