Theo dõi thương mại điện tử - iOS SDK

Tài liệu này cung cấp thông tin tổng quan về cách đo lường doanh thu và khoản thanh toán trong ứng dụng bằng SDK Google Analytics dành cho iOS phiên bản 3.

Tổng quan

Tính năng đo lường thương mại điện tử cho phép bạn gửi các lượt mua hàng trong ứng dụng và lượt bán hàng đến Google Analytics. Dữ liệu thương mại điện tử trong Google Analytics bao gồm các lượt truy cập giao dịch và mặt hàng, có liên quan với một mã giao dịch được chia sẻ.

Giao dịch có các trường sau:

Tên trường Trường công cụ theo dõi Loại Bắt buộc Nội dung mô tả
Mã giao dịch kGAITransactionId NSString Có Mã nhận dạng duy nhất đại diện cho giao dịch. Mã nhận dạng này không được trùng với các mã giao dịch khác.
Đơn vị liên kết kGAITransactionAffiliation NSString Có Pháp nhân mà giao dịch phải được liên kết (ví dụ: một cửa hàng cụ thể)
Doanh thu kGAITransactionRevenue NSNumber Có Tổng doanh thu của một giao dịch, bao gồm cả thuế và phí giao hàng
Thuế kGAITransactionTax NSNumber Có Tổng thuế của một giao dịch
Vận chuyển kGAITransactionShipping NSNumber Có Tổng chi phí vận chuyển cho một giao dịch
Mã đơn vị tiền tệ kGAICurrencyCode NSString Không Nội tệ của một giao dịch. Giá trị mặc định là đơn vị tiền tệ của chế độ xem (hồ sơ) mà người dùng sử dụng để xem các giao dịch.

Mục có các trường sau đây:

Tên trường Trường công cụ theo dõi Loại Bắt buộc Nội dung mô tả
Mã giao dịch kGAITransactionId NSString Có Mã giao dịch cần liên kết với mặt hàng
Tên kGAIItemName NSString Có Tên sản phẩm
SKU kGAIItemSku NSString Có SKU của sản phẩm
Danh mục kGAIItemCategory NSString Không Danh mục chứa sản phẩm
Giá kGAIItemPrice NSNumber Có Giá của một sản phẩm
Số lượng kGAIItemQuantity NSNumber Có Số lượng của một sản phẩm
Mã đơn vị tiền tệ kGAICurrencyCode NSString Không Nội tệ của một giao dịch. Giá trị mặc định là đơn vị tiền tệ của chế độ xem (hồ sơ) mà các giao dịch được báo cáo.

Dữ liệu thương mại điện tử được sử dụng chủ yếu trong các báo cáo chuẩn sau đây:

  • Tổng quan về thương mại điện tử
  • Hiệu suất sản phẩm
  • Hiệu suất bán hàng
  • Giao dịch
  • Thời gian mua hàng

Triển khai

Nếu muốn gửi dữ liệu giao dịch và mặt hàng đến Google Analytics, bạn phải đặt giá trị của trường giao dịch và mặt hàng trên công cụ theo dõi rồi gửi từng giá trị một. Ví dụ:

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

}

Các trường đơn vị tiền tệ thương mại điện tử hỗ trợ giá trị đơn vị tiền tệ âm, có thể là cần thiết trong trường hợp hoàn tiền hoặc trả lại hàng.

Chỉ định đơn vị tiền tệ

Theo mặc định, giá trị giao dịch được giả định bằng đơn vị tiền tệ của chế độ xem (hồ sơ) mà giá trị đó được báo cáo.

Để ghi đè nội tệ của một giao dịch và mọi sản phẩm được liên kết, hãy đặt trường mã đơn vị tiền tệ của các lượt truy cập giao dịch và mặt hàng bằng mã đơn vị tiền tệ mới. Để biết danh sách đầy đủ các đơn vị tiền tệ và mã đơn vị tiền tệ được hỗ trợ, hãy xem Tài liệu tham khảo về đơn vị tiền tệ được hỗ trợ.

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