ईकॉमर्स ट्रैकिंग - 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
}