API Quản lý Google Analytics cho phép truy cập có lập trình vào tính năng Nhập dữ liệu của Google Analytics.
Giới thiệu
API Quản lý cho phép bạn tải lên, liệt kê, xoá và nhận các tệp đã tải lên cũng như liệt kê các tập dữ liệu. Để biết thông tin tổng quan về các lợi ích của tính năng Nhập dữ liệu, hãy xem bài viết Giới thiệu về tính năng Nhập dữ liệu trong Trung tâm trợ giúp.
Hai tài nguyên trong API Quản lý cho phép Nhập dữ liệu là:
- Tài nguyên Nguồn dữ liệu tùy chỉnh, được gọi là Tập dữ liệu trong giao diện web, đóng vai trò là vùng chứa cho các tệp đã tải lên của bạn. Tập hợp Nguồn dữ liệu tùy chỉnh đại diện cho tất cả các tập dữ liệu được liên kết với một tài sản Google Analytics.
- Tài nguyên Upload (Tải lên), biểu thị một tệp đã tải lên. Tập hợp tài nguyên Tải lên đại diện cho tất cả các tệp bạn đã tải lên một tập dữ liệu.
Trường hợp Sử dụng
Tính năng nhập dữ liệu có ba danh mục cấp cao nhất, mỗi danh mục có những trường hợp sử dụng riêng. Tổ chức như sau:
Nhập dữ liệu lượt truy cập
Dữ liệu tiền hoàn lại
Bạn có thể tải các giao dịch thương mại điện tử đã được hoàn tiền toàn bộ hoặc một phần lên Google Analytics. Điều này giúp bạn dễ dàng điều chỉnh tự động dữ liệu trong báo cáo thương mại điện tử Google Analytics với số tiền hoàn lại đã xử lý.
Để tìm hiểu cách nhập dữ liệu tiền hoàn lại vào Google Analytics, hãy xem ví dụ về Nhập Dữ liệu tiền hoàn lại.
Nhập dữ liệu mở rộng
Dữ liệu người dùng
Bạn có thể tải dữ liệu người dùng không nhận dạng cá nhân lên từ các công cụ CRM bên ngoài và tạo đối tượng tái tiếp thị Google Ads cho những phân khúc người dùng có giá trị nhất.
Để tìm hiểu cách nhập dữ liệu người dùng vào Google Analytics nhằm tạo đối tượng tái tiếp thị Google Ads, hãy xem các bài viết sau:
Dữ liệu về chiến dịch
Bạn có thể nhập dữ liệu chiến dịch vào Google Analytics để tuỳ chỉnh bản phân tích hiệu suất chiến dịch cho doanh nghiệp của mình.
Để tìm hiểu cách nhập dữ liệu chiến dịch vào Google Analytics, hãy xem Nhập dữ liệu chiến dịch bằng API quản lý.
Dữ liệu địa lý
Bạn có thể nhập mối liên kết của mã địa lý tới các khu vực, cho phép báo cáo về dữ liệu Google Analytics theo khu vực tuỳ chỉnh. Ví dụ: ở Hoa Kỳ, bạn có thể hoạt động trong các nhóm tiểu bang phía Đông, Trung và Tây; tại Châu Âu, bạn có thể hoạt động trên các nhóm quốc gia Bắc, Trung và Nam. Khi nhập dữ liệu, bạn có thể dùng ga:regionId, ga:cityId, ga:countryIsoCode hoặc ga:subContinentCode làm khoá. Bạn có thể tìm thấy mã thành phố và mã quốc gia trong bảng Nhắm mục tiêu theo địa lý. Bạn có thể xem Mã ISO quốc gia và Mã tiểu lục địa tương ứng trong bảng ISO-3166-1 alpha-2 và UN M.49.
Để biết thêm thông tin về cách nhập dữ liệu địa lý, hãy xem ví dụ về nhập Dữ liệu địa lý.
Dữ liệu nội dung
Bạn có thể tải siêu dữ liệu liên quan đến nội dung lên (chẳng hạn như tác giả và chủ đề) để tận dụng Google Analytics nhằm phân tích chuyên sâu các bài viết được xuất bản trên một trang web.
Để tìm hiểu cách nhập dữ liệu nội dung vào Google Analytics, hãy xem ví dụ về Nhập dữ liệu nội dung.
Dữ liệu sản phẩm
Việc nhập Dữ liệu sản phẩm vào Google Analytics đơ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ư số 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 với dữ liệu sản phẩm mà bạn đã nhập để điền các phương diện và chỉ số sản phẩm vào báo cáo.
Để tìm hiểu cách nhập dữ liệu sản phẩm vào Google Analytics, hãy xem Nhập dữ liệu sản phẩm bằng API quản lý.
Nhập dữ liệu tóm tắt
Dữ liệu chi phí
Bạn có thể tải dữ liệu chi phí lên cho các chiến dịch có tính phí không phải của Google và tận dụng nền tảng Google Analytics để phân tích ROI và so sánh hiệu suất của chiến dịch cho tất cả các khoản đầu tư tiếp thị và quảng cáo trực tuyến.
Để tìm hiểu cách nhập dữ liệu chi phí vào Google Analytics, hãy xem Nhập dữ liệu chi phí bằng API quản lý.
Khái niệm
Trạng thái xử lý
Sau khi bạn tải tệp lên, trạng thái của tệp tải lên sẽ là PENDING cho đến khi tệp tải lên được xác thực và xử lý. Nếu quá trình xử lý thành công, trạng thái sẽ đổi thành COMPLETED.
Nếu xảy ra lỗi trong quá trình xử lý và quá trình tải lên không thành công thì trạng thái của quá trình tải lên sẽ là FAILED. Danh sách lỗi sẽ được cung cấp để giúp bạn xác định(các) vấn đề với tệp đó. Dưới đây là phản hồi mẫu cho một tệp tải lên không xác thực được:
{
id: "YU4DersR_ORzyzXC_AoWw",
kind: "analytics#upload",
accountId: "12345",
customDataSourceId: "poaU7EPcR4WGU-dkNghYKQ",
status: "FAILED",
errors:
[
"Invalid cell data 12.99 at row 1 column 6. expected data type LONG.",
"Invalid cell data 12.99 at row 2 column 6. expected data type LONG.",
"Invalid cell data 23.81 at row 3 column 6. expected data type LONG.",
"Invalid cell data 199.99 at row 4 column 6. expected data type LONG."
]
}
Tóm tắt dữ liệu chi phí so với Ghi đè
Khi tạo Nguồn dữ liệu tùy chỉnh / Tập dữ liệu cho dữ liệu chi phí, bạn có thể chỉ định cách xử lý trường hợp tệp đã tải lên chứa hàng dữ liệu có khóa (tức là ngày, nguồn, phương tiện) khớp với hàng hiện có. Có các lựa chọn sau:
- tóm tắt (mặc định) – Dữ liệu mới sẽ được thêm vào bất kỳ dữ liệu khớp nào trước đó và các chỉ số sẽ được tổng hợp cùng nhau.
- ghi đè – Dữ liệu mới sẽ ghi đè mọi dữ liệu trùng khớp trước đó.
Để tìm hiểu loại nào đã được đặt cho một tập dữ liệu, hãy sử dụng phương pháp danh sách nguồn dữ liệu tuỳ chỉnh để kiểm tra xem thuộc tính importBehavior được đặt thành OVERWRITE hay SUMMATION.
Tổng so với ghi đè ở cấp hàng dữ liệu chi phí
Bạn cũng có thể ghi đè hành vi của tập dữ liệu cho mỗi tệp bạn tải lên bằng cách thêm cột ga:importBehavior vào tiêu đề. Đối với mỗi hàng, bạn có thể đặt giá trị ga:importBehavior thành SUMMATION hoặc OVERWRITE.
Ví dụ: tệp sau sẽ ghi đè mọi dữ liệu chi phí trước đó cho Facebook/cpc và Yahoo/cpc, nhưng hàng cho Bing/cpc sẽ được thêm vào bất kỳ dữ liệu chi phí hiện tại nào cho kết hợp ngày và nguồn/phương tiện cụ thể đó.
ga:date,ga:source, ga:medium,ga:adCost,ga:importBehavior
20140604,facebook,cpc,12.23,OVERWRITE
20140604,bing,cpc,3.23,SUMMATION
20140604,yahoo,cpc,11.23,OVERWRITE
Định dạng và quy tắc ràng buộc
Để tải dữ liệu lên Google Analytics, dữ liệu phải ở trong tệp CSV được định dạng đúng. Phần này mô tả những ràng buộc cần đáp ứng trước khi có thể được coi là hợp lệ để tải lên tất cả các loại Nhập dữ liệu.
Nếu bạn vi phạm bất kỳ quy tắc ràng buộc nào dưới đây hoặc có lỗi phân tích cú pháp, thì yêu cầu tải lên sẽ không thành công kèm theo thông báo lỗi. API này sẽ báo cáo tối đa 10 lỗi trong một phản hồi để giúp người dùng giảm số lượng tệp tải lên không hợp lệ.
Ràng buộc tệp
- Mã hoá: UTF-8
- Giới hạn kích thước tệp: 1 GB
Ràng buộc tiêu đề
- Hàng đầu tiên được coi là tiêu đề cột và là bắt buộc. Cột này phải xác định các phương diện và chỉ số trong cột cụ thể.
Các ràng buộc đối với hàng
- Giới hạn đối với hàng là 1 MB.
Định dạng ô
- Các ô có thể có độ dài tối đa là 2.048 ký tự.
- Khoảng trống ở đầu và ở cuối của một ô sẽ bị xoá.
- Để chỉ định dấu phẩy trong một ô, giá trị của ô phải nằm trong dấu ngoặc kép. Ví dụ:
source1,"medium,ether",group1,100– Giá trị của ô thứ hai là trung bình,ete. - Để chỉ định dấu ngoặc kép trong một ô, ngoài dấu ngoặc kép ở đầu và kết thúc, hãy thoát dấu ngoặc kép bằng một dấu ngoặc kép khác. Ví dụ:
source1,"medium""ether",group1,100– Giá trị của ô thứ hai làmedium"ether.