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 2.

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 thường bao gồm các giao dịch và mục, có liên quan với nhau bằng một mã giao dịch chung. Trong SDK Google Analytics dành cho iOS, mối quan hệ đó được thiết lập bằng cách tạo một đối tượng giao dịch và thêm các mục vào đối tượng đó.

Dữ liệu thương mại điện tử được dùng chính trong các báo cáo sau:

  • 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

Có 3 bước để đo lường giao dịch bằng Google Analytics:

  1. Tạo một đối tượng giao dịch.
  2. Tạo các đối tượng mục rồi thêm các đối tượng đó vào đối tượng giao dịch.
  3. Gửi giao dịch bằng sendTransaction:.

Trong ví dụ sau, chúng tôi giả định rằng onPurchaseCompleted được gọi sau khi người dùng hoàn tất một giao dịch mua hàng trong ứng dụng.

- (void)onPurchaseCompleted {
  GAITransaction *transaction =
      [GAITransaction transactionWithId:@"0_123456"            // (NSString) Transaction ID, should be unique.
                        withAffiliation:@"In-App Store"];      // (NSString) Affiliation
  transaction.taxMicros = (int64_t)(0.17 * 1000000);           // (int64_t) Total tax (in micros)
  transaction.shippingMicros = (int64_t)(0);                   // (int64_t) Total shipping (in micros)
  transaction.revenueMicros = (int64_t)(2.16 * 1000000);       // (int64_t) Total revenue (in micros)

  [transaction addItemWithSKU:@"L_789"                         // (NSString) Product SKU
                         name:@"Level Pack: Space"             // (NSString) Product name
                     category:@"Game expansions"               // (NSString) Product category
                  priceMicros:(int64_t)(1.99 * 1000000)        // (int64_t)  Product price (in micros)
                     quantity:1];                              // (NSInteger)  Product quantity

  [[GAI sharedInstance].defaultTracker sendTransaction:transaction]; // Send the transaction.
}

Loại đơn vị tiền tệ

Trong SDK Google Analytics cho iOS, các trường Đơn vị tiền tệ thương mại điện tử phải có đơn vị một phần triệu (phần triệu đơn vị tiền tệ).

Ví dụ: để gửi giá trị tiền tệ là 4.5991, bạn nên chuyển đổi giá trị đó thành một phần triệu (tức là 4599100) khi gửi giao dịch đến Google Analytics, như trong các ví dụ ở trên. Khi SDK gửi giao dịch đó đến Google Analytics, giá trị đó sẽ tự động được chuyển đổi thành giá trị thập phân điểm cố định và được gửi dưới dạng 4.5991.

Bạn không nên đưa các ký hiệu đơn vị tiền tệ vào mã Thương mại điện tử và cũng không nên sử dụng dấu phẩy.

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