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

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

قبل البدء

قبل تنفيذ حزمة تطوير البرامج (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.