ইকমার্স ট্র্যাকিং - 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 হ্যাঁ পণ্যের নাম
এসকেইউ 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
}