Nhập dữ liệu sản phẩm bằng API quản lý

Andrew Wales, Nhóm Quan hệ với nhà phát triển Google Analytics – Tháng 5 năm 2014

Hướng dẫn này mô tả cách đơn giản hoá việc triển khai tính năng thương mại điện tử nâng cao bằng cách nhập dữ liệu sản phẩm thông qua API Quản lý. Để biết thêm thông tin về cách nhập dữ liệu sản phẩm, hãy xem Ví dụ về cách nhập Dữ liệu sản phẩm.

Giới thiệu

Việc nhập dữ liệu sản phẩm vào Google Analytics giúp đơn giản hoá và giảm lượng dữ liệu thương mại điện tử mà bạn cần gửi cùng với lượt truy cập, như lượt xem trang và sự kiện. Bạn có thể kết hợp một mã sản phẩm hoặc SKU được gửi đến Google Analytics tại thời điểm thu thập với dữ liệu sản phẩm đã nhập để điền phương diện và chỉ số sản phẩm vào báo cáo.

Trước khi bắt đầu

Trước khi hoàn tất hướng dẫn giải pháp này, hãy đọc:

Tổng quan

Cách bật tính năng nhập dữ liệu cho dữ liệu sản phẩm:

  1. Tạo Tập dữ liệu
  2. Chuẩn bị tệp CSV dữ liệu sản phẩm để tải lên
  3. Tải dữ liệu sản phẩm lên bằng API Quản lý
  4. Cập nhật mã thương mại điện tử để gửi SKU sản phẩm

Để tìm hiểu cách tải Tập dữ liệu lên Google Analytics bằng cách sử dụng giao diện web, hãy xem Hướng dẫn sử dụng về Thương mại điện tử nâng cao.

Tạo Tập dữ liệu

Bước đầu tiên để nhập dữ liệu sản phẩm là tạo Tập dữ liệu cho dữ liệu sản phẩm và đặt giản đồ để xác định các thứ nguyên và chỉ số bạn muốn nhập.

Thực hiện theo Hướng dẫn dành cho nhà phát triển nhập dữ liệu để tạo Tập dữ liệu, chọn Dữ liệu sản phẩm làm loại Tập dữ liệu và SKU sản phẩm làm Khóa.

Hình 1: Tạo Tập dữ liệu sản phẩm.

Sau khi tạo Tập dữ liệu, hãy ghi lại Mã nguồn dữ liệu tùy chỉnh mà bạn sẽ sử dụng trong bước tiếp theo để nhập dữ liệu sản phẩm vào Google Analytics bằng API Quản lý.

Chuẩn bị CSV dữ liệu sản phẩm để tải lên

Dữ liệu sản phẩm CSV của bạn phải chứa hàng tiêu đề, cột cho SKU sản phẩm và một cột cho từng thứ nguyên và/hoặc chỉ số cần nhập như được xác định theo giản đồ Tập dữ liệu.

Làm theo Hướng dẫn cho nhà phát triển nhập dữ liệu để chuẩn bị dữ liệu sản phẩm CSV để nhập, sử dụng SKU sản phẩm làm khoá trong cột đầu tiên.

Hình 2: Chuẩn bị dữ liệu sản phẩm để tải lên dưới dạng tệp CSV.

Tệp CSV sẽ có dạng như sau:

ga:productSku,ga:productName,ga:productBrand,ga:productCategoryNew,ga:productVariant,ga:productPrice
12345,Triblend Shortsleeve T-Shirt,Google,Apparel,black,15.25
67890,Donut Friday Scented T-Shirt,Google,Apparel,gray,33.85
10292,Kaiser the Snake T-Shirt,Google,Apparel,green,19.10
67584,Organic Cotton Android T-Shirt,Google,Apparel,black,13.50
90876,Maps Biking T-Shirt,Google,Apparel,blue,15.65

Tải dữ liệu sản phẩm lên bằng API Quản lý

Sau khi tạo Tập dữ liệu, xác định giản đồ và chuẩn bị dữ liệu sản phẩm để tải lên trong tệp CSV, bạn đã sẵn sàng tải dữ liệu sản phẩm của mình lên bằng API Quản lý.

Sau khi dữ liệu sản phẩm được tải lên, xác thực và xử lý, SKU sản phẩm sẽ được kết hợp với dữ liệu sản phẩm đã tải lên khi dữ liệu khớp với lượt truy cập đến được gửi đến Google Analytics từ tài sản của bạn.

Cập nhật mã thương mại điện tử để gửi SKU sản phẩm

Sau khi bạn đã tải lên dữ liệu sản phẩm, hãy cập nhật mã thương mại điện tử để gửi SKU sản phẩm với từng lượt truy cập của bạn, cùng với bất kỳ dữ liệu bổ sung nào bạn muốn trong báo cáo của mình, như thứ nguyên hoặc chỉ số tùy chỉnh.

// Example of sending a transaction when joining with imported product data.
ga('create', 'UA-XXXX-Y');
ga('require', 'ec', 'ec.js'); // Load the Enhanced Ecommerce plug-in. Required.

// The product name, price, and other product data will be added to this hit
// at collection time if the value of the id field matches a Product SKU
// you've uploaded.
ga('ec:addImpression', {
  'id': '12345',              // Product ID/SKU (Key). Required.
  'list': 'Search Results',
  'position': 1,
  'dimension1': 'Member'
});

ga('send', 'pageview');       // Send the impression with a pageview hit.

Giờ đây, ID sản phẩm được gửi từ hoạt động triển khai thương mại điện tử nâng cao của bạn sẽ được so khớp với SKU sản phẩm trong Tập dữ liệu sản phẩm đã nhập và các báo cáo của bạn sẽ được tự động điền bằng dữ liệu sản phẩm bổ sung mà bạn đã tải lên.