การติดตามอีคอมเมิร์ซ - iOS SDK

เอกสารนี้จะแสดงภาพรวมของวิธีวัดการชำระเงินในแอปและ รายได้โดยใช้ Google Analytics SDK สำหรับ iOS v3

ภาพรวม

การวัดอีคอมเมิร์ซช่วยให้คุณส่งยอดขายและการซื้อในแอปไปยัง Google Analytics ได้ ข้อมูลอีคอมเมิร์ซใน Google Analytics ประกอบด้วยธุรกรรมและ Hit ของรายการ ซึ่งเกี่ยวข้องกันโดยรหัสธุรกรรมที่ใช้ร่วมกัน

ธุรกรรมมีช่องต่อไปนี้

ชื่อช่อง ฟิลด์เครื่องมือติดตาม ประเภท จำเป็น คำอธิบาย
รหัสธุรกรรม 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 จำเป็นต้องมีการตั้งค่า ค่าธุรกรรมและช่องรายการในตัวติดตามและส่งครั้งละ 1 รายการ เช่น

/*
 * 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

}

ช่องสกุลเงินอีคอมเมิร์ซรองรับค่าสกุลเงินที่ติดลบ ซึ่งอาจเป็นความจําเป็นในกรณีของการคืนเงินหรือการคืนสินค้า

การระบุสกุลเงิน

โดยค่าเริ่มต้น ระบบจะถือว่ามูลค่าธุรกรรมเป็นสกุลเงินของข้อมูลพร็อพเพอร์ตี้ (โปรไฟล์) ที่มีการรายงาน

หากต้องการลบล้างสกุลเงินท้องถิ่นของธุรกรรมและผลิตภัณฑ์ที่เกี่ยวข้อง ให้ตั้งค่าช่องรหัสสกุลเงินของรายการและ Hit ของรายการด้วยรหัสสกุลเงินใหม่ ดูรายการสกุลเงินและรหัสสกุลเงินที่รองรับทั้งหมดได้ใน ข้อมูลอ้างอิงสกุลเงินที่รองรับ

/*
 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
}