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

इस डेवलपर गाइड में 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 तरीके के बारे में ज़्यादा जानने के लिए, बेहतर कॉन्फ़िगरेशन देखें.

नॉन-इंटरैक्शन इवेंट

कुछ मामलों में, हो सकता है कि आप किसी इवेंट को नॉन-इंटरैक्शन इवेंट के तौर पर भेजना चाहें. ऐसा करने के लिए, setNonInteraction पर true पास करें:

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 इवेंट के साथ-साथ अन्य हिट को थ्रॉटल कर सकता है.