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

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

يوضح هذا المستند كيفية البدء في استخدام حزمة تطوير البرامج (SDK) لخدمة "إحصاءات Google" للإصدار 3 من Android.

قبل البدء

قبل تنفيذ حزمة تطوير البرامج (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 كما هو موضّح في المثال التالي:

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.