यह दस्तावेज़ Android v2 के लिए Google Analytics SDK का इस्तेमाल करके इन-ऐप्लिकेशन भुगतान और आय को मापने के तरीके की खास जानकारी देता है.
खास जानकारी
ई-कॉमर्स मेज़रमेंट की मदद से, इन-ऐप्लिकेशन खरीदारी और बिक्री की जानकारी Google Analytics को भेजी जा सकती है. Google Analytics में ई-कॉमर्स डेटा आम तौर पर शेयर किए गए ट्रांज़ैक्शन आईडी से जुड़े लेन-देन और आइटम से जुड़ा होता है. Android के लिए Google Analytics SDK में, यह संबंध एक ट्रांज़ैक्शन ऑब्जेक्ट बनाकर और उसमें आइटम जोड़कर बनाया जाता है.
ई-कॉमर्स डेटा का इस्तेमाल, इन रिपोर्ट में प्राइमरी डेटा के तौर पर किया जाता है:
- ई-कॉमर्स के बारे में खास जानकारी
- प्रॉडक्ट परफ़ॉर्मेंस
- सेल्स परफ़ॉर्मेंस
- लेन-देन
- खरीदने में लगा समय
लागू करने का तरीका
Google Analytics से होने वाले लेन-देन को मेज़र करने के तीन चरण होते हैं:
- कोई ट्रांज़ैक्शन ऑब्जेक्ट बनाएं.
- आइटम ऑब्जेक्ट बनाएं और उन्हें ट्रांज़ैक्शन ऑब्जेक्ट में जोड़ें.
sendTransaction(Transaction transObject)का इस्तेमाल करके लेन-देन भेजें .
यहां दिए गए उदाहरण में, हम यह मान सकते हैं कि
onPurchaseCompleted()
उपयोगकर्ता को इन-ऐप्लिकेशन खरीदारी पूरी करने के बाद कॉल किया जाता है.
/**
* The purchase was processed. We will send the transaction and its associated line items to Google Analytics,
* but only if the purchase has been confirmed.
*/
public void onPurchaseCompleted() {
Transaction myTrans = new Transaction.Builder(
"0_123456", // (String) Transaction Id, should be unique.
(long) (2.16 * 1000000)) // (long) Order total (in micros)
.setAffiliation("In-App Store") // (String) Affiliation
.setTotalTaxInMicros((long) (0.17 * 1000000)) // (long) Total tax (in micros)
.setShippingCostInMicros(0) // (long) Total shipping cost (in micros)
.build();
myTrans.addItem(new Item.Builder(
"L_789", // (String) Product SKU
"Level Pack: Space", // (String) Product name
(long) (1.99 * 1000000), // (long) Product price (in micros)
(long) 1) // (long) Product quantity
.setProductCategory("Game expansions") // (String) Product category
.build());
Tracker myTracker = EasyTracker.getTracker(); // Get reference to tracker.
myTracker.sendTransaction(myTrans); // Send the transaction.
}
मुद्रा के टाइप
Android के लिए Google Analytics SDK टूल में, ई-कॉमर्स मुद्रा फ़ील्ड माइक्रो (लाखों मुद्रा) में होने चाहिए.
उदाहरण के लिए, 4.5991 मुद्रा की वैल्यू भेजने के लिए, आपको उस वैल्यू को Google Analytics को ट्रांज़ैक्शन भेजते समय, उस वैल्यू को माइक्रो (यानी 4599100) में बदलना होगा. इसके लिए, ऊपर दिए गए उदाहरणों में बताया गया है. जब SDK टूल, उस लेन-देन को Google Analytics को भेजता है, तो वह वैल्यू अपने-आप तय बिंदु वाले दशमलव मान में बदल जाती है और 4.5991 के तौर पर भेजी जाती है.
आपके ई-कॉमर्स कोड में मुद्रा के चिह्न शामिल नहीं किए जाने चाहिए और न ही कॉमा का इस्तेमाल किया जाना चाहिए.
ई-कॉमर्स मुद्रा फ़ील्ड में नेगेटिव मुद्रा फ़ील्ड भी दिखते हैं, जो रिफ़ंड या सामान लौटाने के मामले में ज़रूरी हो सकते हैं.
मुद्राएं निर्दिष्ट करना
डिफ़ॉल्ट रूप से, लेन-देन मान उस व्यू (प्रोफ़ाइल) की मुद्रा में माना जाता है, जिसमें उनकी रिपोर्ट की जाती है.
किसी ट्रांज़ैक्शन की स्थानीय मुद्रा बदलने के लिए,
Transaction बनाते समय setCurrencyCode पर कॉल करें, जैसा कि इस उदाहरण में दिखाया गया है:
/**
* 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() {
Transaction myTrans = new Transaction.Builder(
"0_123456",
(long) (1.59 * 1000000))
.setAffiliation("In-App Store")
.setTotalTaxInMicros((long) (0.13 * 1000000))
.setShippingCostInMicros(0)
.setCurrencyCode("EUR") // (String) Set currency code to Euros.
.build();
Tracker myTracker = EasyTracker.getTracker();
myTracker.sendTransaction(myTrans);
}
इस्तेमाल की जा सकने वाली मुद्राओं और मुद्रा कोड की पूरी सूची देखने के लिए, इस्तेमाल की जा सकने वाली मुद्राओं के रेफ़रंस देखें.