Mã theo dõi: Thương mại điện tử

Lưu ý: Tài liệu tham khảo này mô tả các phương thức mà bạn sử dụng cho thương mại điện tử trong báo cáo của Google Analytics. Để biết thêm thông tin về cách thiết lập tính năng theo dõi thương mại điện tử, hãy xem bài viết Theo dõi thương mại điện tử.

Phương pháp thương mại điện tử GATC

  • _addItem(transactionId, sku, name, category, price, quantity)
  • _addTrans(transactionId, affiliation, total, tax, shipping, city, state, country)
  • _trackTrans()

Thông tin chi tiết về phương pháp

_addItem()

    _addItem(transactionId, sku, name, category, price, quantity)

    Sử dụng phương thức này để theo dõi các mặt hàng do khách truy cập mua trên trang web thương mại điện tử của bạn. Phương thức này theo dõi từng mặt hàng theo SKU. Điều này có nghĩa là bạn bắt buộc phải sử dụng tham số sku. Sau đó, phương thức này sẽ liên kết mục với đối tượng giao dịch mẹ thông qua đối số transactionId.

    Các đối số cho phương thức này được so khớp theo vị trí, vì vậy, hãy đảm bảo cung cấp tất cả các tham số, ngay cả khi một vài tham số trong số đó có giá trị trống.

    Phương thức này thực hiện không có phép tính bổ sung nào, chẳng hạn như tính toán số lượng. Do đó, bạn nên lưu ý các phương pháp hay nhất sau đây:

    • Tính toán số lượng bằng phần mềm riêng.
      • Trong cùng một phiên, các mặt hàng trùng lặp được thêm (theo SKU) không ảnh hưởng đến việc tính số lượng.
      • Trong cùng một phiên, nếu hai mặt hàng được thêm mà mỗi mặt hàng có cùng một SKU, thì thông tin về mặt hàng đầu tiên sẽ được thay thế bằng thông tin về mặt hàng thứ hai.
    • Đảm bảo mỗi mặt hàng trong kho hàng của bạn đều có một SKU duy nhất.
      • Nếu kho hàng của bạn có nhiều mặt hàng có cùng SKU và một khách truy cập mua cả hai mặt hàng đó, thì bạn sẽ chỉ nhận được dữ liệu cho mặt hàng được thêm gần đây nhất.
    • Đảm bảo rằng bạn đã thiết lập đối tượng giao dịch mẹ cho các mục đã thêm.
      • Nếu một mục đã thêm không tồn tại đối tượng giao dịch mẹ nào, thì mục đó sẽ được đính kèm vào một đối tượng giao dịch trống.
      • Nếu một mặt hàng được thêm mà không có đối tượng giao dịch mẹ, báo cáo sẽ hiển thị các sản phẩm theo SKU không liên kết với bất kỳ giao dịch nào.
    • Luôn cung cấp giá trị cho tham số name.
      • Mặc dù tham số name là không bắt buộc, nhưng các mặt hàng được thêm vào giao dịch mà không có tham số name sẽ không xuất hiện trong bảng chi tiết sản phẩm của một giao dịch. Mặc dù bạn vẫn sẽ thấy tổng doanh thu của giao dịch, nhưng bạn sẽ không thể xem mức doanh thu mà một mặt hàng cụ thể đã đóng góp vào tổng doanh thu của giao dịch.
       _gaq.push(['_addItem',
      '1234',         // transaction ID - necessary to associate item with transaction
      'DD44',         // SKU/code - required
      'T-Shirt',      // product name - necessary to associate revenue with product
      'Olive Medium', // category or variation
      '11.99',        // unit price - required
      '1'             // quantity - required
   ]);

    tham số

      String   transactionId Không bắt buộc Mã đơn hàng của giao dịch cần liên kết với mặt hàng.
      String   sku Bắt buộc. Mã SKU của mặt hàng.
      String   name Bắt buộc. Tên sản phẩm. Bắt buộc để xem dữ liệu trong báo cáo chi tiết sản phẩm.
      String   category Không bắt buộc. Danh mục sản phẩm.
      String   price Bắt buộc. Giá sản phẩm.
      String   quantity Bắt buộc. Số lượng hàng mua.

_addTrans()

    _addTrans(transactionId, affiliation, total, tax, shipping, city, state, country)
    Tạo một đối tượng giao dịch có các giá trị đã cho. Giống như _addItem(), phương thức này chỉ xử lý hoạt động theo dõi giao dịch và không cung cấp thêm chức năng thương mại điện tử. Do đó, nếu giao dịch trùng lặp với một giao dịch hiện có trong phiên đó, thì các giá trị giao dịch cũ sẽ được ghi đè bằng các giá trị giao dịch mới. Các đối số cho phương thức này được so khớp theo vị trí, vì vậy, hãy đảm bảo cung cấp tất cả các tham số, ngay cả khi một vài tham số trong số đó có giá trị trống. 
       _gaq.push(['_addTrans',
      '1234',           // transaction ID - required
      'Womens Apparel', // affiliation or store name
      '28.28',          // total - required; Shown as "Revenue" in the
                        // Transactions report. Does not include Tax and Shipping.
      '1.29',           // tax
      '15.00',          // shipping
      'San Jose',       // city
      'California',     // state or province
      'USA'             // country
   ]);

    tham số

      String   transactionId Bắt buộc. Mã nhận dạng giao dịch nội bộ duy nhất của giao dịch này.
      String   affiliation Không bắt buộc. Đơn vị liên kết của đối tác hoặc cửa hàng (không xác định nếu không có).
      String   total Bắt buộc. Tổng số tiền bằng đô la Mỹ của giao dịch. Không bao gồm thuế và phí vận chuyển, và chỉ nên được coi là "tổng" nếu bạn nêu rõ ràng thông tin về phí vận chuyển và thuế.
      String   tax Không bắt buộc. Số tiền thuế của giao dịch.
      String   shipping Không bắt buộc. Phí vận chuyển cho giao dịch.
      String   city Không bắt buộc. Thành phố liên kết với giao dịch.
      String   state Không bắt buộc. Trạng thái để liên kết với giao dịch.
      String   country Không bắt buộc. Quốc gia liên kết với giao dịch.

    giá trị trả về

      _gat.GA_EComm_.Transactions_ Đối tượng giao dịch đã được tạo hoặc sửa đổi.

_trackTrans()

    _trackTrans()
    Gửi cả dữ liệu giao dịch và dữ liệu mặt hàng đến máy chủ Google Analytics. Phương thức này sẽ được gọi sau _trackPageview() và được dùng cùng với các phương thức _addItem() và addTrans(). Thuộc tính này sẽ được gọi sau khi các mục và phần tử giao dịch đã được thiết lập. 
    _gaq.push(['_setAccount', 'UA-XXXXX-X']);
_gaq.push(['_trackPageview']);
_gaq.push(['_addTrans',
   '1234',           // transaction ID - required
   'Womens Apparel', // affiliation or store name
   '28.28',          // total - required
   '1.29',           // tax
   '15.00',          // shipping
   'San Jose',       // city
   'California',     // state or province
   'USA'             // country
]);
_gaq.push(['_addItem',
   '1234',           // transaction ID - necessary to associate item with transaction
   'DD44',           // SKU/code - required
   'T-Shirt',        // product name
   'Olive Medium',   // category or variation
   '11.99',          // unit price - required
   '1'               // quantity - required
]);
_gaq.push(['_trackTrans']);