تتبع الأحداث - Android SDK

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

نظرة عامة

الأحداث هي طريقة مفيدة لجمع البيانات حول تفاعل المستخدم مع المكوّنات التفاعلية لتطبيقك، مثل الضغطات على الأزرار أو استخدام عنصر معيّن في إحدى الألعاب.

يتألف الحدث من أربعة حقول يمكنك استخدامها لوصف تفاعل المستخدم مع محتوى تطبيقك:

اسم الحقل حقل أداة التتبُّع النوع مطلوبة الوصف
الفئة Fields.EVENT_CATEGORY String نعم فئة الحدث
الإجراء Fields.EVENT_ACTION String نعم إجراء الحدث
التصنيف Fields.EVENT_LABEL String لا تصنيف الحدث
القيمة Fields.EVENT_VALUE Long لا قيمة الحدث

التنفيذ

لإرسال حدث إلى "إحصاءات Google"، استخدِم MapBuilder.createEvent() وأرسِل النتيجة، كما في هذا المثال:

@Override
public void onClick(View v) {
  // May return null if a EasyTracker has not yet been initialized with a
  // property ID.
  EasyTracker easyTracker = EasyTracker.getInstance(this);

  // MapBuilder.createEvent().build() returns a Map of event fields and values
  // that are set and sent with the hit.
  easyTracker.send(MapBuilder
      .createEvent("ui_action",     // Event category (required)
                   "button_press",  // Event action (required)
                   "play_button",   // Event label
                   null)            // Event value
      .build()
  );
}