Theo dõi thương mại điện tử - Android 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 Android 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 Fields.TRANSACTION_ID String 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 Fields.TRANSACTION_AFFILIATION String 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 Fields.TRANSACTION_REVENUE Double Có Tổng doanh thu của một giao dịch, bao gồm cả thuế và phí giao hàng
Thuế Fields.TRANSACTION_TAX Double Có Tổng thuế của một giao dịch
Vận chuyển Fields.TRANSACTION_SHIPPING Double Có Tổng chi phí vận chuyển cho một giao dịch
Mã đơn vị tiền tệ Fields.CURRENCY_CODE String 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 Fields.TRANSACTION_ID String Có Mã giao dịch cần liên kết với mặt hàng
Tên Fields.ITEM_NAME String Có Tên sản phẩm
SKU Fields.ITEM_SKU String Có SKU của sản phẩm
Danh mục Fields.ITEM_CATEGORY String Không Danh mục chứa sản phẩm
Giá Fields.ITEM_PRICE Double Có Giá của một sản phẩm
Số lượng Fields.ITEM_QUANTITY Long Có Số lượng của một sản phẩm
Mã đơn vị tiền tệ Fields.CURRENCY_CODE String 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ụ:

import android.app.Activity;

import com.google.analytics.tracking.android.EasyTracker;
import com.google.analytics.tracking.android.MapBuilder;

public class CheckoutActivity extends Activity {

  /*
   * Called when a purchase is processed and verified.
   */
  public void onPurchaseCompleted() {

    // May return null if EasyTracker has not yet been initialized with a
    // property ID.
    EasyTracker easyTracker = EasyTracker.getInstance(this);

    easyTracker.send(MapBuilder
        .createTransaction("0_123456",       // (String) Transaction ID
                           "In-app Store",   // (String) Affiliation
                           2.16d,            // (Double) Order revenue
                           0.17d,            // (Double) Tax
                           0.0d,             // (Double) Shipping
                           "USD")            // (String) Currency code
        .build()
    );

    easyTracker.send(MapBuilder
        .createItem("0_123456",               // (String) Transaction ID
                    "Level Pack: Space",      // (String) Product name
                    "L_789",                  // (String) Product SKU
                    "Game expansions",        // (String) Product category
                    1.99d,                    // (Double) Product price
                    1L,                       // (Long) Product quantity
                    "USD")                    // (String) Currency code
        .build()
    );
  }

  // ... Rest of the Activity definition
}

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

import android.app.Activity;

import com.google.analytics.tracking.android.EasyTracker;
import com.google.analytics.tracking.android.MapBuilder;

public class CheckoutActivity extends Activity {
  /**
   * 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() {

    // Assumes a tracker has already been initialized with a property ID, otherwise
    // this call returns null.
    EasyTracker easyTracker = EasyTracker.getInstance(this);

    easyTracker.send(MapBuilder
        .createTransaction("0_123456",       // (String) Transaction ID, should be unique among transactions.
                           "In-app Store",   // (String) Affiliation
                           (long) 2.16,      // (long) Order revenue (includes tax and shipping)
                           (long) 0.17,      // (long) Tax
                           0.0,              // (long) Shipping cost
                           "EUR")            // (String) Currency code
        .build();

  }
  // ... Rest of the Activity definition.
}