यह दस्तावेज़ iOS v3 के लिए Google Analytics SDK का इस्तेमाल करके इन-ऐप्लिकेशन भुगतान और आय को मापने के तरीके की खास जानकारी देता है.
खास जानकारी
ई-कॉमर्स मेज़रमेंट की मदद से, इन-ऐप्लिकेशन खरीदारी और बिक्री की जानकारी Google Analytics को भेजी जा सकती है. Google Analytics में ई-कॉमर्स डेटा किसी शेयर किए गए लेन-देन आईडी से संबंधित लेन-देन और आइटम हिट से बना होता है.
लेन-देन में ये फ़ील्ड शामिल होते हैं:
फ़ील्ड का नाम | ट्रैकर फ़ील्ड | टाइप | ज़रूरी है | ब्यौरा |
---|---|---|---|---|
लेन-देन आईडी |
kGAITransactionId |
NSString |
हां | लेन-देन की जानकारी देने वाला यूनीक आईडी. इस आईडी और अन्य लेन-देन आईडी के बीच टकराव नहीं होना चाहिए. |
अफ़िलिएशन |
kGAITransactionAffiliation |
NSString |
हां | वह इकाई जिसके साथ लेन-देन जुड़ा होना चाहिए (उदाहरण के लिए, कोई खास स्टोर) |
रेवेन्यू |
kGAITransactionRevenue |
NSNumber |
हां | किसी लेन-देन से मिला कुल रेवेन्यू. इसमें टैक्स और शिपिंग शुल्क शामिल हैं |
टैक्स |
kGAITransactionTax |
NSNumber |
हां | किसी लेन-देन पर लगने वाला कुल टैक्स |
शिपिंग |
kGAITransactionShipping |
NSNumber |
हां | किसी लेन-देन के लिए शिपिंग की कुल लागत |
करंसी कोड |
kGAICurrencyCode |
NSString |
नहीं | किसी लेन-देन की स्थानीय मुद्रा. डिफ़ॉल्ट रूप से, उस व्यू (प्रोफ़ाइल) की मुद्रा होती है जिसमें लेन-देन देखे जा रहे होते हैं. |
आइटम में ये फ़ील्ड होते हैं:
फ़ील्ड का नाम | ट्रैकर फ़ील्ड | टाइप | ज़रूरी है | ब्यौरा |
---|---|---|---|---|
लेन-देन आईडी |
kGAITransactionId |
NSString |
हां | वह ट्रांज़ैक्शन आईडी जिससे आइटम जुड़ा होना चाहिए |
नाम |
kGAIItemName |
NSString |
हां | प्रॉडक्ट का नाम |
SKU |
kGAIItemSku |
NSString |
हां | किसी प्रॉडक्ट का SKU |
कैटगरी |
kGAIItemCategory |
NSString |
नहीं | वह कैटगरी जिससे प्रॉडक्ट जुड़ा है |
कीमत |
kGAIItemPrice |
NSNumber |
हां | किसी प्रॉडक्ट की कीमत |
संख्या |
kGAIItemQuantity |
NSNumber |
हां | किसी प्रॉडक्ट की संख्या |
करंसी कोड |
kGAICurrencyCode |
NSString |
नहीं | किसी लेन-देन की स्थानीय मुद्रा. डिफ़ॉल्ट रूप से, उस व्यू (प्रोफ़ाइल) की मुद्रा होती है जिसमें लेन-देन की रिपोर्ट दी जाती है. |
ई-कॉमर्स डेटा का इस्तेमाल मुख्य रूप से इन स्टैंडर्ड रिपोर्ट में किया जाता है:
- ई-कॉमर्स के बारे में खास जानकारी
- प्रॉडक्ट परफ़ॉर्मेंस
- सेल्स परफ़ॉर्मेंस
- लेन-देन
- खरीदने में लगा समय
लागू करने का तरीका
Google Analytics को लेन-देन और आइटम का डेटा भेजने के लिए, ट्रैकर पर लेन-देन और आइटम फ़ील्ड की वैल्यू सेट करनी होंगी और उन्हें एक-एक करके भेजना होगा. उदाहरण के लिए:
/* * Called when a purchase is processed and verified. */ - (void)onPurchaseCompleted { // Assumes a tracker has already been initialized with a property ID, otherwise // this call returns null. id tracker = [[GAI sharedInstance] defaultTracker]; [tracker send:[[GAIDictionaryBuilder createTransactionWithId:@"0_123456" // (NSString) Transaction ID affiliation:@"In-app Store" // (NSString) Affiliation revenue:@2.16F // (NSNumber) Order revenue (including tax and shipping) tax:@0.17F // (NSNumber) Tax shipping:@0 // (NSNumber) Shipping currencyCode:@"USD"] build]]; // (NSString) Currency code [tracker send:[[GAIDictionaryBuilder createItemWithTransactionId:@"0_123456" // (NSString) Transaction ID name:@"Space Expansion" // (NSString) Product Name sku:@"L_789" // (NSString) Product SKU category:@"Game expansions" // (NSString) Product category price:@1.9F // (NSNumber) Product price quantity:@1 // (NSInteger) Product quantity currencyCode:@"USD"] build]]; // (NSString) Currency code }
ई-कॉमर्स मुद्रा फ़ील्ड में नेगेटिव मुद्रा फ़ील्ड में वैल्यू दिख सकती है. रिफ़ंड या सामान लौटाने के मामले में, ऐसा करना ज़रूरी हो सकता है.
मुद्राएं निर्दिष्ट करना
डिफ़ॉल्ट रूप से, लेन-देन मान उस व्यू (प्रोफ़ाइल) की मुद्रा में माना जाता है, जिसमें उनकी रिपोर्ट की जाती है.
किसी लेन-देन की स्थानीय मुद्रा और उससे संबंधित किसी भी प्रॉडक्ट को बदलने के लिए, लेन-देन के मुद्रा कोड फ़ील्ड और आइटम हिट को नए मुद्रा कोड के साथ सेट करें. इस्तेमाल की जा सकने वाली मुद्राओं और मुद्रा कोड की पूरी सूची के लिए, इस्तेमाल की जा सकने वाली मुद्राओं का रेफ़रंस देखें.
/* 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). */ - (void)onPurchaseCompleted { // Assumes a tracker has already been initialized with a property ID, otherwise // this call returns null. id tracker = [[GAI sharedInstance] defaultTracker]; [tracker send:[[GAIDictionaryBuilder createTransactionWithId:@"0_123456", // (NSString) Transaction ID, should be unique among transactions. affiliation:@"In-app Store", // (NSString) Affiliation revenue:(int64_t) 2.16, // (int64_t) Order revenue (including tax and shipping) tax:(int64_t) 0.17, // (int64_t) Tax shipping:(int64_t) 0, // (int64_t) Shipping currencyCode:@"EUR"] build]]; // (NSString) Currency code }