इवेंट ट्रैकिंग

इस डेवलपर गाइड में, Android के लिए Google Analytics SDK v4 के इस्तेमाल का तरीका बताया गया है. इसकी मदद से, अपने ऐप्लिकेशन में इवेंट मेज़र किए जा सकते हैं.

खास जानकारी

इवेंट आपके उपयोगकर्ता के इंटरैक्शन वाले उपयोगकर्ता के इंटरैक्शन को डेटा इकट्ठा करने का उपयोगी तरीका है. जैसे, बटन दबाना या गेम में किसी खास आइटम का इस्तेमाल करना.

किसी इवेंट में चार फ़ील्ड होते हैं. इनका इस्तेमाल करके, उपयोगकर्ता को अपने ऐप्लिकेशन के कॉन्टेंट के साथ इंटरैक्शन की जानकारी दी जा सकती है:

फ़ील्ड का नाम	टाइप	ज़रूरी है	जानकारी
कैटगरी	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());
      }
    });
  }
}

ध्यान दें: अगर कम समय में बहुत ज़्यादा कॉल किए जाते हैं, तो Android के लिए Google Analytics SDK v4, इवेंट के साथ-साथ दूसरे हिट को भी थ्रॉटल कर सकता है.