इस दस्तावेज़ में 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. }