Tài liệu này cung cấp thông tin tổng quan về cách đo lường doanh thu và các khoản thanh toán trong ứng dụng bằng SDK Google Analytics dành cho Android 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 Android, 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:
- Tạo một đối tượng giao dịch.
- 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.
- Gửi giao dịch bằng
sendTransaction(Transaction transObject).
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.
/**
* The purchase was processed. We will send the transaction and its associated line items to Google Analytics,
* but only if the purchase has been confirmed.
*/
public void onPurchaseCompleted() {
Transaction myTrans = new Transaction.Builder(
"0_123456", // (String) Transaction Id, should be unique.
(long) (2.16 * 1000000)) // (long) Order total (in micros)
.setAffiliation("In-App Store") // (String) Affiliation
.setTotalTaxInMicros((long) (0.17 * 1000000)) // (long) Total tax (in micros)
.setShippingCostInMicros(0) // (long) Total shipping cost (in micros)
.build();
myTrans.addItem(new Item.Builder(
"L_789", // (String) Product SKU
"Level Pack: Space", // (String) Product name
(long) (1.99 * 1000000), // (long) Product price (in micros)
(long) 1) // (long) Product quantity
.setProductCategory("Game expansions") // (String) Product category
.build());
Tracker myTracker = EasyTracker.getTracker(); // Get reference to tracker.
myTracker.sendTransaction(myTrans); // Send the transaction.
}
Loại đơn vị tiền tệ
Trong SDK Google Analytics dành cho Android, các trường Đơn vị tiền tệ thương mại điện tử phải có đơn vị 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.
Chỉ định đơn vị tiền tệ
Theo mặc định, các giá trị giao dịch được giả định bằng đơn vị tiền tệ của chế độ xem (hồ sơ) mà các giá trị đó được báo cáo.
Để ghi đè nội tệ của một giao dịch, hãy gọi setCurrencyCode khi tạo
Transaction như trong ví dụ sau:
/**
* 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).
*/
public void onPurchaseCompleted() {
Transaction myTrans = new Transaction.Builder(
"0_123456",
(long) (1.59 * 1000000))
.setAffiliation("In-App Store")
.setTotalTaxInMicros((long) (0.13 * 1000000))
.setShippingCostInMicros(0)
.setCurrencyCode("EUR") // (String) Set currency code to Euros.
.build();
Tracker myTracker = EasyTracker.getTracker();
myTracker.sendTransaction(myTrans);
}
Để 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ợ.