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

الإصدار الثاني من "إحصاءات Google" SDK لنظام التشغيل Android - نظرة عامة

تسهّل حزمة تطوير البرامج (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 في صفوف أو طرق أخرى، ستحتاج إلى استدعاء EasyTracker's setContext(Context ctx) أولاً:

// 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.