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

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

مقدمة

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

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

إضافةً إلى ذلك، تمنحك حزمة تطوير البرامج (SDK) لخدمة "إحصاءات Google" لنظام التشغيل 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 من 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.