ईकॉमर्स ट्रैकिंग - Android SDK

इस दस्तावेज़ में Android v3 के लिए Google Analytics SDK का इस्तेमाल करके इन-ऐप्लिकेशन पेमेंट और आय को मापने के तरीके की खास जानकारी दी गई है.

खास जानकारी

ई-कॉमर्स मेज़रमेंट की मदद से, इन-ऐप्लिकेशन खरीदारी और बिक्री की जानकारी Google Analytics को भेजी जा सकती है. Google Analytics में ई-कॉमर्स डेटा किसी शेयर किए गए लेन-देन आईडी से संबंधित लेन-देन और आइटम हिट से बना होता है.

लेन-देन में ये फ़ील्ड शामिल होते हैं:

फ़ील्ड का नाम ट्रैकर फ़ील्ड टाइप ज़रूरी है ब्यौरा
लेन-देन आईडी Fields.TRANSACTION_ID String हां लेन-देन की जानकारी देने वाला यूनीक आईडी. इस आईडी और अन्य लेन-देन आईडी के बीच टकराव नहीं होना चाहिए.
अफ़िलिएशन Fields.TRANSACTION_AFFILIATION String हां वह इकाई जिसके साथ लेन-देन जुड़ा होना चाहिए (उदाहरण के लिए, कोई खास स्टोर)
रेवेन्यू Fields.TRANSACTION_REVENUE Double हां किसी लेन-देन से मिला कुल रेवेन्यू. इसमें टैक्स और शिपिंग शुल्क शामिल हैं
टैक्स Fields.TRANSACTION_TAX Double हां किसी लेन-देन पर लगने वाला कुल टैक्स
शिपिंग Fields.TRANSACTION_SHIPPING Double हां किसी लेन-देन के लिए शिपिंग की कुल लागत
करंसी कोड Fields.CURRENCY_CODE String नहीं किसी लेन-देन की स्थानीय मुद्रा. डिफ़ॉल्ट रूप से, उस व्यू (प्रोफ़ाइल) की मुद्रा होती है जिसमें लेन-देन देखे जा रहे होते हैं.

आइटम में ये फ़ील्ड होते हैं:

फ़ील्ड का नाम ट्रैकर फ़ील्ड टाइप ज़रूरी है ब्यौरा
लेन-देन आईडी Fields.TRANSACTION_ID String हां वह ट्रांज़ैक्शन आईडी जिससे आइटम जुड़ा होना चाहिए
नाम Fields.ITEM_NAME String हां प्रॉडक्ट का नाम
SKU Fields.ITEM_SKU String हां किसी प्रॉडक्ट का SKU
कैटगरी Fields.ITEM_CATEGORY String नहीं वह कैटगरी जिससे प्रॉडक्ट जुड़ा है
कीमत Fields.ITEM_PRICE Double हां किसी प्रॉडक्ट की कीमत
संख्या Fields.ITEM_QUANTITY Long हां किसी प्रॉडक्ट की संख्या
करंसी कोड Fields.CURRENCY_CODE String नहीं किसी लेन-देन की स्थानीय मुद्रा. डिफ़ॉल्ट रूप से, उस व्यू (प्रोफ़ाइल) की मुद्रा होती है जिसमें लेन-देन की रिपोर्ट दी जाती है.

ई-कॉमर्स डेटा का इस्तेमाल मुख्य रूप से इन स्टैंडर्ड रिपोर्ट में किया जाता है:

  • ई-कॉमर्स के बारे में खास जानकारी
  • प्रॉडक्ट परफ़ॉर्मेंस
  • सेल्स परफ़ॉर्मेंस
  • लेन-देन
  • खरीदने में लगा समय

लागू करने का तरीका

Google Analytics को लेन-देन और आइटम का डेटा भेजने के लिए, ट्रैकर पर लेन-देन और आइटम फ़ील्ड की वैल्यू सेट करनी होंगी और उन्हें एक-एक करके भेजना होगा. उदाहरण के लिए:

import android.app.Activity;

import com.google.analytics.tracking.android.EasyTracker;
import com.google.analytics.tracking.android.MapBuilder;

public class CheckoutActivity extends Activity {

  /*
   * Called when a purchase is processed and verified.
   */
  public void onPurchaseCompleted() {

    // May return null if EasyTracker has not yet been initialized with a
    // property ID.
    EasyTracker easyTracker = EasyTracker.getInstance(this);

    easyTracker.send(MapBuilder
        .createTransaction("0_123456",       // (String) Transaction ID
                           "In-app Store",   // (String) Affiliation
                           2.16d,            // (Double) Order revenue
                           0.17d,            // (Double) Tax
                           0.0d,             // (Double) Shipping
                           "USD")            // (String) Currency code
        .build()
    );

    easyTracker.send(MapBuilder
        .createItem("0_123456",               // (String) Transaction ID
                    "Level Pack: Space",      // (String) Product name
                    "L_789",                  // (String) Product SKU
                    "Game expansions",        // (String) Product category
                    1.99d,                    // (Double) Product price
                    1L,                       // (Long) Product quantity
                    "USD")                    // (String) Currency code
        .build()
    );
  }

  // ... Rest of the Activity definition
}

ई-कॉमर्स मुद्रा फ़ील्ड में नेगेटिव मुद्रा फ़ील्ड में वैल्यू दिख सकती है. रिफ़ंड या सामान लौटाने के मामले में, ऐसा करना ज़रूरी हो सकता है.

मुद्राएं निर्दिष्ट करना

डिफ़ॉल्ट रूप से, लेन-देन मान उस व्यू (प्रोफ़ाइल) की मुद्रा में माना जाता है, जिसमें उनकी रिपोर्ट की जाती है.

किसी लेन-देन की स्थानीय मुद्रा और उससे संबंधित किसी भी प्रॉडक्ट को बदलने के लिए, लेन-देन के मुद्रा कोड फ़ील्ड और आइटम हिट को नए मुद्रा कोड के साथ सेट करें. इस्तेमाल की जा सकने वाली मुद्राओं और मुद्रा कोड की पूरी सूची के लिए, इस्तेमाल की जा सकने वाली मुद्राओं का रेफ़रंस देखें.

import android.app.Activity;

import com.google.analytics.tracking.android.EasyTracker;
import com.google.analytics.tracking.android.MapBuilder;

public class CheckoutActivity extends Activity {
  /**
   * In this example, the currency of the transaction is set to Euros. The
   * currency values will appear in reports using the global currency
   * type of the view (profile).
   */
  public void onPurchaseCompleted() {

    // Assumes a tracker has already been initialized with a property ID, otherwise
    // this call returns null.
    EasyTracker easyTracker = EasyTracker.getInstance(this);

    easyTracker.send(MapBuilder
        .createTransaction("0_123456",       // (String) Transaction ID, should be unique among transactions.
                           "In-app Store",   // (String) Affiliation
                           (long) 2.16,      // (long) Order revenue (includes tax and shipping)
                           (long) 0.17,      // (long) Tax
                           0.0,              // (long) Shipping cost
                           "EUR")            // (String) Currency code
        .build();

  }
  // ... Rest of the Activity definition.
}