ردیابی رویداد

این راهنمای توسعه‌دهنده نحوه استفاده از Google Analytics SDK v4 برای Android را برای اندازه‌گیری رویدادها در برنامه خود توضیح می‌دهد.

بررسی اجمالی

رویدادها روشی مفید برای جمع‌آوری داده‌های مربوط به تعامل کاربر با اجزای تعاملی برنامه شما، مانند فشار دادن دکمه‌ها یا استفاده از یک آیتم خاص در یک بازی است.

یک رویداد از چهار فیلد تشکیل شده است که می توانید از آنها برای توصیف تعامل کاربر با محتوای برنامه خود استفاده کنید:

نام زمینه	تایپ کنید	ضروری	شرح
دسته بندی	`String`	آره	دسته رویداد
عمل	`String`	آره	اقدام رویداد
برچسب	`String`	خیر	برچسب رویداد
ارزش	`Long`	خیر	ارزش رویداد

پیاده سازی

برای ارسال یک رویداد به Google Analytics، از HitBuilders.EventBuilder استفاده کنید و ضربه را ارسال کنید، همانطور که در این مثال نشان داده شده است:

// Get tracker.
Tracker t = ((AnalyticsSampleApp) getActivity().getApplication()).getTracker(
    TrackerName.APP_TRACKER);
// Build and send an Event.
t.send(new HitBuilders.EventBuilder()
    .setCategory(getString(categoryId))
    .setAction(getString(actionId))
    .setLabel(getString(labelId))
    .build());

برای جزئیات بیشتر در مورد روش getTracker به تنظیمات پیشرفته مراجعه کنید.

رویدادهای غیر تعاملی

در برخی موارد ممکن است بخواهید یک رویداد را به عنوان یک رویداد غیرتعاملی ارسال کنید. برای انجام این کار، true به setNonInteraction :

t.send(new HitBuilders.EventBuilder()
    .setCategory(getString(categoryId))
    .setAction(getString(actionId))
    .setNonInteraction(true)
    .build());

ارسال کنید

برای اطلاعات بیشتر در مورد بازدیدهای غیرتعاملی و زمان استفاده از آنها، درباره رویدادهای غیرتعاملی در مرکز راهنمای Analytics مطالعه کنید.

یک قطعه کد از نمونه برنامه را ببینید

قطعه زیر نمونه ای از Fragment را نشان می دهد که یک رویداد را ارسال می کند:

package com.google.android.apps.mobileplayground;

import android.os.Bundle;
import android.support.v4.app.Fragment;
import android.view.LayoutInflater;
import android.view.View;
import android.view.View.OnClickListener;
import android.view.ViewGroup;
import android.widget.Button;
import com.google.android.apps.mobileplayground.AnalyticsSampleApp.TrackerName;
import com.google.android.gms.analytics.GoogleAnalytics;
import com.google.android.gms.analytics.HitBuilders;
import com.google.android.gms.analytics.Tracker;

/**
 * Class to exercise Event hits.
 */
public class EventFragment extends Fragment {

  @Override
  public View onCreateView(LayoutInflater inflater, ViewGroup container,
      Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);

    View view = inflater.inflate(R.layout.event, container, false);

    setupEvent(view, R.id.video1Play, R.string.videoCategory, R.string.videoPlay, R.string.video1);
    setupEvent(view, R.id.video1Pause, R.string.videoCategory, R.string.videoPause,
        R.string.video1);
    setupEvent(view, R.id.video2Play, R.string.videoCategory, R.string.videoPlay, R.string.video2);
    setupEvent(view, R.id.video2Pause, R.string.videoCategory, R.string.videoPause,
        R.string.video2);

    setupEvent(view, R.id.book1View, R.string.bookCategory, R.string.bookView, R.string.book1);
    setupEvent(view, R.id.book1Share, R.string.bookCategory, R.string.bookShare, R.string.book1);

    final Button dispatchButton = (Button) view.findViewById(R.id.eventDispatch);
    dispatchButton.setOnClickListener(new OnClickListener() {
      @Override
      public void onClick(View v) {
        // Manually start a dispatch (Unnecessary if the tracker has a dispatch interval)
        GoogleAnalytics.getInstance(getActivity().getApplicationContext()).dispatchLocalHits();
      }
    });
    return view;
  }

  private void setupEvent(View v, int buttonId, final int categoryId, final int actionId,
      final int labelId) {
    final Button pageviewButton = (Button) v.findViewById(buttonId);
    pageviewButton.setOnClickListener(new OnClickListener() {
      @Override
      public void onClick(View v) {
        // Get tracker.
        Tracker t = ((AnalyticsSampleApp) getActivity().getApplication()).getTracker(
            TrackerName.APP_TRACKER);
        // Build and send an Event.
        t.send(new HitBuilders.EventBuilder()
            .setCategory(getString(categoryId))
            .setAction(getString(actionId))
            .setLabel(getString(labelId))
            .build());
      }
    });
  }
}