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

यह दस्तावेज़ 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
}