يوضّح دليل المطوِّر هذا كيفية قياس الأحداث في تطبيقك باستخدام الإصدار 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() ); }