ردیابی تجارت الکترونیک - iOS SDK

این سند یک نمای کلی از نحوه اندازه گیری پرداخت های درون برنامه ای و درآمد با استفاده از Google Analytics SDK برای iOS نسخه 3 ارائه می دهد.

بررسی اجمالی

اندازه گیری تجارت الکترونیک به شما امکان می دهد خریدها و فروش های درون برنامه ای را به 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
}